API Reference
Use Crawlora's Guardian API endpoints to extract supported public Guardian data as structured JSON. This documentation covers 4 active endpoints including Get Guardian article content, Get Guardian section headlines, Get Guardian live blog snapshot, Get Guardian topic archive. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as url, topic, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/guardian/article" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/guardian/articleapiKey2 credits/requestReturns a Guardian article's public metadata and body paragraphs from a canonical article URL. Live-blog timelines are not supported.
Required params: url:query
/guardian/headlinesapiKey1 credit/requestReturns fresh headlines from a public Guardian RSS section. section defaults to world.
Required params: None
/guardian/liveapiKey2 credits/requestReturns 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 params: url:query
/guardian/topicapiKey2 credits/requestReturns a paginated public Guardian topic or category archive. topic is a Guardian tag or section slug and page defaults to 1.
Required params: topic:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get Guardian article content | /guardian/article | GET | 2 credits/request | url:query | View docs | Try endpoint |
| Get Guardian section headlines | /guardian/headlines | GET | 1 credit/request | None | View docs | Try endpoint |
| Get Guardian live blog snapshot | /guardian/live | GET | 2 credits/request | url:query | View docs | Try endpoint |
| Get Guardian topic archive | /guardian/topic | GET | 2 credits/request | topic:query | View docs | Try endpoint |