API documentation · IPTC ninjs

Korean stories by API: developer guide.

This page is for the developer connecting a newsroom to the PEDIEN Wire API. Your API key and base URL are sent by email after your application is reviewed.

Apply for the API API or XML? →

Before you start

Authentication

Send your key in the X-Api-Key header on every request.

Market

Add market=kr to every list and story request. Korean stories are only returned with it.

Format

JSON. Full stories follow IPTC ninjs. Korean stories are in Korean.

Freshness

The list covers recent stories. Check it every 10 to 30 minutes rather than once a day.

Embargo

Stories with a release time appear only after that time.

How it works

Step 1

List

GET /articles?market=kr lists recent stories without the body.

Step 2

Take

GET /articles/{id}?market=kr returns the full story.

Step 3

Report

Optionally POST /publications with the URL where you ran it.

Endpoints

Paths below are relative to the base URL you receive with your key.

Method	Path	Returns
`GET`	`/api/wire/v1/health`	Service status. No key needed.
`GET`	`/api/wire/v1/me`	Your key: registered domains and usage so far.
`GET`	`/api/wire/v1/articles?market=kr&limit=20&since=2026-09-28T06:00:00`	Story list: headline, subheading, source, time, whether a photo is included, body length, and whether you already took it. No body. Newest first; limit up to 100; since returns only stories after that time (KST).
`GET`	`/api/wire/v1/articles/{id}?market=kr`	The full story as an IPTC ninjs document. Taking the same story again does not count against your usage.
`POST`	`/api/wire/v1/publications`	Publication report: send the story’s uri, the URL where you published it, and status published or removed. Only URLs on your registered domain are accepted.
`GET`	`/api/wire/v1/publications`	The publication reports you have sent.

Main fields in a story

Other standard ninjs fields may also be present; ignore the ones you don’t use.

Field	Meaning
`headline`	Headline
`description_text`	Subheading
`body_text`	Body as plain text; paragraphs are separated by a blank line
`byline`	Author field; usually the name of the body that issued the release
`source`	Issuing body
`versioncreated`	Time the story was registered (KST, ISO 8601)
`associations.featuremedia`	Lead photo: image address, caption and credit (creditline)
`copyrightnotice`	Source line to publish together with the story
`usageterms`	Terms of use
`uri`	Unique story identifier, used in publication reports

Sample response (excerpt)

A real story from 28 September 2026, shortened. Some fields are omitted.

GET /api/wire/v1/articles/1790550398401?market=kr

{
  "language": "ko",
  "versioncreated": "2026-09-28T08:06:30.497386+09:00",
  "headline": "속초시, 향후 4년 보건의료 정책에 시민 의견 담는다",
  "description_text": "2027~2030년 지역보건의료계획 수립 위한 주민 설문조사 실시",
  "body_text": "속초시가 2027년부터 2030년까지 추진할 보건의료 정책에 시민 의견을 반영하기 위해 …",
  "byline": "속초시",
  "source": "속초시",
  "associations": {
    "featuremedia": {
      "type": "picture",
      "renditions": { "original": { "href": "https://press.pedien.com/images/…png" } },
      "creditline": "속초시"
    }
  }
}

Errors

400Bad request, or an unsupported market value
401Missing or invalid API key
402Usage limit for your key reached
404Story not found: removed, or not yet past its embargo time
409Story does not meet the distribution standard; not counted
422Publication report URL is not on your registered domain

Don’t have a key yet?

Apply on the Korean News Feed page. We check your site and email you a key and the base URL.

Apply for the API →