v5

OpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Global News and Media

Search news

Keyword search over the current 42-feed world-news corpus. All query terms must be present as whole words in the headline or description; wrap the query in double quotes for a literal phrase. This is a rolling window of what the feeds currently publish, not an archive, so a story that has aged out of every feed is gone. For company or ticker news use /api/v2/quotes/{symbol}/news, and for free-text search over the wider global press use /api/v1/gdelt/articles.

get/api/v1/news/search

Query parameters

qstring required

Free-text search query. All terms must be present as whole words; double-quote the query for a literal phrase.

Free-text search query. All terms must be present as whole words; double-quote the query for a literal phrase.

limitinteger

Maximum number of records to return.

Maximum number of records to return.

offsetinteger

Number of matches to skip, for paging past the limit.

Number of matches to skip, for paging past the limit.

Response

Matching news articles with source and region.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}