OGHub API
OGHub's news, RSS feeds, games and maps, free to read from your sites, bots and apps.
Getting started
No key, no account: a GET request is enough. Responses are JSON (or XML for feeds), UTF-8.
Base URL
https://api.oghub.fr/v1curl "https://api.oghub.fr/v1/news?lang=en&limit=3"Feeds to subscribe to
Paste these URLs into your RSS reader, a Discord feed bot, Slack or IFTTT. Add ?lang=fr for French, ?category=<slug> for a specific game.
RSS https://api.oghub.fr/v1/feeds/news.xml
Atom https://api.oghub.fr/v1/feeds/news.atom
JSON https://api.oghub.fr/v1/feeds/news.jsonEndpoints
| GET | Parameters | |
|---|---|---|
| /v1/news | lang, category, limit, page | News, newest first (excerpt, image, categories, link). |
| /v1/news/categories | — | News categories (usable with ?category=). |
| /v1/news/{slug} | lang | A full article, as Markdown and HTML. |
| /v1/feeds/news.xml | lang, category, limit | RSS 2.0 news feed with full article content. |
| /v1/feeds/news.atom | lang, category, limit | Atom news feed. |
| /v1/feeds/news.json | lang, category, limit | JSON Feed 1.1 news feed. |
| /v1/games | limit, page, all | Games catalog (dates, platforms, images, links). all=1 for the whole catalog. |
| /v1/games/{slug} | — | One game of the catalog. |
| /v1/maps | lang | Published interactive maps, with their OGHub URL. |
Examples
JavaScript
const res = await fetch("https://api.oghub.fr/v1/news?lang=en&limit=5")
const { data, meta } = await res.json()
for (const article of data) {
console.log(article.title, article.url)
}
console.log(meta.total, "articles")Python
import requests
feed = requests.get("https://api.oghub.fr/v1/feeds/news.json", params={"lang": "en", "limit": 10}).json()
for item in feed["items"]:
print(item["title"], item["url"])JSON
{
"data": [
{
"id": 123,
"slug": "dmz-is-not-an-arc-raiders-copy",
"title": "DMZ is not an Arc Raiders copy",
"excerpt": "Since the release of Modern Warfare 4…",
"banner": "https://www.oghub.fr/…",
"url": "https://www.oghub.fr/en/news/dmz-is-not-an-arc-raiders-copy",
"language": "en",
"published_at": "2026-10-26T16:54:16+00:00",
"categories": [{ "slug": "cod-mw4", "name": "COD: Modern Warfare 4" }]
}
],
"meta": { "page": 1, "limit": 20, "total": 87, "pages": 5, "language": "en" }
}Usage rules
- 120 requests per minute per IP address. Beyond that the API answers 429 with a Retry-After header.
- Responses are cached for 2 minutes (Cache-Control, ETag, 304): no need to poll more often.
- Open CORS: you can call the API straight from a browser.
- Read-only. Only public content is exposed; members-only articles never are.
- Please credit OGHub with a link back to the original article or page (the url field of each item).
Errors
An error returns an HTTP status and a JSON body:
{ "error": { "code": "not_found", "message": "Article introuvable." } }400 · 404 · 429 · 500
Need a route we don't have? Tell us on the OGHub Discord.
Discord