Rechercher des questions avec l'API Mercado Livre
Liste les questions posées par les acheteurs sur les annonces du vendeur, ou sur une annonce, avec la réponse quand elle existe. Les questions sans réponse de plus de 7 mois sont supprimées. Paginez avec offset et limit.
- Identifiant
- mercado_livre_search_questions
L'appel
POST https://connect.reportei.com/api/tools/mercado_livre_search_questions/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"seller_id": 1
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| seller_id | integer | Non | Id of the seller, from Get current user. Send it or item. |
| item | string | Non | Id of a listing, from Search items: only its questions. |
| status | string | Non | Only the questions in this status. UNANSWERED is the queue to answer.Valeurs : UNANSWERED, ANSWERED, CLOSED_UNANSWERED, UNDER_REVIEW, BANNED, DELETED, DISABLED |
| sort_fields | string | Non | Comma-separated sort fields among item_id, seller_id, from_id and date_created. |
| sort_types | string | Non | Direction of sort_fields.Valeurs : ASC, DESC |
| api_version | string | Non | Send 4: it is the response structure, with questions, answer and from, that the other fields describe.Valeurs : 4 |
| offset | integer | Non | Results to skip. |
| limit | integer | Non | Results per page, 50 by default. |
Connexions possibles
Votre client connecte son compte Mercado Livre une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/mercado_livre, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/mercado_livre_search_questions. Il devient la définition de tool de votre agent sans conversion.
Autres tools Mercado Livre
- Obtenir l'utilisateur actuelGETRenvoie le compte vendeur connecté : id, nickname, email, site_id et réputation du vendeur. L'id est le user_id, seller et seller_id des autres outils, et le site_id (MLB au Brésil) va dans Rechercher des catégories.
- Rechercher des annoncesGETListe les ids des annonces du vendeur, 50 par page par défaut. results ne contient que des ids d'annonces : Lister les annonces renvoie leurs détails. Paginez avec offset et limit ; au-delà de 1000 résultats, utilisez search_type scan et le scroll_id de chaque réponse.
- Lister les annoncesGETRenvoie jusqu'à 20 annonces par id en un appel : titre, prix, available_quantity, sold_quantity, status, permalink, images et attributs. Chaque élément contient status_code, id et l'annonce dans body.
- Rechercher des catégoriesGETPrédit la catégorie d'un produit à partir de son titre, avec le domaine et les attributs reconnus dans le texte. Le premier résultat est le plus probable. Son category_id va dans Créer une annonce et dans Lister les attributs de la catégorie.
- Lister les attributs de la catégorieGETListe les attributs d'une catégorie avec id, value_type, valeurs acceptées et tags. Les attributs avec la tag required doivent être envoyés dans Créer une annonce, et ceux en new_required quand l'article est neuf.
- Créer une annoncePOSTPublie une annonce et la renvoie avec son id. Dans le modèle User Products, actif pour tous les vendeurs, envoyez family_name et aucun title : Mercado Livre construit le titre. La description s'ajoute ensuite avec Créer la description de l'annonce.
- Mettre à jour une annoncePUTModifie une annonce et la renvoie. Seuls les champs envoyés changent. status paused la masque, active la réactive et closed la termine définitivement. title et family_name ne changent que tant que l'annonce n'a aucune vente.
- Obtenir la description de l'annonceGETRenvoie la description d'une annonce en plain_text, avec date_created et last_updated.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
