The Guardian News API: A Comprehensive Overview
The Guardian News API provides developers with programmatic access to the world‑class journalism of The Guardian. By exposing articles, multimedia, tags, and metadata through a RESTful interface, the API enables the creation of custom news experiences, data visualisations, and real‑time dashboards.
Getting Started with the API Key
Before you can query any endpoint, you must obtain an API key. The Storage Guardian Instructions: API Key guide outlines the registration process, key rotation, and security best practices. Once you have the key, include it as a query parameter (api-key=YOUR_KEY) in every request.
Core Features of The Guardian News API
Content Coverage
- Full‑text articles from the UK, US, and international sections.
- Rich multimedia assets, including images, videos, and podcasts.
- Taxonomy data such as tags, sections, and contributors.
Filtering and Search
The API supports powerful filtering options:
- Keyword search across headlines, bodies, and tags.
- Date ranges to retrieve historical or breaking news.
- Section filters for focused feeds (e.g., section:technology).
Realtime Updates
Developers can build making realtime applications by polling the /search endpoint with a short interval or by using webhooks (available to premium partners). This capability powers live dashboards, such as the one hosted at the Power BI dashboard, where editors monitor story performance as it happens.
Practical Use Cases
Information Mashups with Wandora
A recent video demonstrates how the Wandora application consumes the Guardian News API to create an information mashup. By combining news headlines with social media sentiment, the mashup delivers a contextual view of current events. The video shows the step‑by‑step process of uploading data, mapping fields, and publishing the final visualisation.
Personalised News Portals
Publishers can use the API to build custom portals that surface articles based on user preferences. For example, a portal might display only stories tagged with environment
