Endpoint Playground

Try the Guardian topic archive API

Test Crawlora's Guardian topic archive API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /guardian/topic
Platform: Guardian
Auth: apiKey
Credits: 2 credits/request
Required params: topic
Common optional params: page

Guardian topic archive API documentation The Guardian platform page Crawlora API pricing Try Guardian article content API Try Guardian contributor profile API Try Guardian section headlines API Try Guardian live blog snapshot API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/guardian/topic?topic=world" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
topic	string	Yes	world	Guardian tag or section slug
page	integer	No		1-based archive page, 1 to 100, defaults to 1

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "topic": "world/ukraine",
    "resolved_topic": "world/ukraine",
    "is_front": false,
    "items": [
      {
        "title": "Ukraine war briefing: Poland’s Tusk heads to Kyiv after warning of Russian strikes on Ukrainian allies",
        "url": "https://www.theguardian.com/world/2026/sep/18/ukraine-war-briefing-poland-warns-russian-strikes-kyiv-allies",
        "summary": "Donald Tusk says Moscow will not enter peace talks without Ukraine’s ‘total capitulation’.",
        "published_at": "2026-09-18T01:47:56Z",
        "section": "world",
        "kicker": "Russia-Ukraine war at a glance"
      }
    ],
    "pagination": {
      "page": 1,
      "has_next": true,
      "next_page": 2,
      "total_pages": 931,
      "total_results": 18604
    }
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestguardian.topicResponseDocGuardian

GET /guardian/topic

Get Guardian topic archive

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.

Response behavior

- Tag archives (`is_front: false`) return 20 stories per page, newest first. `pagination.total_pages` and `pagination.total_results` report the archive size; `has_next`/`next_page` are set while another page exists within the `page` limit of `100`. - Section fronts (`is_front: true`, for example `world`) are a single curated page: `total_pages` is `1`, `has_next` is `false`, and `page` values above `1` return an empty `items` list. - `resolved_topic` is the path the Guardian actually served. It differs from `topic` for edition-scoped fronts (for example `technology` resolves to `uk/technology`). - A `page` beyond the end of a tag archive returns an empty `items` list with `has_next: false`. - `published_at` is an RFC 3339 UTC timestamp. `section` is the story's own Guardian section (the first URL segment), which can differ from the requested topic. - Items are always individual stories (articles, live blogs, video, audio); date-archive links are never returned.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

topic

requiredstring

Guardian tag or section slug

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "topic": "world/ukraine",
    "resolved_topic": "world/ukraine",
    "is_front": false,
    "items": [
      {
        "title": "Ukraine war briefing: Poland’s Tusk heads to Kyiv after warning of Russian strikes on Ukrainian allies",
        "url": "https://www.theguardian.com/world/2026/sep/18/ukraine-war-briefing-poland-warns-russian-strikes-kyiv-allies",
        "summary": "Donald Tusk says Moscow will not enter peace talks without Ukraine’s ‘total capitulation’.",
        "published_at": "2026-09-18T01:47:56Z",
        "section": "world",
        "kicker": "Russia-Ukraine war at a glance"
      }
    ],
    "pagination": {
      "page": 1,
      "has_next": true,
      "next_page": 2,
      "total_pages": 931,
      "total_results": 18604
    }
  }
}

Endpoint details

Method: GET
Path: /guardian/topic
Authentication: apiKey
Credit cost: 2 credits/request
Platform: Guardian
Parameters: 3 documented fields

Request parameters

topic:querypage:queryx-api-key:header

Response schema fields

codedatadata.is_frontdata.itemsdata.items[].kickerdata.items[].published_atdata.items[].sectiondata.items[].summarydata.items[].titledata.items[].urldata.paginationdata.pagination.has_next

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "topic": "world/ukraine",
    "resolved_topic": "world/ukraine",
    "is_front": false,
    "items": [
      {
        "title": "Ukraine war briefing: Poland’s Tusk heads to Kyiv after warning of Russian strikes on Ukrainian allies",
        "url": "https://www.theguardian.com/world/2026/sep/18/ukraine-war-briefing-poland-warns-russian-strikes-kyiv-allies",
        "summary": "Donald Tusk says Moscow will not enter peace talks without Ukraine’s ‘total capitulation’.",
        "published_at": "2026-09-18T01:47:56Z",
        "section": "world",
        "kicker": "Russia-Ukraine war at a glance"
      }
    ],
    "pagination": {
      "page": 1,
      "has_next": true,
      "next_page": 2,
      "total_pages": 931,
      "total_results": 18604
    }
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/guardian/topic?topic=<topic>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing Get Guardian article content Get Guardian contributor profile Get Guardian section headlines Get Guardian live blog snapshot

Endpoint Playground

Try the Guardian topic archive API

Endpoint facts

Method: GET
API path: /guardian/topic
Platform: Guardian
Auth: apiKey
Credits: 2 credits/request
Required params: topic
Common optional params: page

Prefilled cURL

curl "https://api.crawlora.net/api/v1/guardian/topic?topic=world" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
topic	string	Yes	world	Guardian tag or section slug
page	integer	No		1-based archive page, 1 to 100, defaults to 1

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "topic": "world/ukraine",
    "resolved_topic": "world/ukraine",
    "is_front": false,
    "items": [
      {
        "title": "Ukraine war briefing: Poland’s Tusk heads to Kyiv after warning of Russian strikes on Ukrainian allies",
        "url": "https://www.theguardian.com/world/2026/sep/18/ukraine-war-briefing-poland-warns-russian-strikes-kyiv-allies",
        "summary": "Donald Tusk says Moscow will not enter peace talks without Ukraine’s ‘total capitulation’.",
        "published_at": "2026-09-18T01:47:56Z",
        "section": "world",
        "kicker": "Russia-Ukraine war at a glance"
      }
    ],
    "pagination": {
      "page": 1,
      "has_next": true,
      "next_page": 2,
      "total_pages": 931,
      "total_results": 18604
    }
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestguardian.topicResponseDocGuardian

GET /guardian/topic

Get Guardian topic archive

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

topic

requiredstring

Guardian tag or section slug

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "topic": "world/ukraine",
    "resolved_topic": "world/ukraine",
    "is_front": false,
    "items": [
      {
        "title": "Ukraine war briefing: Poland’s Tusk heads to Kyiv after warning of Russian strikes on Ukrainian allies",
        "url": "https://www.theguardian.com/world/2026/sep/18/ukraine-war-briefing-poland-warns-russian-strikes-kyiv-allies",
        "summary": "Donald Tusk says Moscow will not enter peace talks without Ukraine’s ‘total capitulation’.",
        "published_at": "2026-09-18T01:47:56Z",
        "section": "world",
        "kicker": "Russia-Ukraine war at a glance"
      }
    ],
    "pagination": {
      "page": 1,
      "has_next": true,
      "next_page": 2,
      "total_pages": 931,
      "total_results": 18604
    }
  }
}

Endpoint details

Method: GET
Path: /guardian/topic
Authentication: apiKey
Credit cost: 2 credits/request
Platform: Guardian
Parameters: 3 documented fields

Request parameters

topic:querypage:queryx-api-key:header

Response schema fields

codedatadata.is_frontdata.itemsdata.items[].kickerdata.items[].published_atdata.items[].sectiondata.items[].summarydata.items[].titledata.items[].urldata.paginationdata.pagination.has_next

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "topic": "world/ukraine",
    "resolved_topic": "world/ukraine",
    "is_front": false,
    "items": [
      {
        "title": "Ukraine war briefing: Poland’s Tusk heads to Kyiv after warning of Russian strikes on Ukrainian allies",
        "url": "https://www.theguardian.com/world/2026/sep/18/ukraine-war-briefing-poland-warns-russian-strikes-kyiv-allies",
        "summary": "Donald Tusk says Moscow will not enter peace talks without Ukraine’s ‘total capitulation’.",
        "published_at": "2026-09-18T01:47:56Z",
        "section": "world",
        "kicker": "Russia-Ukraine war at a glance"
      }
    ],
    "pagination": {
      "page": 1,
      "has_next": true,
      "next_page": 2,
      "total_pages": 931,
      "total_results": 18604
    }
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/guardian/topic?topic=<topic>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing Get Guardian article content Get Guardian contributor profile Get Guardian section headlines Get Guardian live blog snapshot