ft.com APIwww.ft.com ↗
Search and retrieve FT commodities news articles. Filter by date range, keyword, and sort order. Access curated topic pages for oil, gold, copper, and more.
curl -X GET 'https://api.parse.bot/scraper/0e37e2f1-5dc3-4915-956f-b8f461f1ae07/search_news' \ -H 'X-API-Key: $PARSE_API_KEY'
Search Financial Times articles by keyword with optional date range filtering and sort order. Returns paginated results with 25 articles per page. Results include article title, URL, topic tag, summary, and publication date.
| Param | Type | Description |
|---|---|---|
| page | string | Page number for pagination, starting from 1. |
| sort | string | Sort order for results. Accepts exactly one of: date, relevance. |
| query | string | Search query string (e.g. 'commodities', 'oil prices', 'gold market'). |
| date_to | string | End date filter in YYYY-MM-DD format. When omitted, no end date constraint is applied. |
| date_from | string | Start date filter in YYYY-MM-DD format. When omitted, no start date constraint is applied. |
{
"type": "object",
"fields": {
"page": "integer",
"sort": "string",
"query": "string",
"articles": "array of article objects with title, url, topic, summary, published_date",
"total_results": "integer"
},
"sample": {
"page": 1,
"sort": "date",
"query": "commodities",
"articles": [
{
"url": "https://www.ft.com/content/c49e0eff-0776-4103-8eaf-1b049fbf9d3f",
"title": "Apollo and Blackstone raise $35bn in chip financing deal for Anthropic",
"topic": "Artificial intelligence",
"summary": "Transaction is one of the largest private credit fundraisings, fuelling Claude maker's AI growth plans",
"published_date": "2026-06-10T16:18:18+0000"
}
],
"total_results": 205
}
}About the ft.com API
The Financial Times Commodities API exposes 2 endpoints for retrieving market news from ft.com, covering topics from oil and gold to agricultural commodities and industrial metals. The search_news endpoint accepts keyword queries with date range filters and returns up to 25 articles per page, each with title, URL, topic tag, summary, and publication date. The get_topic_articles endpoint retrieves editorially curated articles from named FT topic pages.
What the API Returns
Both endpoints return article arrays containing title, url, topic, summary, and published_date fields. The search_news endpoint also surfaces total_results and the active page and sort values so you can paginate through large result sets. Each page of search results contains up to 25 articles.
search_news Endpoint
The search_news endpoint accepts a query string (e.g. 'oil prices', 'gold market', 'copper supply') alongside optional date_from and date_to parameters in YYYY-MM-DD format to narrow results to a specific window. The sort parameter accepts either date or relevance, letting you choose between chronological ordering and query match strength. Pagination is controlled via the page parameter starting from 1.
get_topic_articles Endpoint
The get_topic_articles endpoint takes a topic slug — such as 'commodities', 'oil', 'gold', 'copper', or 'agricultural-commodities' — and returns the curated article list for that FT topic page. The response includes an article_count field alongside the articles array. Note that articles from topic pages are editorially curated and may not always include a published_date value.
Coverage and Scope
The API is focused on the FT commodities vertical. It does not expose FT content outside commodities topics, nor does it provide full article body text — only the summary, title, URL, and metadata fields listed above. If you need to track a specific commodity over time, combining date_from/date_to filtering in search_news with a targeted query value gives you a reliable time-bounded dataset.
- Monitor FT coverage of oil price movements by querying 'oil prices' with a rolling date window using date_from and date_to.
- Build a commodities news feed grouped by topic using get_topic_articles with slugs like 'gold', 'copper', and 'agricultural-commodities'.
- Track how FT editorial attention to a commodity shifts over time by comparing total_results across different date ranges.
- Aggregate article summaries and URLs for a commodities briefing digest using search_news sorted by date.
- Alert on new FT articles mentioning a specific commodity or event by polling search_news with a tight date_from filter.
- Compare coverage frequency of industrial metals vs. agricultural commodities using separate topic page requests.
- Archive FT commodities headlines with publication dates for historical market sentiment research.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.