Reuters APIreuters.com ↗
Access Reuters articles via 3 endpoints: full-text search, section browsing, and full article content with authors, body HTML, and access level.
What is the Reuters API?
The Reuters API provides 3 endpoints for retrieving news content from reuters.com, covering full-text article search, section-based browsing, and individual article details. The get_article endpoint returns structured fields including body_html, authors, word_count, content_code, and read_minutes, making it practical for news aggregation, media monitoring, and research pipelines that need article-level metadata alongside readable content.
curl -X GET 'https://api.parse.bot/scraper/1287d5c2-70fd-46a2-95c2-3dbd3c436011/search_news?size=10&offset=0&keyword=technology' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace reuters-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Reuters SDK — bounded, re-runnable; every call capped."""
from parse_apis.reuters_com_api import Reuters, ArticleNotFound
client = Reuters()
# Search for recent news articles about a topic
for article in client.article_summaries.search(keyword="technology", limit=3):
print(article.title, article.published_time)
# Drill down into the first search result for full details
summary = client.article_summaries.search(keyword="climate", limit=1).first()
if summary:
try:
full = summary.details()
print(full.title, full.word_count, full.read_minutes)
except ArticleNotFound as e:
print("article gone:", e.article_url)
# Browse a specific section
for article in client.section("/business/").news(limit=3):
print(article.title, article.section, article.authors)
print("exercised: article_summaries.search, summary.details, section.news")
Full-text search across Reuters articles ordered by publication date (newest first). Returns article summaries with metadata. Results are paginated via offset.
| Param | Type | Description |
|---|---|---|
| size | integer | Number of articles to return per request (max 100). |
| offset | integer | Number of articles to skip for pagination. |
| keywordrequired | string | Search query text to match against article titles and content. |
{
"type": "object",
"fields": {
"size": "number of articles returned",
"offset": "current pagination offset",
"articles": "array of article summary objects",
"total_results": "total number of matching articles"
},
"sample": {
"data": {
"size": 5,
"offset": 0,
"articles": [
{
"id": "RK45YEKDBVMVJL6HNUN4H6EK4E",
"title": "DOGE alumni launch military cyber startup with $1.4 billion valuation",
"authors": [
"David Jeans"
],
"section": "Technology",
"description": "A team of former DOGE employees have raised a major funding round for a startup.",
"content_code": "metered",
"section_path": "/technology/",
"updated_time": "2026-07-22T18:04:10.302Z",
"canonical_url": "/technology/doge-alumni-launch-military-cyber-startup-with-14-billion-valuation-2026-07-22/",
"thumbnail_url": "https://www.reuters.com/resizer/v2/B2APLTSTTJKGTHLIBI6AGQCEZA.jpg?auth=abc123",
"published_time": "2026-07-22T17:46:22.022Z"
}
],
"total_results": 46710
},
"status": "success"
}
}About the Reuters API
Search and Browse Reuters Content
The search_news endpoint accepts a required keyword parameter and returns a paginated list of matching article summaries, ordered by publication date (newest first). The response includes a total_results count alongside the articles array, so you can implement multi-page retrieval using the offset parameter. Each request supports up to 100 results via the size parameter.
The get_section_news endpoint lets you pull the latest articles from named Reuters sections by passing a section_id path such as /world/, /business/, /technology/, or /markets/. Like search, results are paginated and returned newest first. This is useful for building section-specific feeds without a keyword query.
Article-Level Detail
The get_article endpoint takes a canonical URL path (e.g. /technology/some-article-slug-2025/) and returns the full article record. Key response fields include title, authors (array), body_html (array of paragraph HTML strings), description, word_count, read_minutes, section, updated_time (ISO 8601), and content_code. The content_code field indicates whether the article is free, metered, or premium; metered and premium articles may return partial body_html.
Pagination and Coverage
All three endpoints share the same size and offset pagination model. The total_results field in each response lets you calculate how many additional pages exist. Section and search results are capped at 100 articles per call. Article availability reflects what is publicly accessible on reuters.com at the time of the request.
The Reuters API is a managed, monitored endpoint for reuters.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when reuters.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official reuters.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor breaking news in a specific domain by polling
get_section_newsfor/world/or/markets/on a schedule - Build a news aggregator that indexes Reuters headlines, descriptions, and publication timestamps from
search_news - Classify articles by access level using the
content_codefield to filter for only free full-text content - Extract author attribution data from the
authorsarray inget_articlefor byline analysis or journalist tracking - Calculate average
read_minutesorword_countacross a topic to understand Reuters coverage depth by keyword - Power a media monitoring dashboard by searching a brand or topic keyword and paginating through all matching results
- Retrieve
updated_timeanddescriptionfields to detect article corrections or re-publications over time
| 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 | 100 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.
Does Reuters have an official developer API?+
What does `content_code` tell me, and will I always get full article text?+
content_code field returns one of three values: free, metered, or premium. Articles marked free return complete body_html arrays. Metered and premium articles may return partial body content, reflecting the access level on reuters.com.What section IDs can I pass to `get_section_news`?+
/world/, /business/, /technology/, /markets/, and /sustainability/. The parameter expects a string with both a leading and trailing slash. Sections correspond to top-level navigation paths on reuters.com.Does the API return Reuters video content, live blogs, or graphics packages?+
How far back does the article search go, and how current is the data?+
search_news endpoint returns results ordered by publication date newest first, but does not expose a date-range filter parameter. The depth of historical coverage and the lag between publication and availability are not guaranteed to a fixed window.