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/v1
curl "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.json

Endpoints

GETParameters 
/v1/newslang, category, limit, pageNews, newest first (excerpt, image, categories, link).
/v1/news/categories—News categories (usable with ?category=).
/v1/news/{slug}langA full article, as Markdown and HTML.
/v1/feeds/news.xmllang, category, limitRSS 2.0 news feed with full article content.
/v1/feeds/news.atomlang, category, limitAtom news feed.
/v1/feeds/news.jsonlang, category, limitJSON Feed 1.1 news feed.
/v1/gameslimit, page, allGames catalog (dates, platforms, images, links). all=1 for the whole catalog.
/v1/games/{slug}—One game of the catalog.
/v1/mapslangPublished 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