News

The Guardian API

theguardian.com

The Guardian — get latest articles, browse 80 sections, search 2.65M+ articles with date filtering, read full articles with tags and word count, browse by tag or author, and list all sections.

Actions
10
Category
News
Login
Not required
Output
JSON

Call the The Guardian API

Submit a task, then poll the job until it settles. This example runs gu_author.

curl -X POST https://api.anakin.io/v1/wire/task \
  -H "X-API-Key: $ANAKIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action_id": "gu_author",
    "params": {
      "author": "<author>"
    }
  }'

10 actions on theguardian.com

Read

  • Author Articles

    gu_authorread1 credit / call

    Returns Guardian articles by a specific contributor using their profile tag ID.

    author
    string · required
    page
    integer
    limit
    integer
  • Editor's Picks

    gu_editors_picksread1 credit / call

    Returns editorially curated top articles for a given Guardian section — the stories editors chose to highlight.

    section
    string · required
  • Full Article

    gu_articleread1 credit / call

    Returns full article body text, author, tags, section, thumbnail, and word count from a Guardian article URL.

    url
    string · required
  • Latest Articles

    gu_latestread1 credit / call

    Returns the latest Guardian articles, optionally filtered by section. Includes author, excerpt, thumbnail, and word count.

    section
    string
    page
    integer
    limit
    integer
  • List Sections

    gu_sections_listread1 credit / call

    Returns all 80 Guardian editorial sections with IDs and URLs. Use to discover valid section slugs for other actions.

  • Most Viewed

    gu_most_viewedread1 credit / call

    Returns the most viewed articles in a given Guardian section — what readers are reading right now.

    section
    string · required
  • Search Articles

    gu_searchread1 credit / call

    Returns Guardian articles matching a full-text search across 2.65M+ articles with date range and section filtering.

    query
    string · required
    section
    string
    from_date
    string
    to_date
    string
    order_by
    string
    page
    integer
    limit
    integer
  • Section News

    gu_sectionread1 credit / call

    Returns Guardian articles by editorial section — world, business, technology, environment, politics, sport, science, us-news, uk-news, culture, and more.

    section
    string · required
    page
    integer
    limit
    integer
  • Tag Browser

    gu_tagread1 credit / call

    Returns Guardian articles by tag — topics, countries, organisations, people. Use tag IDs like technology/artificialintelligenceai, world/iran, business/tesla.

    tag
    string · required
    page
    integer
    limit
    integer
  • Topic Browser

    gu_topicread1 credit / call

    Returns Guardian articles by topic keyword — just type a topic like AI, climate change, NHS and it resolves the tag automatically.

    topic
    string · required
    page
    integer
    limit
    integer

The Guardian API questions

Is there an API for The Guardian?
The Guardian does not offer a public data API for this, but Anakin Wire provides 10 maintained endpoints for theguardian.com. You call Anakin's REST API with an action ID and parameters and get structured JSON back; Anakin handles the browser, proxies, anti-bot, and parsing.
How do I scrape The Guardian data?
POST to https://api.anakin.io/v1/wire/task with your API key, the action ID, and its parameters, then poll GET /v1/wire/jobs/{id} until the job settles. There is nothing to install and no scraper to maintain — when theguardian.com changes its markup, Anakin updates the action.
Do I need a The Guardian account?
No. Every The Guardian action listed here runs anonymously — no account and no credentials required.
What does the The Guardian API cost?
Usage-based credits, charged per call and refunded automatically when a job fails. New accounts start with 300 free credits and no card. See anakin.io/pricing for the current rates.

More News APIs

All News sites