FT API endpoint
Returns one page of Financial Times search results: each story's title, canonical URL, summary, section tag, publication time, and lead image. Results can be ordered by relevance or date and filtered by publication window.
/ft/searchQuery parameters:
q, the search keywords.page, a 1-based results page. It defaults to 1 and must be between 1 and 100.sort, the result ordering. Allowed values: relevance, date. It defaults to relevance.date_range, a publication-window filter. Allowed values: now-24h, now-7d, now-30d, now-1y. Omit it for all dates.Returns one page of search results: each story's title, canonical url, summary, section section, published_at, and lead image_url. has_more reports whether a further page is available. A recognized FT no-results page returns an empty items array; missing result cards without an explicit no-results marker is reported as an upstream error. Invalid sort, date_range, or out-of-range page values return typed invalid-parameter errors rather than being sent upstream.
| Field | Filled in, of 25 checked | Values in the sample |
|---|---|---|
| title | 25 | “Climate tech explained” and 24 other values |
| url | 25 | ft.com |
| summary | 25 | “Your guide to the technologies and solutions that will help…” and 24 other values |
| section | 25 | Climate change (22), UK politics (1), Intergovernmental Panel on Clim… (1) and 1 more |
| published_at | 20 | 2026-05-20 to 2026-10-09 |
| image_url | 25 | images.ft.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| q | string | Yes | Search keywords | climate | |
| page | integer | No | Results page Minimum: 1. Maximum: 100. | ||
| sort | string | No | Result ordering Allowed values: relevance, date. | ||
| date_range | string | No | Publication-window filter Allowed values: now-24h, now-7d, now-30d, now-1y. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/ft/search?q=climate&page=1&sort=relevance&date_range=now-24h" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"q": "climate",
"sort": "relevance",
"page": 1,
"has_more": true,
"items": [
{
"title": "Climate tech explained",
"url": "https://www.ft.com/content/e64a57c9-e19e-4910-a3ce-7db04435ab07",
"summary": "Your guide to the technologies and solutions",
"section": "Climate change",
"image_url": "https://images.ft.com/example.jpg"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/ft.searchResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | ft.SearchResponse | No | ||||
| data.date_range | string | No | ||||
| data.has_more | boolean | No | ||||
| data.items | array | No | HeadlineItem record, 6 fields: image_url, published_at, section, summary, title, url. Described under FT author profile API. | |||
| data.page | integer | No | ||||
| data.q | string | No | ||||
| data.sort | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/ft/search?q=climate&page=1&sort=relevance&date_range=now-24h" \
-H "x-api-key: $CRAWLORA_API_KEY"