News API · IPTC ninjs 2.1
News by the story, not by the subscription.
PEDIEN Wire is a pull API for publishers. List what’s available for free, then pay only for the full stories you take. Taking the same story again costs nothing.
U.S. public-sector news
Releases from U.S. federal agencies and public bodies, cleaned of boilerplate and formatted in ninjs, with image credits in standard fields. Stories too short to publish are held back before you are charged.
Korean regional news in English
Stories from Korean cities and provinces, translated for international readers. Tell us if you want early access.
How it works
Get a key
We issue an API key with prepaid credits. Send it in the X-Api-Key header.
Browse free
GET /articles lists headlines, sources and length, and marks what you already took.
Pay per story
GET /articles/{id} returns the full ninjs document and uses one credit. Asking again is free.
Endpoints
The base URL comes with your key.
| Method | Path | Returns | Cost |
|---|---|---|---|
GET | /api/wire/v1/health | Service status | Free · no key |
GET | /api/wire/v1/me | Your balance and usage | Free |
GET | /api/wire/v1/articles?market=us&limit=20&since=… | List stories: headline, source, length, whether you already took it. No body. | Free |
GET | /api/wire/v1/articles/{id} | Full story as an IPTC ninjs 2.1 document, with image credit fields | 1 credit · repeats free |
Errors
- 401Missing or invalid API key
- 402Out of credits
- 409Story too short to publish; checked before any charge
Sample response
{
"market": "us",
"count": 2,
"items": [
{
"uri": "urn:pedien:wire:us:1790339406953",
"id": "1790339406953",
"headline": "NASA to Study Human Health, Performance During Crew-13 Mission",
"source": "NASA",
"versioncreated": "2026-09-25T21:30:06+09:00",
"has_image": true,
"body_chars": 4993,
"already_taken": false
},
{
"uri": "urn:pedien:wire:us:1790339404113",
"headline": "NASA Unveils Winning Designs for Mars Space Food Systems Challenge",
"source": "NASA",
"body_chars": 5444,
"already_taken": true
}
]
}Tell us where your story needs to go.
Choose a topic and we’ll route your message to the right person.
Start a conversation →