{
  "x402Version": 2,
  "id": 29303,
  "slug": "29303",
  "resource": "https://api.agentstools.dev/gdelt/news",
  "description": "Recent global news articles from the GDELT Project by topic, country, entity or theme, normalized to title, link-back url, domain, source-country, language and ISO timestamp — plus coverage breakdowns (top source-countries, top domains, languages, count) derived from the same result. One call instead of querying and parsing GDELT yourself.",
  "type": "http",
  "serviceName": "gdelt-news",
  "resourceType": "Immigration",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "8000",
      "amountUsd": 0.008,
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "properties": {
      "example": {
        "type": "object"
      },
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "type": "object"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "method": "GET",
          "queryParams": {
            "country": "France",
            "limit": 20,
            "theme": "protests",
            "timespan": "24h"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "articles": [
              {
                "domain": "example.fr",
                "language": "French",
                "seendate": "2026-07-07T23:45:00Z",
                "socialimage": null,
                "source_country": "France",
                "title": "Thousands march in Paris",
                "url": "https://example.fr/a"
              }
            ],
            "attribution": "Data via the GDELT Project ...",
            "breakdowns": {
              "count": 1,
              "languages": [
                {
                  "count": 1,
                  "value": "French"
                }
              ],
              "top_domains": [
                {
                  "count": 1,
                  "value": "example.fr"
                }
              ],
              "top_source_countries": [
                {
                  "count": 1,
                  "value": "France"
                }
              ]
            },
            "count": 1,
            "query": "theme:PROTEST sourcecountry:FR"
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET",
                  "HEAD",
                  "DELETE"
                ],
                "type": "string"
              },
              "queryParams": {
                "properties": {
                  "country": {
                    "description": "Source-country filter by friendly name (United States, Russia, China, ...); mapped to the GDELT FIPS 10-4 code server-side.",
                    "type": "string"
                  },
                  "lang": {
                    "description": "Source-language filter by name (english, russian, arabic, ...).",
                    "type": "string"
                  },
                  "limit": {
                    "description": "Max articles (default 30, GDELT cap 250).",
                    "maximum": 250,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "query": {
                    "description": "Free-text topic (multi-word phrases are auto-quoted). Optional if a theme/country is given.",
                    "type": "string"
                  },
                  "sort": {
                    "description": "Result ordering (default datedesc).",
                    "enum": [
                      "datedesc",
                      "dateasc",
                      "relevance",
                      "tonedesc",
                      "toneasc"
                    ],
                    "type": "string"
                  },
                  "theme": {
                    "description": "Curated GDELT GKG theme filter (friendly name mapped to a GKG code).",
                    "enum": [
                      "protests",
                      "terrorism",
                      "conflict",
                      "war",
                      "inflation",
                      "sanctions",
                      "trade",
                      "elections",
                      "corruption",
                      "cyber",
                      "immigration",
                      "refugees",
                      "climate",
                      "disaster",
                      "epidemic",
                      "energy",
                      "economy",
                      "diplomacy",
                      "coup",
                      "unrest"
                    ],
                    "type": "string"
                  },
                  "timespan": {
                    "description": "Lookback window: 15min, 24h, 3d, 1w, 1m (default 24h).",
                    "type": "string"
                  }
                },
                "required": [],
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "news",
    "geopolitics",
    "world",
    "events",
    "gdelt",
    "bazaar"
  ],
  "sourceHost": "api.agentstools.dev",
  "lastUpdated": "2026-10-13T14:42:49.907Z",
  "quality": {
    "calls30d": 2,
    "uniquePayers30d": 2,
    "lastCalledAt": "2026-10-13T14:42:49.368Z"
  },
  "metadata": {
    "serviceName": "gdelt-news",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "method": "GET",
            "queryParams": {
              "country": "France",
              "limit": 20,
              "theme": "protests",
              "timespan": "24h"
            },
            "type": "http"
          },
          "output": {
            "example": {
              "articles": [
                {
                  "domain": "example.fr",
                  "language": "French",
                  "seendate": "2026-07-07T23:45:00Z",
                  "socialimage": null,
                  "source_country": "France",
                  "title": "Thousands march in Paris",
                  "url": "https://example.fr/a"
                }
              ],
              "attribution": "Data via the GDELT Project ...",
              "breakdowns": {
                "count": 1,
                "languages": [
                  {
                    "count": 1,
                    "value": "French"
                  }
                ],
                "top_domains": [
                  {
                    "count": 1,
                    "value": "example.fr"
                  }
                ],
                "top_source_countries": [
                  {
                    "count": 1,
                    "value": "France"
                  }
                ]
              },
              "count": 1,
              "query": "theme:PROTEST sourcecountry:FR"
            },
            "type": "json"
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "input": {
              "additionalProperties": false,
              "properties": {
                "method": {
                  "enum": [
                    "GET",
                    "HEAD",
                    "DELETE"
                  ],
                  "type": "string"
                },
                "queryParams": {
                  "properties": {
                    "country": {
                      "description": "Source-country filter by friendly name (United States, Russia, China, ...); mapped to the GDELT FIPS 10-4 code server-side.",
                      "type": "string"
                    },
                    "lang": {
                      "description": "Source-language filter by name (english, russian, arabic, ...).",
                      "type": "string"
                    },
                    "limit": {
                      "description": "Max articles (default 30, GDELT cap 250).",
                      "maximum": 250,
                      "minimum": 1,
                      "type": "integer"
                    },
                    "query": {
                      "description": "Free-text topic (multi-word phrases are auto-quoted). Optional if a theme/country is given.",
                      "type": "string"
                    },
                    "sort": {
                      "description": "Result ordering (default datedesc).",
                      "enum": [
                        "datedesc",
                        "dateasc",
                        "relevance",
                        "tonedesc",
                        "toneasc"
                      ],
                      "type": "string"
                    },
                    "theme": {
                      "description": "Curated GDELT GKG theme filter (friendly name mapped to a GKG code).",
                      "enum": [
                        "protests",
                        "terrorism",
                        "conflict",
                        "war",
                        "inflation",
                        "sanctions",
                        "trade",
                        "elections",
                        "corruption",
                        "cyber",
                        "immigration",
                        "refugees",
                        "climate",
                        "disaster",
                        "epidemic",
                        "energy",
                        "economy",
                        "diplomacy",
                        "coup",
                        "unrest"
                      ],
                      "type": "string"
                    },
                    "timespan": {
                      "description": "Lookback window: 15min, 24h, 3d, 1w, 1m (default 24h).",
                      "type": "string"
                    }
                  },
                  "required": [],
                  "type": "object"
                },
                "type": {
                  "const": "http",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method"
              ],
              "type": "object"
            },
            "output": {
              "properties": {
                "example": {
                  "type": "object"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            }
          },
          "required": [
            "input"
          ],
          "type": "object"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "api.agentstools.dev",
    "manifest_name": "api.agentstools.dev",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "example": {},
    "type": "string"
  }
}