API Tayara.tn : petites annonces tunisiennes en JSON, des voitures à l'immobilier, prix en TND

Sur Tayara.tn, on vend un peu de tout : voitures, appartements, téléphones, électroménager, meubles, et on y publie aussi des offres d'emploi. Cette API lit les annonces publiques et les renvoie en JSON, prix en dinars (TND), avec les filtres du site : catégorie, gouvernorat et délégation (La Marsa à Tunis, Route El Afrane à Sfax, Sousse…), fourchette de prix, et pour une voiture la marque, le modèle, l'année, le kilométrage, le carburant, la boîte et la puissance fiscale. Sans aucun paramètre, `search` parcourt tout le site, des annonces les plus récentes aux plus anciennes. Elle ne publie rien et n'a rien d'un outil pour gérer une boutique Tayara : elle sert à suivre des prix ou à mesurer l'offre d'une région, du point de vue de l'acheteur.

Exemple qui fonctionne

Les Volkswagen Polo à vendre dans le gouvernorat de Sfax, le 28 octobre 2026 : 16 annonces. Six n'avaient pas de prix (`price_tnd` à null, `price_raw` à 0, « Sans prix » sur le site), et une affichait 32 DT, montant qui ne peut pas être celui d'une voiture : certains vendeurs l'écrivent en milliers. Les autres allaient de 13 000 DT pour une Polo 3 à 139 500 DT pour une Polo GTI. La Polo 7 à 32 800 DT, ouverte ensuite avec `listing`, indiquait une année 2012, 180 000 km, une boîte manuelle, un moteur 1.2L et une puissance fiscale de 4 CV. `brand` et `model` s'écrivent exactement comme sur Tayara : « Volkswagen », « Polo ».

curl -X POST https://api.reefapi.com/tayara/v1/search \
  -H "x-api-key: VOTRE_CLE" \
  -H "content-type: application/json" \
  -d '{"subcategory": "Voitures", "brand": "Volkswagen", "model": "Polo", "governorate": "Sfax", "limit": 30}'

{
  "ok": true,
  "data": {
    "query": null,
    "total": 16,
    "page": 1,
    "limit": 30,
    "last_page": 1,
    "has_more": false,
    "sort": "newest",
    "listings": [
      {
        "id": "6ae1cfd728cf9f77de8432b7",
        "url": "https://www.tayara.tn/item/6ae1cfd728cf9f77de8432b7/",
        "title": "polo 6🇩🇪",
        "price_tnd": null,
        "price_raw": 0,
        "currency": "TND",
        "category_name": "Véhicules",
        "subcategory_name": "Voitures",
        "governorate": "Sfax",
        "delegation": "Sfax",
        "published_at": "2026-10-28T10:35:03.000Z",
        "images_count": 10,
        "seller_is_shop": false,
        "is_premium": false
      },
      ...
      {
        "id": "6addfb5428cf9f77de82a9c2",
        "title": "Polo 7 à vendre",
        "price_tnd": 32800,
        "price_raw": 32800,
        "currency": "TND",
        "governorate": "Sfax",
        "delegation": "Route El Afrane",
        "published_at": "2026-10-25T12:51:32.000Z"
      },
      ...
      {
        "id": "6acce94723043fa1d8d70c77",
        "title": "Polo gti",
        "price_tnd": 139500,
        "currency": "TND",
        "delegation": "Sfax Ville",
        "published_at": "2026-10-12T14:05:59.000Z"
      },
      {
        "id": "6ac03775cdf7e8adb5ecafcc",
        "title": "voiture",
        "price_tnd": 32,
        "price_raw": 32,
        "currency": "TND",
        "delegation": "Route El Afrane",
        "published_at": "2026-10-02T23:00:05.000Z"
      },
      ...
    ],
    "filters_applied": {
      "categoryId": "60be84bc50ab95b45b08a094",
      "subCategoryId": "60be84be50ab95b45b08a0a4",
      "adParamsMap": { "Marque": "Volkswagen", "Modèle": "Polo" },
      "governorate": "Sfax"
    }
  },
  "meta": { "record_count": 16, "upstream_requests": 1, "cache_hit": false, "mode": "live" }
}

Limites et remarques honnêtes

• Tayara.tn n'a ni conçu ni approuvé cette interface, et ReefAPI n'a aucun lien commercial avec le site : c'est un accès non officiel.
• Tayara ne vérifie pas les montants, et nous ne les retouchons pas : 32 DT pour une Polo à Sfax et, lors de nos mesures, un tri des voitures par prix décroissant qui s'ouvrait sur 1 380 000 000 000 DT. « Sans prix » correspond à un montant de 0 ou de 1 : `price_tnd` vaut alors null et `price_raw` garde le chiffre.
• La recherche libre ne se limite pas aux voitures : « polo 6 » dans le gouvernorat de Tunis a renvoyé 18 annonces, dont 7 de pièces et accessoires (moteurs, amortisseur, autoradio). Ajoutez `"subcategory": "Voitures"` pour ne garder que les véhicules.
• Les lignes de `search` ne contiennent pas l'identifiant du vendeur. Pour lister toutes les annonces d'un vendeur, passez d'abord par `listing`, qui donne `seller.id`, puis par `seller_listings`.
• Champs absents parce que Tayara ne les publie pas : position GPS (l'objet est vide sur les annonces), nombre de vues, évaluation du vendeur, date de modification distincte de la date de publication.
• Les coordonnées sont renvoyées telles que Tayara les affiche : nom du vendeur dans `search`, et dans `listing` deux numéros distincts, celui de l'annonce et celui du compte. Le texte libre en contient aussi : 2 des 4 annonces de l'exemple avaient un numéro dans `description`, champ retiré de l'extrait. Ces numéros sont pour la plupart ceux de particuliers, et un relevé de prix n'en a aucun besoin.
• Les annonces payantes affichées en tête du site ne sont pas incluses par défaut ; avec `include_premium: true`, elles arrivent à part dans `premium_listings` et ne comptent pas dans `total`.
• Coût : 2 crédits pour `search`, `listing` et `seller_listings`, 1 crédit pour `categories` et `locations`.