GET/guardian/articleapiKey2 credits/request
Returns a Guardian article by `url`, a canonical `www.theguardian.com` article link. The response has the title, description, section, authors, lead image, publication and update times, and the body as `paragraphs`. Live-blog timelines are not supported.
Required: url.
Sampled 14 Oct 2026: 7 fields returned with a value. In the sample: published_at: 2026-08-26; url: theguardian.com; title: 76 characters; authors: 1 entry; updated_at: 2026-08-26; image_url: i.guim.co.uk; paragraphs: 11 entries.
Open in Playground
GET/guardian/authorapiKey2 credits/request
Returns one Guardian contributor's public profile: name, bio, Twitter handle, byline image, and one page of their recent articles. Provide either the contributor's profile slug or the full profile page URL.
Optional: slug, url, page.
Sampled 14 Oct 2026: 20 items. Filled in every item: title, url, section, published_at, image_url. In the sample: published_at: 2026-05-13 to 2026-08-26; url: theguardian.com; image_url: i.guim.co.uk.
Open in Playground
GET/guardian/headlinesapiKey1 credit/request
Returns recent Guardian headlines for one section. `section` is optional and defaults to `world`; the other values are `uk-news`, `us-news`, `politics`, `business`, `technology`, `environment`, `science`, `sport`, `culture`, `lifeandstyle` and `commentisfree`. Each item has a title, URL, summary, publication time and author, plus its section when available.
Optional: section (12 allowed values: world, uk-news, us-news, politics, business, technology, environment, science, sport, culture, lifeandstyle, commentisfree).
Sampled 14 Oct 2026: 45 items. Filled in every item: title, url, summary, published_at, author, section. In the sample: published_at: 2026-10-08 to 2026-10-13; url: theguardian.com; title: median 79 characters; summary: median 593 characters.
Open in Playground
GET/guardian/liveapiKey2 credits/request
Returns a bounded text snapshot of one public Guardian live blog: the headline, the key-events timeline, and the update blocks with timestamps, headings, bylines, and body paragraphs. This is a single page fetch of the public page at a canonical live-blog URL — not a live stream or polling feed. URLs must use the dated www.theguardian.com section /live/ path, e.g. https://www.theguardian.com/sport/live/2026/aug/08/<slug>/.
Required: url.
Sampled 14 Oct 2026: 54 items. Filled in every item: id, published_at, paragraphs. Not in every item: title (14), author (2). In the sample: published_at: 2026-08-08; title: “Match report” and 13 other values; paragraphs: median 1 entry.
Open in Playground
GET/guardian/topicapiKey2 credits/request
Returns the stories on a public Guardian tag archive (20 per page, newest first, with total pages and results) or section front (a single curated page, is_front true). topic is a Guardian tag or section slug and page defaults to 1. resolved_topic reports the path actually served, which differs for edition-scoped fronts.
Required: topic. Optional: page.
Sampled 14 Oct 2026: 45 items. Filled in every item: title, url, summary, published_at, section. Not in every item: kicker (7). In the sample: published_at: 2026-10-08 to 2026-10-13; title: “Controversial vaccine trial touted by RFK Jr gets go-ahead…” and 44 other values; url: theguardian.com; summary: median 117 characters; section: “society” and 9 other values; kicker: “Weather tracker” and 6 other values.
Open in Playground