Pour les entreprises

Le Journal Officiel dans vos systèmes

Une API pour chercher dans tout le JORT, récupérer le texte intégral de chaque numéro en français et en arabe, et être prévenu dès qu'un nouveau numéro mentionne un nom, un matricule fiscal ou un mot-clé.

Ce que vous obtenez

Recherche plein texte

Plus de 650 000 pages, français et arabe, avec filtres (collection, langue, années), tri par date ou pertinence, extraits surlignés et décomptes par année.

Texte intégral

Le texte de chaque numéro, page par page (JSON) ou d'un bloc (Markdown), pour vos bases documentaires, vos outils de conformité ou vos modèles d'IA.

Webhooks

Un appel HTTPS signé vers votre serveur à chaque nouveau numéro, ou seulement quand il contient votre requête (un débiteur, un matricule, « liquidation »…).

Clés, quotas, suivi

Une clé par application, un quota journalier adapté à votre volume, la consommation consultable à tout moment (/v1/usage).

Couverture

Journal Officiel, français 1957 – 2026 texte de chaque numéro
Annonces légales, français 2004 – 2026 sociétés, liquidations, ventes
Journal Officiel et Annonces, arabe 2006 – 2026 texte de chaque numéro
Tribunal immobilier, arabe 2003 – 2026 texte de chaque numéro

Les nouveaux numéros sont lus le jour même de leur publication. Les PDF officiels restent disponibles pour chaque numéro (pdf_url). Seul le texte arabe publié par l'Imprimerie Officielle fait foi.

Démarrer

Chaque requête porte votre clé dans l'en-tête Authorization. Les réponses sont en JSON (UTF-8).

curl -H "Authorization: Bearer $JORT_API_KEY" \
  "https://api.jort.tn/v1/search?q=liquidation&collection=annonces-legales&sort=newest&limit=5"
{
  "query": "liquidation",
  "total": 18342,
  "results": [
    {
      "collection": "annonces-legales",
      "language": "fr",
      "year": 2026,
      "issue": "137",
      "page": 12,
      "snippet": "... Dissolution anticipée et mise en <mark>liquidation</mark> ...",
      "pdf_url": "https://lake.jort.tn/annonces-legales/fr/2026/137.pdf",
      "text_url": "https://api.jort.tn/v1/issues/annonces-legales/fr/2026/137",
      "jort_url": "https://jort.tn/find/?c=annonces-legales&l=fr&y=2026&i=137&page=12&q=liquidation"
    }
  ],
  "facets": { "collection": { ... }, "language": { ... }, "year": { ... } }
}
curl -H "Authorization: Bearer $JORT_API_KEY" \
  "https://api.jort.tn/v1/issues/journal-officiel/ar/2024/080"          # JSON, page by page
curl -H "Authorization: Bearer $JORT_API_KEY" \
  "https://api.jort.tn/v1/issues/journal-officiel/fr/1985/012?format=md" # raw text (Markdown)

Référence

Base : https://api.jort.tn · collections : journal-officiel, annonces-legales, tribunal-immobilier · langues : fr, ar

GET /v1/search Recherche plein texte (français + arabe). q, collection, lang, year, year_from, year_to, match=phrase|all, sort=relevance|newest|oldest, group=1, limit ≤ 100, offset ≤ 2000.
GET /v1/issues Numéros disponibles en texte pour une année : collection, lang, year.
GET /v1/issues/{collection}/{lang}/{year}/{issue} Texte intégral d'un numéro, page par page. format=json|md, page=N.
GET /v1/usage Votre clé, vos limites et vos requêtes des 30 derniers jours.
GET /v1/webhooks Vos webhooks.
POST /v1/webhooks Créer : {url, query?, match?, collection?, lang?}. Sans query : chaque nouveau numéro.
GET /v1/webhooks/{id} Un webhook et ses 20 derniers envois.
POST /v1/webhooks/{id}/test Envoyer un événement de test.
DELETE /v1/webhooks/{id} Supprimer.

Webhooks

Sans requête, un événement issue.published part à chaque nouveau numéro. Avec une requête, un événement search.match part quand elle est trouvée dans le nouveau numéro, avec les pages et les extraits. Le secret renvoyé à la création signe chaque envoi (HMAC-SHA256 de « t.corps »). Un envoi en échec est retenté pendant 24 h (1 min, 5 min, 30 min, 2 h, 6 h, 12 h).

curl -X POST -H "Authorization: Bearer $JORT_API_KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/jort-hook","query":"0024667T","collection":"annonces-legales"}' \
  https://api.jort.tn/v1/webhooks
POST https://example.com/jort-hook
X-Jort-Event: search.match
X-Jort-Delivery: evt_5f0c2a9e1b7d4c3a
X-Jort-Signature: t=1795000000,v1=9b1c…

{
  "id": "evt_5f0c2a9e1b7d4c3a",
  "event": "search.match",
  "query": "0024667T",
  "issue": { "collection": "annonces-legales", "language": "fr", "year": 2026, "issue": "138",
             "pages": 64, "pdf_url": "…", "text_url": "…", "jort_url": "…" },
  "matches": [ { "page": 31, "snippet": "… <mark>0024667T</mark> …", "jort_url": "…" } ]
}
// Node.js: check that a delivery really comes from jort.tn
import { createHmac, timingSafeEqual } from "node:crypto";

function verify(rawBody, header, secret) {
  const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false; // replay
  const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
  return timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}

Limites et erreurs

  • Quota journalier par clé (remis à zéro à 00:00 UTC), annoncé dans les en-têtes X-RateLimit-Limit et X-RateLimit-Remaining ; 120 requêtes par minute au plus.
  • Erreurs au format {"error": {"code", "message"}} : 400 paramètre invalide, 401 clé absente ou révoquée, 404 numéro sans texte, 429 quota ou débit dépassé (voir Retry-After).
  • Les clés sont secrètes : appelez l'API depuis vos serveurs, pas depuis un navigateur.

Demander un accès

Tarif sur devis, selon le volume et les webhooks. Dites-nous ce que vous voulez faire : nous répondons sous 2 jours ouvrés avec une clé d'essai.

Ou écrivez à contact@jort.tn. Vos coordonnées servent seulement à vous répondre.