API Reference
Get The Telegraph's public section list, site-wide and per-section headlines, and full public article content as structured JSON. 5 endpoints documented below.
curl -X GET "https://api.crawlora.net/api/v1/telegraph/article?url=https%3A%2F%2Fwww.telegraph.co.uk%2Fworld-news%2Fexample%2F" \
-H "x-api-key: $CRAWLORA_API_KEY"The Telegraph's world-news section returned exactly 50 headlines on 2026-09-22, from Trump pressing Zelensky over refinery strikes ahead of their UN meeting to a newly discovered cat species in Bolivia, and a report on that same Trump-Zelensky story was revised roughly 12 hours after it first published — from 16:39 UTC on 21 September to 04:41 UTC the next morning. Crawlora's four endpoints return The Telegraph's 13 sections, its RSS feed, per-section headlines, and articles as normalized JSON.
/telegraph/sections returns the full 13-slug list /telegraph/headlines accepts — uk-news, world-news, politics, business, finance, technology, sport, culture, travel, lifestyle, health, science, and opinion.
/telegraph/news reads The Telegraph's documented public RSS feed at telegraph.co.uk/rss.xml. Its 120 most recent items on 2026-09-22 spanned Premier League match reports and a long-running Global Health investigative strand alongside breaking politics.
Pass a slug from /telegraph/sections to /telegraph/headlines for that section's headlines, parsed from its public category page. world-news returned a full page of 50 stories on 2026-09-22, from the Trump-Zelensky refinery standoff to Merz's coalition setbacks in Germany.
Pass a canonical telegraph.co.uk URL to /telegraph/article for title, author, section, and body paragraphs. The Trump-Zelensky piece above, bylined Benedict Smith and tagged section: US News, published at 16:39 UTC on 21 September and was updated at 04:41 UTC the next day as the diesel-price angle developed.
/telegraph/articleapiKey2 credits/requestReturns one The Telegraph article by `url`, a canonical HTTPS article link. The response has the title, description, section, authors, publication and update times, image URL, body `paragraphs` and a `paywalled` flag. Access is intermittent, and subscriber-only or blocked pages return an error.
Required: url.
/telegraph/authorapiKey2 credits/requestReturns a Telegraph author's profile by `url`, a canonical `telegraph.co.uk/authors/<letter>/<range>/<name>/` link: name, job title, bio and recent articles with title, URL, excerpt and ISO-8601 `published_at`. `job_title` can be empty for contributors without a masthead credit.
Required: url.
Sampled 14 Oct 2026: 22 items. Filled in every item: title, url, excerpt, published_at. In the sample: published_at: 2026-06-08 to 2026-10-11; url: telegraph.co.uk; title: median 61 characters; excerpt: median 122 characters.
/telegraph/headlinesapiKey1 credit/requestReturns the current headlines for one The Telegraph section. `section` is required and takes one of `uk-news`, `world-news`, `politics`, `business`, `finance`, `technology`, `sport`, `culture`, `travel`, `lifestyle`, `health`, `science` or `opinion`. Each item has its title and URL.
Required: section (13 allowed values: uk-news, world-news, politics, business, finance, technology, sport, culture, travel, lifestyle, health, science, opinion).
Sampled 14 Oct 2026: 20 items. Filled in every item: title, url. In the sample: url: telegraph.co.uk; title: median 61 characters.
/telegraph/newsapiKey1 credit/requestReturns the current top stories from The Telegraph. It takes no parameters. Each item has its title, URL and, where available, a summary, author, publication time, image URL and `type`. It can return an error when The Telegraph declines the request.
Takes no parameters.
Sampled 14 Oct 2026: 120 items. Filled in every item: title, url, summary, published_at. Not in every item: author (119), image_url (118). In the sample: published_at: 2026-09-12 to 2026-10-13; url: telegraph.co.uk; title: median 61 characters; summary: median 76 characters; image_url: telegraph.co.uk.
/telegraph/sectionsapiKey1 credit/requestLists the The Telegraph sections that the headlines endpoint accepts, such as `uk-news`, `world-news`, `politics`, `finance`, `culture` and `opinion`. Each entry has a `slug`, a display `name` and a section `url`.
Takes no parameters.
Sampled 14 Oct 2026: 13 items. Filled in every item: slug, name, url. In the sample: name: “UK News” and 12 other values; url: telegraph.co.uk.