Developers / Students / Hackathons

It's free. Take it.

Korea's official government releases and world headlines — no key, no signup, no 'contact sales' wall. Hit it over REST or paste an iframe, your call. You won't have to email anyone for a token; just call it. (Korean public data is §24-2 free-use; international outlets via standard RSS.)

Before you email a lawyer — all of this is fine

예Call it from a site or app that runs ads. Make money, it's fine.
예Drop it into a paid SaaS or a hackathon submission.
예Re-shape it, transform it, feed it to your AI. Go wild.
단Just keep the source name. A nod to OdinBox News is appreciated, never required.

Poke it now Endpoints Embed widget OpenAPI

Live demo — run it here

live

Pick an endpoint, tweak the params, hit Run for a real response. Copy the curl command and paste it straight into a terminal. No auth key needed.

Endpoint

Endpoints

All GET. CORS allow-all. JSON only. /api/v1/ prefix guarantees stability.

GET/api/v1/articlesTry live →
Latest articles. Supports limit (≤50), category, locale
```
curl 'https://odinbox-news.com/api/v1/articles?limit=10&category=tech&locale=ko'
```

GET/api/v1/articles/[id]Try live →

Single article by id

curl 'https://odinbox-news.com/api/v1/articles/123?locale=ko'

GET/api/v1/trendingTry live →
Right-now trending — keywords + searches + hot articles in one call
```
curl 'https://odinbox-news.com/api/v1/trending?locale=ko'
```
GET/api/v1/topicsTry live →
Curated topic hubs (Trump, AI, Bitcoin, etc.)
```
curl 'https://odinbox-news.com/api/v1/topics?locale=ko'
```
GET/api/v1/eventsTry live →
Upcoming events (elections, central banks, earnings). include_past=1 for archive
```
curl 'https://odinbox-news.com/api/v1/events?locale=ko'
```
GET/api/v1/sourcesTry live →
Roster of Korean public bodies + international outlets (60+). Filter with lang=ko|en
```
curl 'https://odinbox-news.com/api/v1/sources?lang=ko'
```
GET/api/v1/categoriesTry live →
Category metadata (labels, colors, emoji, icons) — 10 entries
```
curl 'https://odinbox-news.com/api/v1/categories?locale=ko'
```
GET/api/v1/regionTry live →
17 Korean provinces + auto-detected caller location. ?slug=seoul to scope by region
```
curl 'https://odinbox-news.com/api/v1/region?slug=seoul'
```
GET/api/v1/storylinesTry live →
Curated long-running storylines (BOK rates, housing, disasters, elections). ?slug=<slug> returns the storyline + 30 latest articles
```
curl 'https://odinbox-news.com/api/v1/storylines?slug=korea-monetary-policy'
```
GET/api/v1/calcTry live →
Everyday calculators — fn=loan|savings|income-tax|net-pay|fx|bmi|… (returns JSON)
```
curl 'https://odinbox-news.com/api/v1/calc?fn=loan&principal=30000000&rate=4.5&months=36'
```
GET/api/v1/metricsTry live →
Daily metric trends — metric=usdkrw|kospi|wti|seoul_pm25, days=7–365
```
curl 'https://odinbox-news.com/api/v1/metrics?metric=usdkrw&days=30'
```
GET/api/v1/localTry live →
Local info — live weather/air + city hall for 17 regions. region=<slug>
```
curl 'https://odinbox-news.com/api/v1/local?region=seoul'
```
GET/api/chatTry live →
Read live chat (poll) — room=…, after=<id>. Post via POST /api/chat
```
curl 'https://odinbox-news.com/api/chat?room=general'
```
GET/api/chat/statsTry live →
Chat stats — online count, per-room, today's messages, popular
```
curl 'https://odinbox-news.com/api/chat/stats?room=general'
```

Code examples

JavaScript / Browser

// Fetch the 10 latest articles
const res = await fetch(
  "https://odinbox-news.com/api/v1/articles?limit=10&locale=ko"
);
const { items } = await res.json();
items.forEach((a) =>
  console.log(a.title, "—", a.source.name)
);

Python

import requests

r = requests.get(
  "https://odinbox-news.com/api/v1/articles",
  params={"limit": 10, "locale": "ko"},
)
for item in r.json()["items"]:
    print(item["title"], "—", item["source"]["name"])

Node.js

import { fetch } from "undici"; // or built-in in Node 22+

const r = await fetch(
  "https://odinbox-news.com/api/v1/trending?locale=ko"
);
const data = await r.json();
console.log("Top keywords:",
  data.keywords.map((k) => k.word).join(", ")
);

curl

curl -s 'https://odinbox-news.com/api/v1/topics?locale=ko' | jq '.items[].name'

What people build with it

Nobody gets inspired staring at an endpoint list. Copy one, change a word, ship it.

Live headlines on your blog

WordPress, Ghost, plain HTML — one line. Pick color and count in the widget builder below.

HTML

<iframe src="https://odinbox-news.com/embed/headlines?count=5&theme=light&locale=en"
  width="100%" height="284" style="border:0;border-radius:12px"
  loading="lazy" title="OdinBox News"></iframe>

Add a live chat room to your site

Embed the anonymous live chat in one line. Pick a room and theme — general·issue·worldcup·free / dark·light.

HTML

<iframe src="https://odinbox-news.com/embed/chat?room=general&theme=dark"
  width="100%" height="520" style="border:0;border-radius:16px"
  loading="lazy" title="OdinBox Live Chat"></iframe>

Embed the World Cup widget

Fixtures, live scores and group standings as a card widget.

HTML

<iframe src="https://odinbox-news.com/embed/worldcup?theme=dark&locale=en"
  width="100%" height="420" style="border:0;border-radius:12px"
  loading="lazy" title="OdinBox World Cup"></iframe>

Pipe disaster alerts into Slack

Government safety + weather releases, straight to your team channel. Five minutes.

Node.js

const { items } = await (await fetch(
  "https://odinbox-news.com/api/v1/articles?category=disaster&limit=5&locale=en"
)).json();
for (const a of items) {
  await fetch(process.env.SLACK_WEBHOOK, {
    method: "POST",
    body: JSON.stringify({ text: a.title + "\n" + a.original_url }),
  });
}

Policy headlines into a dataframe

Pull economy/policy releases for keyword trends or source analysis.

Python

import requests, pandas as pd

r = requests.get("https://odinbox-news.com/api/v1/articles",
                 params={"category": "economy", "limit": 50, "locale": "en"})
df = pd.DataFrame(r.json()["items"])
print(df[["title", "category", "published_at"]].head())

iframe widget

Paste a single iframe into any blog or site to display live OdinBox headlines. Supports light/dark themes and Korean/English.

Count5

Theme

Language

Live preview

Embed code (paste anywhere)

<iframe
  src="https://odinbox-news.com/embed/headlines?count=5&theme=light&locale=en"
  width="100%"
  height="284"
  style="border:0;border-radius:12px"
  loading="lazy"
  title="OdinBox News headlines">
</iframe>

⚽ World Cup widget

Embed Korea's matches + live scores from the 2026 World Cup.

HTML

<iframe
  src="https://odinbox-news.com/embed/worldcup?theme=light&locale=en"
  width="100%" height="360" style="border:0;border-radius:12px"
  loading="lazy" title="2026 World Cup"></iframe>

Attribution badge

Attribution helps a lot. Not required — but pick a color and paste the HTML or Markdown straight in.

Color

HTML

<a href="https://odinbox-news.com" target="_blank" rel="noopener">
  <img src="https://odinbox-news.com/api/badge?variant=red" alt="Powered by OdinBox News" height="32" />
</a>

Markdown

[![Powered by OdinBox News](https://odinbox-news.com/api/badge?variant=red)](https://odinbox-news.com)

Usage policy summary

✓Both commercial and non-commercial use are fine. Students, hackathons, blogs welcome.
✓No auth key. Reasonable usage (under 60 requests/minute) appreciated.
✓Headlines + AI summaries belong to the source publisher's domain. Always display source.name + source.homepage when rendering.
✕We do not provide full article bodies. AI summaries are derivative from the headline — always verify against the source.
✕No scraped mirror sites that bypass OdinBox traffic. Use the API, link back, share the data.

We aggregate only headlines and links from publisher RSS feeds. Read the body at the source. See copyright policy · licensing.

Need something else?

Endpoint requests, bug reports, project show-and-tell — all welcome. Free for students + hackathons; just credit us.

support@odinbox.co.kr →