Interrogez Vinted par marque, taille, état ou catégorie, et recevez des annonces structurées : prix, description, marque, état, taille, profil vendeur.
Pas de brand ou de size séparés : configurez vos filtres directement sur vinted.fr (marque, taille, état, prix…), copiez l'URL de la page de résultats depuis votre navigateur, et passez-la telle quelle à l'API.
GET /api/v1/vinted/search
?url=<url_de_recherche_vinted.fr>
Authorization: Bearer <votre_cle_api>Extrait des champs disponibles. Liste complète dans la documentation technique.
| Champ | Type | Description |
|---|---|---|
id | string | Identifiant unique de l'article |
title | string | Titre de l'annonce |
brand | string | Marque de l'article |
size | string | Taille déclarée |
condition | string | État (neuf avec étiquette, très bon état...) |
price | string | Prix formaté avec devise, ex. "24.00 EUR" |
seller_name | string | Pseudo du vendeur |
seller_verified | boolean | Vendeur avec avis vérifiés ou non |
photos | array | URLs des photos |
url | string | Lien direct vers l'annonce |
La réponse inclut aussi count, total_count, credits_charged et credits_remaining.
curl -H "Authorization: Bearer TA_CLE_API" \
"https://bot.lebondeal-bot.fr/api/v1/vinted/search?url=https%3A%2F%2Fwww.vinted.fr%2Fcatalog%3Fsearch_text%3Dnike"{
"items": [
{
"id": "48213xxxx",
"title": "Sweat Nike Tech Fleece",
"brand": "Nike",
"size": "M",
"condition": "Très bon état",
"price": "24.00 EUR",
"seller_name": "clara.vintage",
"url": "https://www.vinted.fr/..."
}
],
"count": 1,
"total_count": 812,
"credits_charged": 1,
"credits_remaining": 9990
}| Code | Erreur | Signification |
|---|---|---|
400 | invalid_url | Le paramètre url est manquant ou invalide pour cette API |
401 | unauthorized | Clé API absente, invalide ou révoquée |
402 | insufficient_credits | Solde de crédits insuffisant |
402 | account_paused | Compte en pause (solde ou cap de dépenses global atteint) |
402 | api_limit_reached | Plafond jour/mois/max de cette API atteint |
403 | api_not_activated | API non activée sur le compte |
429 | rate_limited | Trop de requêtes (limite par clé ou par IP dépassée) |
503 | unexpected_error | Incident temporaire persistant malgré plusieurs tentatives internes |
503 — impossible de les distinguer côté client, mais aucun crédit n'est débité dans les deux cas.En plus d'un plafond de requêtes/minute propre à cette API, deux garde-fous s'appliquent à toutes les API du compte : 30 requêtes/minute par clé API, et 180 requêtes/minute par adresse IP. Une requête peut prendre jusqu'à ~40 secondes en cas d'incident temporaire — prévoyez un timeout client d'au moins 45 secondes.
Repérer automatiquement les articles sous-évalués d'une marque ou catégorie précise.
Suivre le volume et le prix moyen d'articles par marque ou par saison.
Comparer le positionnement prix d'une boutique seconde main à celui du marché.
Exemples détaillés : dropshipping, revente.
Oui, tous les filtres combinables sur vinted.fr (marque, taille, état, prix, catégorie) le sont aussi dans l'URL passée à l'API.
Non, seules les pages de résultats de recherche sont acceptées, pas les fiches article individuelles.
Une recherche vide et un échec technique renvoient tous les deux une erreur 503, sans distinction possible côté client — et sans débit de crédit dans les deux cas.
Non, seules les annonces actives au moment de la requête sont renvoyées.
LeBonDealBot Discord gratuit pour vos alertes Leboncoin, et API à la demande pour extraire des données Leboncoin, Vinted, Kleinanzeigen et Marktplaats en JSON.
© LeBonDeal — Tous droits réservés.