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

GET

api

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

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

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

source

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

query

string

The search query that was used.

articles

array

List of news articles.

Show Article fields

title

string

Article title

url

string

Article URL

domain

string

Source domain

publishedAt

string

Publication datetime (ISO 8601)

language

string

Article language

sourceCountry

string

Source country code

snippet

string

Article excerpt (optional)

imageUrl

string

Article image URL (optional)

source

string

gnews or naver

meta

object

Show Meta fields

total

number

Total number of results

executionTimeMs

number

Response time in milliseconds

source

string

Data source used (gnews, naver, mixed)

cached

boolean

Whether the response was served from cache

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

Authentication

Fact Checker

Overview

Intelligence APIs

Best Practices

Query Parameters

Response

​Query Parameters

​Response

Query Parameters

Response