API RhinoTendersBETA
Consommez le catalogue d'annonces de façon programmatique, dans les limites de votre propre plan d'abonnement.
Documentation pour agents IA (.txt)https://api.rhinotenders.com /api/v1/dataIntroduction
L'API de données RhinoTenders permet à vos propres intégrations de récupérer le catalogue d'annonces auquel vous avez déjà accès via votre abonnement : vérification de statut, liste, filtres, organismes et détail d'une annonce.
C'est une API REST en lecture seule (tous les endpoints sont en GET). L'accès doit être activé par un administrateur RhinoTenders pour votre compte, puis vous générez vous-même votre token depuis votre espace API.
Pas encore d'accès production ? Tout compte au profil complété peut tester l'API immédiatement en sandbox, sans abonnement — voir Sandbox vs Production.
Authentification
Chaque requête doit inclure votre token en Bearer dans l'en-tête Authorization :
Authorization: Bearer <your_token>Votre token n'est affiché qu'une seule fois, à sa génération (ou régénération) depuis le dashboard — conservez-le en lieu sûr, il ne peut plus être récupéré ensuite.
Sandbox vs Production
La sandbox permet de construire et tester une intégration sans toucher à la production : essayer les endpoints, déboguer votre code, ou confier un token jetable à un développeur ou prestataire plutôt que de partager votre token de production.
Générez vous-même un token sandbox depuis votre espace API : ouvert à tout compte dont le profil est complété, sans abonnement ni validation d'un administrateur. Le token est valable 24 heures et chaque compte n'a qu'un seul token sandbox actif : en générer un nouveau invalide immédiatement le précédent.
Les deux environnements exposent exactement les mêmes endpoints, paramètres et formats de réponse : seuls l'URL de base et le token changent. Changer d'environnement est un changement de configuration, pas de code.
| Critère | Production | Sandbox |
|---|---|---|
| URL de base | https://api.rhinotenders.com | https://api.rhinotenders.com |
| Token | Token longue durée, valable 1 an (nom : api-client). | Token jetable, valable 24 heures (nom : api-sandbox). Un seul token actif par compte. |
| Obtention | Généré depuis votre espace API une fois l'accès API activé pour votre compte par un administrateur RhinoTenders. Abonnement actif requis. | En libre-service depuis votre espace API, pour tout compte au profil complété, quel que soit l'abonnement. |
| Données | Tout le catalogue couvert par votre abonnement. | Un nombre limité d'annonces réelles, pour tester votre intégration. |
| Quota et abonnement | Selon le plan d'abonnement : les appels de détail d'annonce consomment du quota. | Aucun. Les champs subscription et quota gardent la même forme, avec des valeurs null. |
| Limite de débit | 15 requêtes/minute, et par jour 750 requêtes (plan gratuit) ou 2500 requêtes (plan payant). | 10 requêtes/minute et 250 requêtes/jour (compteurs distincts de la production). |
| Filtres premium | Disponibles selon votre plan (hasAdvancedFilters). | Non disponibles : organism_id, ending_date_start, ending_date_end sont acceptés mais ignorés silencieusement, et hasAdvancedFilters vaut toujours false. |
| Marqueur d'environnement | En-tête X-Api-Environment: production. GET /status renvoie data.environment = "production". | En-tête X-Api-Environment: sandbox. GET /status renvoie data.environment = "sandbox". |
| Mauvais token | Un token sandbox envoyé sur cette URL de base renvoie 401 wrong_environment. | Un token de production envoyé sur cette URL de base renvoie 401 wrong_environment. |
Réponse — token Sandbox envoyé sur l’URL de base Production (401)
{
"success": false,
"message": "This is a sandbox token. Use the sandbox base URL (/api/v1/sandbox).",
"code": "wrong_environment"
}Statut
/api/v1/data/statusVérifie que votre token est valide et retourne en un seul appel l'environnement (data.environment : production ou sandbox) et l'état de votre accès API, de votre abonnement et de votre quota. Utile pour vérifier votre intégration. Appel libre, ne consomme aucun quota.
Requête
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/data/status"Réponse
{
"success": true,
"data": {
"environment": "production",
"token": { "name": "api-client", "created_at": "2026-08-01T10:00:00Z", "expires_at": "2027-08-01T10:00:00Z" },
"api_access": { "active": true },
"subscription": { "plan": "Standard", "status": "active" },
"quota": {
"daily": { "limit": 100, "used": 7, "remaining": 93, "resets_at": "2026-09-24T00:00:00Z" },
"total": { "limit": null, "used": null, "remaining": null }
}
}
}Liste des annonces
/api/v1/data/tendersRetourne les annonces correspondant aux filtres donnés. Mêmes paramètres que la recherche du site (recherche texte, activité, localisation, statut, type, organisme, dates). Les filtres avancés (organisme, date de fin) sont ignorés silencieusement si votre plan n'y donne pas accès, et toujours en sandbox — jamais d'erreur. Appel libre, ne consomme aucun quota, mais bloqué en production (403) si votre abonnement n'est pas actif ou si votre quota de consultation est déjà épuisé.
| tender_id | Un seul ID d'annonce — ignore tous les autres filtres. |
| tender_ids | Plusieurs ID séparés par des virgules — ignore tous les autres filtres. |
| search | Recherche texte (titre, code). |
| activity_id | ID(s) d'activité, séparés par des virgules. |
| location_id | ID(s) de localisation, séparés par des virgules. |
| status_id | ID(s) de statut, séparés par des virgules. |
| organism_id | ID(s) d'organisme — filtre avancé, ignoré si non autorisé par votre plan, toujours ignoré en sandbox. |
| tender_type | National, International, ou les deux séparés par une virgule. |
| publish_date_start / publish_date_end | Plage de date de publication (AAAA-MM-JJ). |
| ending_date_start / ending_date_end | Plage de date limite — filtre avancé, ignoré si non autorisé par votre plan, toujours ignoré en sandbox. |
| page / per_page | Pagination — per_page par défaut 20, plafond 100. |
Requête
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/data/tenders?page=1&per_page=20&activity_id=12000000"Réponse
{
"success": true,
"data": [
{
"id": 1490301,
"title": "Etude et suivi realisation de 4 classes en extention",
"organism": { "id": 3358, "name": "APC - Commune d'El Milia Wilaya de Jijel" },
"location": { "id": 20, "name": "Jijel" },
"status": { "id": 4, "name": "Résultats" },
"publish_date": "2026-09-09",
"ending_date": "2026-09-20T08:00:00Z"
}
],
"meta": { "current_page": 1, "per_page": 20, "total": 187 }
}Données de filtre
/api/v1/data/tenders/filtersDonnées de référence pour construire vos filtres : activités, statuts, localisations, types. Un seul objet complet (pas de pagination), caché 1 à 2h côté serveur. hasAdvancedFilters reflète votre plan d'abonnement (toujours false en sandbox).
Requête
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/data/tenders/filters"Réponse
{
"success": true,
"data": {
"locations": [{ "id": 20, "name": "Jijel", "type": "wilaya", "flag": null, "country_name": "Algérie" }],
"statuses": [{ "id": 4, "name": "Résultats" }],
"activities": [{ "id": 7233, "name": "[72110000] - Travaux de bâtiment" }],
"types": [
{ "value": "National", "label": "National" },
{ "value": "International", "label": "International" }
],
"hasAdvancedFilters": true
}
}Organismes
/api/v1/data/organizationsRecherche d'organismes par nom (q, insensible aux accents/casse) pour résoudre un organism_id à utiliser dans le filtre de la liste, ou pagination complète pour synchroniser l'annuaire. Uniquement les organismes ayant déjà publié au moins une annonce — jamais l'intégralité de l'annuaire interne.
| q | Recherche par nom, insensible aux accents/casse. |
| page / per_page | Pagination — per_page par défaut 50, plafond 500. |
Requête
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/data/organizations?q=education&per_page=50"Réponse
{
"success": true,
"data": [
{ "id": 42, "name": "Ministère de l'Éducation" }
],
"meta": { "current_page": 1, "per_page": 50, "total": 3 }
}Détail d'une annonce
/api/v1/data/tenders/{id}Détail complet d'une annonce. En production, consomme une unité du quota de votre abonnement — exactement le même quota que la consultation sur le site (une annonce déjà vue, via l'API ou le site, n'est pas recomptée dans les 12 mois). Les annonces de type "Consultation en ligne" et les annonces expirées depuis plus de 10 jours ne consomment pas de quota, mais restent soumises aux mêmes règles d'accès : aucune exception si votre abonnement n'est pas actif ou si votre quota est déjà épuisé. La forme de la réponse dépend du statut de l'annonce (voir les deux exemples ci-dessous). En sandbox, aucun quota n'est consommé et les champs de quota valent null. Les annonces standard incluent sources : la liste des sources de publication de l'annonce officielle (nom de la source et image_url, lien direct vers l'image scannée, accessible sans token). Le champ description contient le texte complet de l'annonce en deux versions : html (structure seule, déjà nettoyé côté serveur : ni script, ni lien, ni image, ni style) et text (texte brut). Affichez text avec une insertion de texte (textContent), jamais comme du HTML ; si vous affichez html dans une page, nettoyez-le aussi de votre côté (ex. DOMPurify). generated vaut true quand le texte d'origine est trop volumineux et a été remplacé par un résumé généré à partir des champs de l'annonce (les détails restent dans lots et sources). description vaut null si l'annonce n'a pas de texte.
Requête
curl -H "Authorization: Bearer <your_token>" \
"https://api.rhinotenders.com/api/v1/data/tenders/1490301"Réponse — Annonce standard
{
"success": true,
"data": {
"id": 1490301,
"slug": "etude-et-suivi-realisation-de-4-classes-en-extention",
"title": "Etude et suivi realisation de 4 classes en extention",
"code": "07/2026",
"publish_date": "2026-09-09",
"ending_date": "2026-09-20T08:00:00Z",
"is_expired": true,
"status": { "id": 4, "name": "Résultats" },
"tender_type": "National",
"qualification": null,
"address_cdc": "Étude de Maître Belhadj Ali, huissier de justice, Boumerdès",
"cdc_price": { "amount": "16000000.00", "currency": "DZD" },
"organism": { "id": 3358, "name": "APC - Commune d'El Milia Wilaya de Jijel" },
"location": { "id": 20, "name": "Jijel", "type": "wilaya", "country_id": 2 },
"activities": [
{ "id": 7233, "name": "[72110000] - Travaux de bâtiment" }
],
"lots": [
{
"id": 536288,
"name": "Etude et suivi realisation de 4 classes en extention",
"entreprise": "Entreprise travaux batiment Beldjoudi Samir",
"nif": null,
"montant": "22730697.89",
"devise": "DZD",
"delai": 5,
"delai_unit": "m",
"order": 0
}
],
"description": {
"html": "<p><strong>AVIS D'ATTRIBUTION PROVISOIRE DE MARCHÉ</strong></p><p>APC d'El Milia</p><table><tr><th>Lot</th><th>Attributaire</th></tr><tr><td>1</td><td>Entreprise Beldjoudi Samir</td></tr></table>",
"text": "AVIS D'ATTRIBUTION PROVISOIRE DE MARCHÉ\n\nAPC d'El Milia\n\nLot | Attributaire\n1 | Entreprise Beldjoudi Samir",
"generated": false
},
"sources": [
{
"name": "BAOSEM",
"image_url": "https://storage.rhinotenders.com/tenders/sources/rh-ai-xorGHcEaL5sOUlpX1791965524.webp"
}
]
},
"subscription": {
"daily": { "limit": 100, "used": 8, "remaining": 92, "resets_at": "2026-09-24T00:00:00Z" },
"total": { "limit": null, "used": null, "remaining": null }
}
}Réponse — Consultation en ligne (statut 9)
{
"success": true,
"data": {
"id": 1487429,
"slug": "invitation-to-competitive-bidding-projet-ao-202677-058",
"title": "Invitation to Competitive Bidding | Projet AO_2026/77_058",
"publish_date": "2026-09-07",
"ending_date": "2026-09-30T23:45:00Z",
"is_expired": false,
"organism": { "id": 19321, "name": "General Electric Algeria Turbines (« GEAT »)" },
"location": { "id": 2, "name": "Algérie" },
"status": { "id": 9, "name": "Consultation en ligne" },
"activities": [
{ "id": 7182, "name": "[40180000] - Tubes et raccords" }
],
"description": {
"html": "<p>Fourniture de tubes et raccords selon le cahier des charges joint.</p>",
"text": "Fourniture de tubes et raccords selon le cahier des charges joint.",
"generated": false
}
},
"subscription": {
"daily": { "limit": 100, "used": 8, "remaining": 92, "resets_at": "2026-09-24T00:00:00Z" },
"total": { "limit": null, "used": null, "remaining": null }
}
}Codes d'erreur
| Statut | Signification |
|---|---|
| 401 | Token manquant, invalide, expiré ou révoqué (message générique, jamais de distinction). |
| 401 (wrong_environment) | Token utilisé dans le mauvais environnement : token sandbox sur l'URL de base de production (/api/v1/data) ou l'inverse. Le message indique l'URL de base à utiliser. |
| 403 (api_access_disabled) | Accès API désactivé pour ce compte par un administrateur, ou token qui n'a pas été généré pour cette API. |
| 403 (token_scope_violation) | Token de l'API data (production ou sandbox) utilisé en dehors de l'API data : il ne fonctionne que sur les endpoints documentés ici. |
| 403 (subscription_inactive) | Aucun abonnement actif ne donne accès au catalogue. Votre token est révoqué immédiatement : un nouveau ne peut être généré qu'après réactivation de votre abonnement. |
| 403 (quota_exceeded) | Quota d'abonnement épuisé pour la consultation d'annonces. |
| 404 | Annonce introuvable, non accessible, ou route invalide. |
| 422 | Paramètres de requête invalides (détail dans errors). |
| 429 | Limite de débit dépassée (15 requêtes/minute et 750 ou 2500 requêtes/jour selon votre plan en production ; 10 requêtes/minute ou 250 requêtes/jour en sandbox). |
Limites de débit
En plus du quota de votre abonnement (qui ne s'applique qu'aux appels de détail d'annonce en production), une limite technique protège l'API contre les abus : 15 requêtes par minute en production, avec un plafond de 750 requêtes par jour sur le plan gratuit et 2500 requêtes par jour sur un plan payant, 10 requêtes par minute et 250 requêtes par jour en sandbox.
Chaque limite est partagée entre tous les endpoints d'un même environnement pour votre compte (pas une limite séparée par endpoint), et les compteurs de production (/api/v1/data) et de sandbox (/api/v1/sandbox) sont indépendants. Chaque réponse inclut les en-têtes X-RateLimit-Limit et X-RateLimit-Remaining de la limite la plus proche d'être atteinte (par minute, ou par jour quand le plafond journalier approche) ; une réponse 429 inclut aussi Retry-After (en secondes). Évitez de redemander les mêmes annonces en boucle : interrogez la liste, puis ne demandez le détail que des annonces nouvelles.
