Rechercher des catégories avec l'API Mercado Livre
Pré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.
- Identifiant
- mercado_livre_search_categories
L'appel
POST https://connect.reportei.com/api/tools/mercado_livre_search_categories/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"site_id": "<site_id>",
"q": "<q>"
}
}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 |
|---|---|---|---|
| site_id | string | Oui | Site of the account, MLB in Brazil: the site_id of Get current user. |
| q | string | Oui | Product title, written in the language of the site. |
| limit | integer | Non | Suggestions to return, 4 by default and up to 8. |
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_categories. 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.
- 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.
- Créer la description de l'annoncePOSTAjoute la description à une annonce qui n'en a pas, comme une annonce tout juste créée avec Créer une annonce. Échoue avec 400 quand une description existe déjà : utilisez Mettre à jour la description de l'annonce.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
