The Guardian

The Guardian newspaper REST API providing access to 2M+ articles, news content, sections, tags, editions, and real-time breaking news from Guardian journalists worldwide. The API covers all articles published since 1999 and supports advanced search, filtering by section, tag, date range, and edition (UK, US, Australia).

The Guardian publishes 4 APIs on the APIs.io network, including Content API, Editions API, Sections API, and 1 more. Tagged areas include News, Media, Content, Articles, and Journalism.

The The Guardian catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

The Guardian’s developer surface includes authentication, documentation, support, engineering blog, and 6 more developer resources.

🌐 Visit website 📡 Source on GitHub

49.1/100 developing ▬ flat Agent 38/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6

AccessFreemiumSelf serve⚡ Free to try

5 APIs

NewsMediaContentArticlesJournalism

Kin Score

Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6

Composite quality — 49.1/100 · developing

Contract Quality 16.7 / 25

Developer Ergonomics 5.2 / 20

Commercial Clarity 7.9 / 20

Operational Transparency 4.1 / 13

Governance 7.0 / 12

Discoverability 8.2 / 10

Agent readiness — 38/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/guardian: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 5

Individual APIs this provider publishes, each with its own machine-readable definition.

Rate Limits 1

Documented rate limits and quota policies.

Guardian Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

JSON Schema 10

Standalone JSON Schema definitions for this provider's data models.

Scroll for all 10

Examples 4

Example request and response payloads for these APIs.

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Documentation

Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Access & Security 3

Authentication, authorization, and security posture

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

DomainSecurity

Authentication

Authentication

Operate 1

Status, limits, changes, and where to get help

Support

Support

Commercial 1

Pricing, plans, and the legal terms of use

TermsOfService

TermsOfService

Company 2

The organization behind the API

Website

Website

Blog

Blog

Other 1

Properties that don't map to a standard resource type

RegistrationForm

RegistrationForm

Source (apis.yml)

aid: guardian
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/guardian.png
name: The Guardian
description: The Guardian newspaper REST API providing access to 2M+ articles, news content, sections, tags, editions, and
  real-time breaking news from Guardian journalists worldwide. The API covers all articles published since 1999 and supports
  advanced search, filtering by section, tag, date range, and edition (UK, US, Australia).
url: https://open-platform.theguardian.com/
specificationVersion: '0.19'
created: '2026-06-13'
modified: '2026-06-13'
x-category: News
x-tier: 2
tags:
- News
- Media
- Content
- Articles
- Journalism
apis:
- name: The Guardian Content API
  description: Search and retrieve articles, news content, and multimedia from The Guardian's archive of 2 million+ pieces
    of content published since 1999. Supports keyword search, section filtering, tag filtering, date range queries, and retrieval
    of full article body text with metadata.
  humanURL: https://open-platform.theguardian.com/documentation/
  baseURL: https://content.guardianapis.com/
  tags:
  - News
  - Articles
  - Content
  - Search
  properties:
  - type: Documentation
    url: https://open-platform.theguardian.com/documentation/
  - type: Authentication
    url: https://open-platform.theguardian.com/access/
  - type: Plans
    url: plans/guardian-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/guardian-rate-limits.yml
  - type: FinOps
    url: finops/guardian-finops.yml
- aid: guardian:guardian-content-api
  name: The Guardian Content API
  description: Search and retrieve Guardian content items
  humanURL: https://open-platform.theguardian.com/documentation/
  baseURL: https://content.guardianapis.com/
  tags:
  - Content
  properties:
  - type: OpenAPI
    url: openapi/guardian-content-api-openapi.yml
- aid: guardian:guardian-editions-api
  name: The Guardian Editions API
  description: Browse Guardian editions (UK, US, AU, International, Europe)
  humanURL: https://open-platform.theguardian.com/documentation/
  baseURL: https://content.guardianapis.com/
  tags:
  - Editions
  properties:
  - type: OpenAPI
    url: openapi/guardian-editions-api-openapi.yml
- aid: guardian:guardian-sections-api
  name: The Guardian Sections API
  description: Browse Guardian sections
  humanURL: https://open-platform.theguardian.com/documentation/
  baseURL: https://content.guardianapis.com/
  tags:
  - Sections
  properties:
  - type: OpenAPI
    url: openapi/guardian-sections-api-openapi.yml
- aid: guardian:guardian-tags-api
  name: The Guardian Tags API
  description: Browse and search Guardian tags (keywords, series, contributors, etc.)
  humanURL: https://open-platform.theguardian.com/documentation/
  baseURL: https://content.guardianapis.com/
  tags:
  - Tags
  properties:
  - type: OpenAPI
    url: openapi/guardian-tags-api-openapi.yml
common:
- type: AgenticAccess
  url: agentic-access/guardian-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/guardian-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/guardian-domain-security.yml
- type: Authentication
  url: authentication/guardian-authentication.yml
- type: Website
  url: https://open-platform.theguardian.com/
- type: Documentation
  url: https://open-platform.theguardian.com/documentation/
- type: RegistrationForm
  url: https://open-platform.theguardian.com/access/
- type: Support
  url: https://groups.google.com/g/guardian-api-talk
- type: TermsOfService
  url: https://open-platform.theguardian.com/legal/terms/
- type: Blog
  url: https://www.theguardian.com/info/series/digital-blog/rss
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com