API Automobile.tn : grille des prix du neuf et voitures d'occasion en Tunisie, en JSON

Avant d'acheter une voiture en Tunisie, deux rubriques d'Automobile.tn servent de repère : le prix du neuf, version par version, avec le prix TTC en dinars, la promotion du moment et l'importateur officiel ; puis les annonces d'occasion des particuliers et des showrooms, de Tunis à Sfax. ReefAPI transforme ces deux rubriques en JSON, montants en TND, et joint à chaque annonce d'occasion l'évaluation du prix calculée par Automobile.tn (« Bon prix », « Prix équitable », « Prix élevé »…). C'est un accès en lecture seule, pensé pour l'acheteur ou l'analyste : un showroom qui veut diffuser ou mettre à jour son stock sur Automobile.tn n'y trouvera aucune fonction de publication.

Exemple qui fonctionne

Sous 80 000 DT, trié du moins cher au plus cher, le catalogue du neuf comptait 85 modèles le 27 octobre 2026. Sur les 24 premiers, 7 sont des voitures populaires, avec « Populaire » dans le nom (Suzuki Celerio, Renault Kwid, KIA Picanto, Chery Tiggo 1X, Hyundai Grand i10, Mitsubishi Attrage, Citroën C3), de 28 457 à 35 000 DT. Ce sont des cartes distinctes, avec leur propre fiche et leurs conditions d'achat : celle de la Picanto Populaire 1.0 L, lue avec `new_version`, affiche 32 794 DT et la disponibilité « Disponible | Sous réserve d'acceptation du dossier par le ministère du commerce ». Pour comparer les prix d'un modèle, ne mélangez pas ces versions avec les autres : la Hyundai Grand i10 sans la mention démarre à 51 950 DT.

curl -X POST https://api.reefapi.com/automobile-tn/v1/new_search \
  -H "x-api-key: VOTRE_CLE" \
  -H "content-type: application/json" \
  -d '{"price_max": 80000, "sort": "price_asc"}'

{
  "ok": true,
  "data": {
    "total": 85,
    "page": 1,
    "page_size": 24,
    "last_page": 4,
    "page_clamped": false,
    "has_more": true,
    "sort": "price_asc",
    "models": [
      {
        "card_id": "47160",
        "name": "Bako Bee",
        "url": "https://www.automobile.tn/fr/neuf/bako/bee",
        "price_from_tnd": 18260,
        "price_old_tnd": null,
        "discount_tnd": null,
        "price_usd_duty_free": null,
        "badge": null,
        "currency": "TND"
      },
      {
        "card_id": "47162",
        "name": "Bako B-Van",
        "price_from_tnd": 22586,
        "price_usd_duty_free": 8900,
        "currency": "TND"
      },
      {
        "card_id": "46815",
        "name": "Suzuki Celerio Populaire",
        "url": "https://www.automobile.tn/fr/neuf/suzuki/celerio-populaire/1.0-l-gl",
        "single_version_slug": "1.0-l-gl",
        "price_from_tnd": 28457,
        "currency": "TND"
      },
      ...
      {
        "card_id": "47204",
        "name": "KIA Picanto Populaire",
        "url": "https://www.automobile.tn/fr/neuf/kia/picanto-populaire/1.0-l",
        "single_version_slug": "1.0-l",
        "price_from_tnd": 32794,
        "currency": "TND"
      },
      ...
      {
        "card_id": "46574",
        "name": "DFSK K02S",
        "price_from_tnd": 40900,
        "price_old_tnd": 42900,
        "discount_tnd": 2000,
        "discount_computed_tnd": 2000,
        "badge": "Promo",
        "currency": "TND"
      },
      ...
      {
        "card_id": "47058",
        "name": "Hyundai Grand i10",
        "url": "https://www.automobile.tn/fr/neuf/hyundai/grand-i10",
        "price_from_tnd": 51950,
        "currency": "TND"
      }
    ],
    "facets": { "fuel": [{ "label": "Essence", "count": 54 }, { "label": "Electrique", "count": 16 }, ...], ... }
  },
  "meta": { "record_count": 24, "upstream_requests": 1, "cache_hit": false, "mode": "live" }
}

Limites et remarques honnêtes

• Service tiers, non officiel : il n'est ni édité ni approuvé par Automobile.tn, et aucun contrat ne nous lie au site.
• Dans `search`, `summary` reprend tel quel le début du texte du vendeur. Sur nos 12 Volkswagen de Tunis, ce champ contenait des numéros de téléphone dans les 12 lignes, et rien d'autre dans 7 d'entre elles. Pour la description de la voiture, passez par `listing`.
• Le bloc vendeur de `listing` contient le téléphone affiché sur l'annonce, plus le nom et l'adresse quand il s'agit d'un showroom ; les particuliers ne publient pas de nom. Gardez ces coordonnées hors de vos tables si vous n'en avez pas l'usage.
• L'énergie est plus précise dans `listing` que dans `search` : la même Golf 8 GTE était « Hybride » dans la liste et « Hybride rechargeable essence » sur son annonce.
• `price_rating` est l'évaluation d'Automobile.tn, reprise sans recalcul. Sur les 12 lignes de notre recherche, elle prenait quatre valeurs, de « Bon prix » à « Prix très élevé ».
• Le prix en dollars hors taxes (`price_usd_duty_free`) n'existe que lorsque l'importateur le publie, comme les 8 900 $ du Bako B-Van à côté de 22 586 DT ; il n'est jamais converti en dinars, ni l'inverse.
• Automobile.tn ne publie ni VIN exploitable, ni nombre de vues, ni date d'expiration des annonces : aucune réponse ne les contient.
• Tarifs par appel : 2 crédits pour `search`, `makes`, `new_search`, `new_brands` et `new_version`, 3 crédits pour `listing` et `new_versions`.