Docs menu

FT API endpoint

Financial Times section headlines API

Returns one page of a Financial Times section front: each story's title, canonical URL, summary, section tag, publication time, and lead image. Section must be a slug returned by /ft/categories.

GETapiKey2 credits/requestFTft.headlinesResponseDoc/ft/headlines

Endpoint facts

Method: GET
API path: /ft/headlines
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: FT
Response schema: #/definitions/ft.headlinesResponseDoc

Financial Times API Try Financial Times section headlines API in Playground FT API documentation

How this endpoint behaves

Query parameters:

required section, an FT section slug. Discover the full accepted set from /ft/categories; examples include world, us, companies, technology, markets, opinion, life-arts, us-economy, and us-companies. Values that are not a current FT section return a typed invalid-parameter error rather than being sent upstream.
optional page, a 1-based results page. It defaults to 1 and must be between 1 and 20.

Returns one page of a section front: each story's title, canonical url, summary, section section, published_at, and lead image_url. has_more reports whether the section advertises a further page.

Sampled response

Request, 14 Oct 2026: GET /ft/headlines?section=world
Items in items: 41
Fields filled in every checked item: 2
Fields empty in some or all items: 4

Field	Filled in, of 41 checked	Values in the sample
title	41	median 65 characters
url	41	ft.com
summary	34	median 101 characters
section	37	“War in Ukraine” and 30 other values
published_at	7	2026-10-13
image_url	6	images.ft.com

Request parameters

Parameter	Type	Required	Description	Example
section	string	Yes	Section slug from /ft/categories	world
page	integer	No	Results page Minimum: 1. Maximum: 20.
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/ft/headlines?section=world&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "section": "world",
    "page": 1,
    "has_more": true,
    "items": [
      {
        "title": "Russia’s new air campaign seeks to destroy Ukrainian economy",
        "url": "https://www.ft.com/content/0ecc81ad-2119-4763-90fb-ba5d399d913d",
        "summary": "Drone and missile strikes hit warehouses, steel plants, ports and railways",
        "section": "War in Ukraine",
        "published_at": "2026-09-20T09:00:00.000Z",
        "image_url": "https://images.ft.com/example.jpg"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/ft.headlinesResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	ft.HeadlinesResponse	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.section	string	No
msg	string	No	OK

Failure responses

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

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/ft/headlines?section=world&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More FT endpoint docs Financial Times API Financial Times article content API documentation FT author profile API documentation Financial Times sections API documentation Latest Financial Times stories API documentation Financial Times search API documentation

Open in Playground Back to group

Docs menu

FT API endpoint

Financial Times section headlines API

Returns one page of a Financial Times section front: each story's title, canonical URL, summary, section tag, publication time, and lead image. Section must be a slug returned by /ft/categories.

GETapiKey2 credits/requestFTft.headlinesResponseDoc/ft/headlines

Endpoint facts

Method: GET
API path: /ft/headlines
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: FT
Response schema: #/definitions/ft.headlinesResponseDoc

Financial Times API Try Financial Times section headlines API in Playground FT API documentation

How this endpoint behaves

Query parameters:

required section, an FT section slug. Discover the full accepted set from /ft/categories; examples include world, us, companies, technology, markets, opinion, life-arts, us-economy, and us-companies. Values that are not a current FT section return a typed invalid-parameter error rather than being sent upstream.
optional page, a 1-based results page. It defaults to 1 and must be between 1 and 20.

Sampled response

Request, 14 Oct 2026: GET /ft/headlines?section=world
Items in items: 41
Fields filled in every checked item: 2
Fields empty in some or all items: 4

Field	Filled in, of 41 checked	Values in the sample
title	41	median 65 characters
url	41	ft.com
summary	34	median 101 characters
section	37	“War in Ukraine” and 30 other values
published_at	7	2026-10-13
image_url	6	images.ft.com

Request parameters

Parameter	Type	Required	Description	Example
section	string	Yes	Section slug from /ft/categories	world
page	integer	No	Results page Minimum: 1. Maximum: 20.
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/ft/headlines?section=world&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "section": "world",
    "page": 1,
    "has_more": true,
    "items": [
      {
        "title": "Russia’s new air campaign seeks to destroy Ukrainian economy",
        "url": "https://www.ft.com/content/0ecc81ad-2119-4763-90fb-ba5d399d913d",
        "summary": "Drone and missile strikes hit warehouses, steel plants, ports and railways",
        "section": "War in Ukraine",
        "published_at": "2026-09-20T09:00:00.000Z",
        "image_url": "https://images.ft.com/example.jpg"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/ft.headlinesResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	ft.HeadlinesResponse	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.section	string	No
msg	string	No	OK

Failure responses

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

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/ft/headlines?section=world&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Financial Times section headlines API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Financial Times section headlines API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related