ard.de APIard.de ↗
Access Tagesschau headlines, full articles, breaking news, regional filters, and ARD Mediathek content via 6 structured API endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/6ed67865-b2e6-415e-8aa7-361eb0f81334/get_homepage_news' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetches the top/featured news stories and regional news from the Tagesschau homepage. Returns trimmed items with essential metadata including title, date, teaser image, tags, and links.
No input parameters required.
{
"type": "object",
"fields": {
"news": "array of featured news items with sophoraId, title, date, teaserImage, tags, topline, firstSentence, ressort",
"type": "string indicating page type",
"regional": "array of regional news items with the same structure as news items",
"newStoriesCountLink": "string URL to check for new story count"
},
"sample": {
"data": {
"news": [
{
"date": "2026-05-15T08:54:23.119+02:00",
"tags": [
{
"tag": "China"
},
{
"tag": "USA"
}
],
"type": "story",
"title": "Kooperation statt Konfrontation?",
"ressort": "ausland",
"topline": "Treffen von Trump und Xi",
"sophoraId": "china-treffen-trump-xi-100",
"teaserImage": {
"alttext": "Xi Jinping und Donald Trump",
"imageUrl": "https://images.tagesschau.de/image/6dfd317c-a08c-4abf-816f-22e5b30c78fa/AAABnio03sI/AAABnSSvmjA/16x9-640.jpg",
"copyright": "AFP"
},
"breakingNews": false,
"firstSentence": "US-Präsident Trump und der chinesische Staatschef Xi haben ihre Gespräche in Peking abgeschlossen."
}
],
"type": "news",
"regional": [
{
"date": "2026-05-15T12:59:00.000+02:00",
"type": "story",
"title": "Auto rauscht nachts bei Bad Rappenau in den Neckar und versinkt",
"regionId": 1,
"sophoraId": "swr-auto-rauscht-nachts-bei-bad-rappenau-in-den-neckar-und-versinkt-fahrer-rettet-sich-selbst-100"
}
],
"newStoriesCountLink": "https://www.tagesschau.de/api2u/newStoriesCount?state=..."
},
"status": "success"
}
}About the ard.de API
The ARD / Tagesschau API provides 6 endpoints covering news retrieval, article search, and media content from Germany's public broadcaster. Use get_article_detail to fetch full article content by Sophora ID, or get_latest_news to pull a paginated news feed filtered by section (ressort) or German state (region_id). All responses return structured JSON with consistent fields like sophoraId, teaserImage, tags, and firstSentence.
News Feed and Homepage
get_homepage_news returns the featured stories and regional news currently displayed on the Tagesschau homepage. Each item includes a sophoraId, title, date, teaserImage, topline, firstSentence, tags, and ressort. A newStoriesCountLink URL is also returned so you can poll for updates without re-fetching the full payload. get_latest_news extends this with optional filtering: pass a ressort value (inland, ausland, wirtschaft, or sport) to narrow by section, or pass a numeric region_id to filter by German federal state. Results include a nextPage URL for pagination.
Article Search and Full Content
search_news accepts a required query string and optional page (0-based) and page_size integers. The response echoes back searchText, resultPage, and pageSize alongside totalItemCount and a searchResults array. Each result carries sophoraId, title, date, teaserImage, tags, content, and type. To retrieve a complete article, pass a sophora_id to get_article_detail, which returns the full content array of typed blocks (e.g. type: "text" with HTML value), plus ressort, topline, and firstSentence.
Breaking News and Mediathek
get_breaking_news filters the live news feed for items flagged as breaking. The response is a breaking_news array that may be empty when no breaking stories are active — callers should handle both states. get_mediathek_home fetches the ARD Mediathek homepage and returns a widgets array, each widget containing a title, type, a teasers array of TV shows, documentaries, or livestreams, and pagination metadata for that widget's content.
- Build a German-language news dashboard filtering Tagesschau content by
ressort(e.g. 'wirtschaft' for business news). - Monitor
get_breaking_newson a polling schedule to trigger alerts when breaking stories are active. - Aggregate regional news by passing German state
region_idvalues toget_latest_news. - Index Tagesschau articles for full-text search by combining
search_newspagination withget_article_detailcontent blocks. - Display curated ARD Mediathek content widgets (shows, documentaries, livestreams) in a third-party media app.
- Track how a topic (e.g. 'Ukraine') is covered over time using
search_newswithtotalItemCountand date fields. - Build a Sophora ID resolver that maps article URLs to structured metadata and full HTML content blocks.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ARD have an official public developer API?+
What does `get_latest_news` return when no filters are applied, and what filters are supported?+
get_latest_news without filters returns both a news array and a regional array alongside a nextPage URL for pagination. When you supply a ressort value — one of inland, ausland, wirtschaft, or sport — or a numeric region_id, the response is narrowed to matching items. Applying filters typically removes the regional array from the response.Can I retrieve audio content or podcast feeds through this API?+
get_mediathek_home, but does not expose ARD Radio or podcast feed data. You can fork this API on Parse and revise it to add an endpoint targeting ARD Audiothek or radio content.How does `get_article_detail` handle the `sophora_id` input?+
china-treffen-trump-xi-100) or a full details API URL. The response content is delivered as an array of typed blocks: each block has a type field (e.g. "text") and a value field containing HTML. Not all article types return every field — some may omit video or image blocks if the original article does not include them.Does the API expose comment counts, author names, or share metrics for articles?+
title, date, tags, topline, firstSentence, ressort, and teaserImage. Author attribution and social engagement metrics are not part of any response. You can fork this API on Parse and revise it to add those fields if the source exposes them on individual article pages.