Skip to main content
GET
/
api
/
v1
/
news
/
search
curl -X GET "https://api.factagora.com/api/v1/news/search?q=bitcoin&limit=5&language=english" \
  -H "Authorization: Bearer fag_your_api_key"
{
  "query": "bitcoin",
  "articles": [
    {
      "title": "Bitcoin surges past $100,000 amid institutional demand",
      "url": "https://reuters.com/...",
      "domain": "reuters.com",
      "publishedAt": "2026-03-29T10:00:00Z",
      "language": "english",
      "sourceCountry": "US",
      "snippet": "Bitcoin hit a new all-time high as institutional investors...",
      "source": "gnews"
    }
  ],
  "meta": {
    "total": 1,
    "executionTimeMs": 312,
    "source": "gnews",
    "cached": false
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.factagora.com/llms.txt

Use this file to discover all available pages before exploring further.

Search recent news articles from global news sources including GNews and Naver News. Returns article titles, URLs, publication dates, and source domains.

Query Parameters

q
string
required
Search query for news articles. Use focused keywords for best results.
limit
number
default:"10"
Maximum number of results to return. Range: 1–50.
language
string
Filter by source language. Examples: english, korean
country
string
Filter by source country code. Examples: US, KR
sortBy
string
default:"relevance"
Sort order. Options: relevance, date
timespan
string
Time range filter. Examples: 7d, 30d, 3months

Response

query
string
The search query that was used.
articles
array
List of news articles.
meta
object
curl -X GET "https://api.factagora.com/api/v1/news/search?q=bitcoin&limit=5&language=english" \
  -H "Authorization: Bearer fag_your_api_key"
{
  "query": "bitcoin",
  "articles": [
    {
      "title": "Bitcoin surges past $100,000 amid institutional demand",
      "url": "https://reuters.com/...",
      "domain": "reuters.com",
      "publishedAt": "2026-03-29T10:00:00Z",
      "language": "english",
      "sourceCountry": "US",
      "snippet": "Bitcoin hit a new all-time high as institutional investors...",
      "source": "gnews"
    }
  ],
  "meta": {
    "total": 1,
    "executionTimeMs": 312,
    "source": "gnews",
    "cached": false
  }
}