API eBay pour ebay.fr : les annonces en cours, leurs prix et leurs enchères en JSON

Avec `"domain": "fr"`, chaque appel interroge ebay.fr et renvoie ce qu'un acheteur voit sur le site : titre, prix en euros, état (« Occasion », « Neuf »), achat immédiat ou enchères avec le nombre d'enchères, frais de livraison, puis, sur la fiche, les caractéristiques saisies par le vendeur et la date de fin. Les API officielles d'eBay (programme eBay Developers) demandent d'enregistrer une application et d'obtenir des jetons OAuth, et servent notamment aux vendeurs pour gérer leurs annonces, leurs commandes ou leur stock ; ici, rien de tel : on lit les annonces publiques, côté acheteur. Une précision pour ceux qui cherchent le « prix vendu » : la recherche ne couvre que les annonces en cours, pas les objets déjà vendus.

Exemple qui fonctionne

Sur ces 20 premières lignes, 10 étaient des enchères, dont 9 à « 0 enchères » : le prix affiché est alors la mise à prix fixée par le vendeur, pas un prix de marché. `buying_format` garde le libellé d'ebay.fr et `buying_format_code` donne une valeur stable (`auction`, `buy_it_now`) pour filtrer. Les frais de port n'existent qu'en texte (« +2,78 EUR pour la livraison »). Et 8 lignes n'avaient ni état, ni format, ni frais de port : la fiche de l'une d'elles, ouverte avec `item_detail`, donnait bien l'état (« New »), mais toujours pas de frais de port.

curl -X POST https://api.reefapi.com/ebay/v1/search \
  -H "x-api-key: VOTRE_CLE" \
  -H "content-type: application/json" \
  -d '{"query": "vinyle johnny hallyday", "domain": "fr", "max_results": 20}'

{
  "ok": true,
  "data": {
    "query": "vinyle johnny hallyday",
    "results": [
      {
        "item_id": "840061201435",
        "title": "Johnny Hallyday – 24.000 Baisers, EP 45 tours 17 cm, chanson française",
        "price": { "raw": "2,74 EUR", "value": 2.74, "currency": "EUR" },
        "condition": "Occasion",
        "buying_format": "0 enchères",
        "buying_format_code": "auction",
        "shipping": "+2,78 EUR pour la livraison",
        "url": "https://www.ebay.fr/itm/840061201435",
        "in_stock": true
      },
      {
        "item_id": "128155969867",
        "title": "Johnny Hallyday Album 2 Disques - 2x LP 33T Fra 1977. Médias x2 N.Mint.",
        "price": { "raw": "10,00 EUR", "value": 10.0, "currency": "EUR" },
        "condition": "Occasion",
        "buying_format": "Achat immédiat",
        "buying_format_code": "buy_it_now",
        "shipping": "+3,98 EUR pour la livraison",
        "url": "https://www.ebay.fr/itm/128155969867",
        "in_stock": true
      },
      ...
      {
        "item_id": "317251386866",
        "title": "JOHNNY HALLYDAY LE SPECIALISTE 45 TOURS PICTURE Lmtd 0570/1000 Vinyle RARE NEUF",
        "price": { "raw": "47,94 EUR", "value": 47.94, "currency": "EUR" },
        "url": "https://www.ebay.fr/itm/317251386866",
        "in_stock": true
      },
      ...
    ]
  },
  "meta": { "record_count": 20, "domain": "fr", "pagination": { "page": 1, "has_more": true }, "cache_hit": false, "mode": "live" }
}

Limites et remarques honnêtes

• Rien d'officiel : ce service ne fait pas partie de l'eBay Developers Program, et ReefAPI n'a conclu aucun accord avec eBay.
• Sans `domain`, la requête part sur ebay.com avec des prix en dollars ; pour la France, passez `"domain": "fr"` à chaque appel.
• Pas de recherche dans les objets vendus : eBay la réserve aux membres connectés (constaté en août 2026), et nous ne lisons pas eBay avec un compte. Les endpoints de cette API portent sur des annonces en cours, ou sur une annonce précise via `item_detail`, même terminée. Une API distincte, eBay Sold Listings (`ebay-sold`), lit ce qu'eBay publie encore sans connexion : la fiche d'une annonce vendue à partir de son numéro et les ventes passées d'un vendeur.
• Dans la recherche sur ebay.fr, `location` est resté vide sur les 40 lignes de nos deux requêtes, et aucune ligne ne nommait le vendeur. Les frais de port ne sont qu'un texte, et 8 lignes sur 20 sont arrivées sans état, sans format d'achat et sans frais de port.
• `item_detail` donne l'état en anglais (« Used », « New ») alors que la recherche l'affiche en français (« Occasion », « Neuf ») ; les caractéristiques, elles, restent en français (« État », « Vitesse : 45 tours »). Sur nos trois fiches, `return_policy` était vide et `seller` manquait deux fois.
• Les frais de port d'`item_detail` sont calculés pour le pays indiqué dans `shipping.country`, qui n'est pas forcément la France : sur une de nos trois fiches, c'était « USA » pour 9,60 €, alors que la carte de recherche affichait « +5,90 EUR pour la livraison ».
• Sur une enchère sans enchérisseur, `current_bid` contient la mise à prix (40,88 € sur une annonce à « 0 enchères ») et la fiche ne donne pas le nombre d'enchères : il faut le lire dans `buying_format` côté recherche. `time_left` n'est qu'un libellé tronqué (« Se termine dans ») ; l'heure de fin exacte est dans `end_time`.
• Coût : `search`, `deals` et `categories` 1 crédit, `item_detail` et `seller_items` 2, `seller_profile` 3, et `items_batch` 2 crédits par numéro d'objet envoyé.