Skip to main content
GET
/
api
/
v1
/
fact-search
curl -X GET "https://api.factagora.com/api/v1/fact-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
  }
}
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
Relative time range filter. Examples: 7d, 30d, 3months. Ignored when from or to is provided.
​
from
string
Start of date range (ISO 8601). Takes precedence over timespan when set. Example: 2025-01-01T00:00:00Z
​
to
string
End of date range (ISO 8601). Takes precedence over timespan when set. Example: 2025-05-01T23:59:59Z
​
domains
string
Comma-separated list of source domains to include. Only articles from these domains are returned. Example: bbc.com,reuters.com

​
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/fact-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
  }
}