Stuff API, RSS and sitemap
Every article Stuff publishes, as JSON, through an open API with no key and no signup. 31,764 of their articles are indexed right now, refreshed hourly.
New ZealandEnglishChineserur#158 by volume
Four ways to pull co.nz
All four are ours, all four are live, and none of them needs a key.
JSON Search this publisher
Every article we hold from co.nz, newest first. Add q= to search inside.
curl -s "https://freenewsapi.ai/v1/search?host=www.odt.co.nz&size=20"open it →RSS Subscribe in any reader
The same articles as an RSS 2.0 feed. Works in Feedly, Inoreader, Thunderbird — anywhere.
curl -s "https://freenewsapi.ai/v1/rss?host=www.odt.co.nz&size=50"open it →JSON Feed For apps
JSON Feed 1.1, the same content in a format apps parse natively.
curl -s "https://freenewsapi.ai/v1/feed.json?host=www.odt.co.nz&size=50"open it →Trimmed For agents
Only the fields an agent needs — title, url, date, language — so the response stays small.
curl -s "https://freenewsapi.ai/v1/search?host=www.odt.co.nz&size=20&fields=title,url,published_at,lang"open it →Call the API
A live request. Paste it into a terminal and Stuff headlines come back as JSON.
curl "https://freenewsapi.ai/v1/search?host=www.odt.co.nz&size=5"This page covers 34 hosts of co.nz as one publisher: www.odt.co.nz, www.stuff.co.nz, www.thepost.co.nz, www.thepress.co.nz, www.waikatotimes.co.nz, www.chineseherald.co.nz, www.farmersweekly.co.nz, latitudemagazine.co.nz, www.nowtolove.co.nz, www.teaonews.co.nz, supermarketnews.co.nz, www.vegetarians.co.nz and 22 more. The API accepts them comma-separated in host.
Publishing volume
Articles per day over the last 90 days. The busiest hour is 16:00 UTC — that is when the newsroom pushes its main batch.
The 29 hatched days are gaps in the upstream news archive, not quiet days at Stuff: the whole corpus dips on those dates. They are excluded from the median above.
curl "https://freenewsapi.ai/v1/stats?host=www.odt.co.nz&top=10"Publishing rhythm
When Stuff actually publishes, by hour of day (UTC) and by day of week — measured from 31,764 timestamps, not from a schedule they advertise.
Sections
Sections come from the publisher's own markup, present on 40% of their articles.
| Section | Articles | |
|---|---|---|
sport | 4,486 | |
politics | 3,572 | |
business | 2,486 | |
travel | 1,190 | |
Dunedin | 1,145 | |
National | 658 | |
society | 563 | |
Southland | 493 | |
Christchurch | 429 | |
Queenstown | 423 | |
North Canterbury | 341 | |
World | 326 | |
North Otago | 267 | |
Opinion | 255 |
Languages
The site identifies itself under Stuff, The Post, Otago Daily Times, The Press, Waikato Times — separate editions publishing under one domain.
| Code | Language | Articles | Share |
|---|---|---|---|
en | English | 29,108 | 91.6% |
zh | Chinese | 1,919 | 6.0% |
rur | rur | 136 | 0.4% |
Latest articles
The 18 most recent Stuff articles in the index — the same rows the API returns, rendered for humans.
Harvest it all
Page through the archive by date. from and to accept
YYYY-MM-DD or relative values such as now-7d.
curl "https://freenewsapi.ai/v1/search?host=www.odt.co.nz&from=now-7d&size=100"To poll for new material, keep the timestamp of the newest article you saw and ask only for what came after it:
curl "https://freenewsapi.ai/v1/search?host=www.odt.co.nz&from=now-1h&sort=date_asc"Article bodies come with full_text=true. No key, no quota tier, no
header — see the search endpoint for every parameter.
Metadata quality
How well Stuff marks up its own pages — useful if you are deciding whether to parse them yourself.
Crawl lag — the delay between publication and the article reaching this index — is 34 min at the median, 1879 minutes at the 90th percentile.
Similar publishers
Comparable outlets in the same language. Those without a page here yet link straight to their slice of the API.
FAQ
Does Stuff have an official API?
Not a public one. This endpoint is the practical alternative: their articles as structured JSON, with title, lead, publication time, section, byline and a link back to the original.
How do I get their RSS feed?
Most publishers expose one at /rss or /feed, but feeds carry
only the last few dozen items and drop them within hours. This index keeps 31,764 of
their articles and lets you filter by date, language and section.
How many articles does Stuff publish per day?
475 on a median day, measured across 90 days.
Can I use this commercially?
The API is free and unauthenticated. What you may do with the content is between you and the publisher: we return metadata, a lead paragraph and a link, not a licence.
