Fact Search

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

Query Parameters

string

required

Search query for news articles. Use focused keywords for best results.

number

default:"10"

Maximum number of results to return. Range: 1–50.

string

Filter by source language. Examples: english, korean

string

Filter by source country code. Examples: US, KR

string

default:"relevance"

Sort order. Options: relevance, date

string

Relative time range filter. Examples: 7d, 30d, 3months. Ignored when from or to is provided.

string

Start of date range (ISO 8601). Takes precedence over timespan when set. Example: 2025-01-01T00:00:00Z

string

End of date range (ISO 8601). Takes precedence over timespan when set. Example: 2025-05-01T23:59:59Z

string

Comma-separated list of source domains to include. Only articles from these domains are returned. Example: bbc.com,reuters.com

string

default:"default"

Data source to search. Options:

default: public news sources only (default)
ingest: personal ingested knowledge base only (requires personal access token)
all: news + personal ingested knowledge base combined (requires personal access token)

Response

string

The search query that was used.

array

List of news articles.

Show Article fields

string

Article title

string

Article URL

string

Source domain

string

Publication datetime (ISO 8601)

string

Article language

string

Source country code

string

Article excerpt (optional)

string

Article image URL (optional)

string

gnews or naver

object

Show Meta fields

number

Total number of results

number

Response time in milliseconds

string

Data source used (gnews, naver, mixed)

boolean

Whether the response was served from cache

cURL

curl -G "https://api.factagora.com/api/v1/fact-search" \
  -H "Authorization: Bearer fa_your_api_key" \
  --data-urlencode "q=ECB interest rate decision" \
  --data-urlencode "limit=5" \
  --data-urlencode "timespan=7d"

Python

import requests

resp = requests.get(
    "https://api.factagora.com/api/v1/fact-search",
    headers={"Authorization": "Bearer fa_your_api_key"},
    params={"q": "ECB interest rate decision", "limit": 5, "timespan": "7d"},
)
data = resp.json()

TypeScript

const params = new URLSearchParams({
  q: "ECB interest rate decision",
  limit: "5",
  timespan: "7d",
});
const resp = await fetch(
  `https://api.factagora.com/api/v1/fact-search?${params}`,
  { headers: { Authorization: "Bearer fa_your_api_key" } },
);
const data = await resp.json();

{
  "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
  }
}

Overview

Endpoints

Best Practices

Query Parameters

Response

​Query Parameters

​Response

Query Parameters

Response