API OGHub

Les actualités, flux RSS, jeux et cartes d'OGHub, en lecture libre pour tes sites, bots et applications.

Pour commencer

Aucune clé, aucun compte : une requête GET suffit. Les réponses sont en JSON (ou XML pour les flux), en UTF-8.

Adresse de base

https://api.oghub.fr/v1
curl "https://api.oghub.fr/v1/news?lang=en&limit=3"

Flux à abonner

Colle ces adresses dans ton lecteur RSS, Discord (bot de flux), Slack ou IFTTT. Ajoute ?lang=fr pour le français, ?category=<slug> pour un jeu précis.

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

Routes

GETParamètres 
/v1/newslang, category, limit, pageActualités, du plus récent au plus ancien (résumé, image, catégories, lien).
/v1/news/categories—Catégories d'actualités (utilisables avec ?category=).
/v1/news/{slug}langUn article complet, en Markdown et en HTML.
/v1/feeds/news.xmllang, category, limitFlux RSS 2.0 des actualités, article complet inclus.
/v1/feeds/news.atomlang, category, limitFlux Atom des actualités.
/v1/feeds/news.jsonlang, category, limitFlux JSON Feed 1.1 des actualités.
/v1/gameslimit, page, allCatalogue des jeux (dates, plateformes, images, liens). all=1 pour tout le catalogue.
/v1/games/{slug}—Un jeu du catalogue.
/v1/mapslangCartes interactives publiées, avec leur adresse sur OGHub.

Exemples

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" }
}

Règles d'usage

  • 120 requêtes par minute et par adresse IP. Au-delà, l'API répond 429 avec un en-tête Retry-After.
  • Les réponses sont mises en cache 2 minutes (Cache-Control, ETag, 304) : inutile d'interroger plus souvent.
  • CORS ouvert : tu peux appeler l'API directement depuis un navigateur.
  • Lecture seule. Seul le contenu public est exposé ; les articles réservés aux membres ne le sont jamais.
  • Merci de citer OGHub avec un lien vers l'article ou la page d'origine (champ url de chaque élément).

Erreurs

Une erreur renvoie un statut HTTP et un corps JSON :

{ "error": { "code": "not_found", "message": "Article introuvable." } }

400 · 404 · 429 · 500

Une idée de route, un besoin particulier ? Écris-nous sur le Discord d'OGHub.

Discord