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.