> ## 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.

# Fact Search

> Search recent news articles from global sources

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`

**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.

**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`

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

```bash cURL theme={null}
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 Python theme={null}
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 TypeScript theme={null}
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();
```

```json 200 theme={null}
{
  "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
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.