The Guardian API

Beginner's Pick News / API Key Intermediate HTTPS

77 B

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

Overview

The Guardian Content API gives you open access to all articles, multimedia, and structured data published by The Guardian newspaper, organized by tags and sections. It is widely used for building news readers, content analysis tools, and media monitoring applications. The free developer tier provides a generous daily quota and is easy to set up with just an API key.

Beginner Tip

Register for a free developer key at open-platform.theguardian.com and use the /search endpoint with your api-key parameter to start pulling articles. Filter by section (e.g., section=technology) or use the q parameter to search by keyword.

Available Data

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

The Guardian data via REST API

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative

{
  "status": "success",
  "data": {
    "result": "Data from The Guardian",
    "description": "Access all the content the Guardian creates, categorised by tags and section",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

response.status "ok" when the request succeeded, "error" otherwise

response.total Total number of articles matching the query

response.results[].webTitle Headline of the article as displayed on the Guardian website

response.results[].webUrl URL to the full article on theguardian.com

response.results[].webPublicationDate ISO 8601 publication date and time of the article

response.results[].sectionName Guardian section the article belongs to, such as Technology or Sport

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request

const url = "https://content.guardianapis.com/search?q=climate&api-key=YOUR_API_KEY";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

403 Forbidden Your API key is missing, expired, or invalid

✓ Double-check your api-key query parameter matches the key shown in your Guardian developer account

400 Bad Request An unrecognised query parameter was included in the request

✓ Consult the Guardian API reference to confirm supported parameters and remove any unsupported ones

Empty results The search term or date range returned no matching content

✓ Broaden your query, remove date filters, or check spelling of the search keyword

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

How is this scored? →