GDELT API忽略sourcecountry与sourcelang参数问题排查请求

核心问题分析 #

你的请求里sourcecountry和sourcelang参数未生效，大概率是参数位置或语法不符合GDELT v2 API规范，而非参数本身失效。

具体修正步骤 #

1. 将过滤参数嵌入query参数内 #

GDELT v2 API的sourcelang、sourcecountry这类过滤条件，需要作为查询逻辑的一部分写入query参数中，不能单独作为URL参数传递。独立URL参数仅适用于mode、timespan这类全局配置项。

修正后的请求示例：

https://api.gdeltproject.org/api/v2/doc/doc?query=("americas cup" OR "emirates team new zealand") sourcelang:english sourcecountry:nzl&mode=ArtList&timespan=1day&maxrecords=10&format=JSON

关键变化：把sourcelang=english改为sourcelang:english，sourcecountry=nzl改为sourcecountry:nzl，并合并到query的字符串里。

2. 验证参数值准确性 #

• sourcecountry必须用两位ISO 3166-1 Alpha-2国家代码，你用的nzl、usa是正确的。
• sourcelang要使用GDELT定义的代码，english是正确值，注意别拼写错误（比如误写成eng）。

3. 修正URL编码问题 #

你之前的请求里有"这类HTML实体编码，会导致GDELT无法正确解析关键词。确保请求里的引号直接用"，或者正确编码为%22，空格编码为%20。

编码后的正确请求示例：

https://api.gdeltproject.org/api/v2/doc/doc?query=(%22americas%20cup%22%20OR%20%22emirates%20team%20new%20zealand%22)%20sourcelang:english%20sourcecountry:nzl&mode=ArtList&timespan=1day&maxrecords=10&format=JSON

额外验证建议 #

• 先简化查询条件（比如只保留sourcelang:english）测试，确认单条件生效后再叠加其他条件。
• 检查.NET MAUI代码中是否存在URL二次编码的情况，避免参数被错误转义。

内容的提问来源于stack exchange，提问作者nzmike