+
The Guardian API
Guardian articles, live blogs and section headlines as JSON, by link, section, tag or contributor.
The API.SH Guardian API returns theguardian.com content as structured JSON. List the latest stories of any section, topic tag, series or contributor page, or page back through the archive. Then pull one article by its link for the headline, standfirst, byline and authors, times, section, tags, main image and full text as ordered blocks. Live blogs also return their latest updates and key events.
- 2 endpoints
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/guardian/v1/ article
{ "success": true }What you can build with the The Guardian API
News monitoring by topic
Follow any Guardian section or topic tag, filter by keyword and time, and alert on new stories.
Live event tracking
Read a live blog's latest updates with key-event and pinned flags during elections, matches and breaking news.
Text and media research
Collect full articles as ordered blocks with authors, tags and dates for NLP and media studies.
Author and series archives
Page through a contributor's or series' listing to build a complete archive of their work.
AI agents and RAG
Give an agent the newest Guardian stories on a topic and the full text it needs to answer.
The Guardian data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
The Guardian API endpoints and prices
Every The Guardian endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| Guardian article /guardian/ | $1 · $2 PAYG 1 credit |
| Guardian headlines by section or tag /guardian/ | $1 · $2 PAYG 1 credit |
Call the The Guardian API
Guardian article: GET https://api.api.sh/guardian/
curl "https://api.api.sh/guardian/v1/article?url=https%3A%2F%2Fwww.theguardian.com%2Fworld%2F2013%2Fjun%2F06%2Fnsa-phone-records-verizon-court-order" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/guardian/v1/article",
params={"url": "https://www.theguardian.com/world/2013/jun/06/nsa-phone-records-verizon-court-order"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/guardian/v1/article");
url.searchParams.set("url", "https://www.theguardian.com/world/2013/jun/06/nsa-phone-records-verizon-court-order");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/guardian/v1/article", "url", "https://www.theguardian.com/world/2013/jun/06/nsa-phone-records-verizon-court-order")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "The Guardian" and "Guardian article".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp- Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 482 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for The Guardian data
- Public data only: no The Guardian login, cookies or account needed
- One key and one response shape for The Guardian and 481 other platforms
- Built and maintained by API.SH, not third-party publishers
- Pay per call; errors on our side cost nothing
- Live status for every endpoint
API.SH vs the official The Guardian API
The Guardian has an official Open Platform content API with a free developer key and content back to 1999; free use is for non-commercial projects, and commercial use needs an agreement with The Guardian. API.SH needs no Guardian key, returns articles by their web link with live blog updates and related links, and uses the same JSON shape as its other news sources. Check The Guardian's terms for your use case.
If you track several publishers, API.SH saves you learning each one's API or writing scrapers: one key, one response shape and a fixed price per call.
vs RapidAPI
vs Apify
vs SerpApi
vs ScraperAPIThe Guardian API questions
What Guardian data can I get?+
Headlines of any section, topic tag, series or contributor page with archive paging (/guardian/v1/headlines), and one article by link with authors, tags, images, full text blocks and live blog updates (/guardian/v1/article).
How much does The Guardian API cost?+
Every The Guardian endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.
Is there a free trial?+
Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /guardian/v1/article at 1 credit each.
Is there an official Guardian API?+
Yes. The Guardian Open Platform offers a content API with a free developer key, mainly for non-commercial use. API.SH is an alternative when you want articles by URL, live blog updates and one format shared with other news sites.
Do I need a Guardian API key or account?+
No. You only need your API.SH key. API.SH reads public theguardian.com pages and no endpoint uses a login or subscription.
Can I get the full article text?+
Yes. /guardian/v1/article returns the full text as ordered blocks: paragraphs, headings, lists, quotes, inline images with captions and credits, and embeds.
How do I get all articles from a section?+
Call /guardian/v1/headlines with section for the latest stories, or add page to go through the numbered archive pages; each response has last_page, total and next_page.
How do I get started?+
1. Sign up at api.sh. 2. Copy your API key. 3. Call /guardian/v1/headlines with section=technology/artificialintelligenceai. Docs and request examples are at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.
TechCrunch API
BBC News API
CNN API
Fox News API