### Get Lead Details (Example) Source: https://developers.mercadolibre.com.ar/es_ar/persona-interesadas An example of a GET request to the lead details endpoint with a specific lead ID. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \ https://api.mercadolibre.com/leads/3f2dedf2-dfbd-4981-a726-40b13aa172ff/details ``` -------------------------------- ### Example API Call to Consult Offers Source: https://developers.mercadolibre.com.ar/es_ar/central-de-promociones?nocache=true Example of a GET request to the /seller-promotions/offers endpoint with a specific offer ID. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/offers/OFFER-MLB1970246686-42701792?app_version=v2 ``` -------------------------------- ### Example: Create Men's Footwear Size Guide (MLA) Source: https://developers.mercadolibre.com.ar/es_ar/guias-de-talles?nocache=true This example demonstrates creating a custom size guide for men's footwear in the 'SNEAKERS' domain for the 'MLA' site. It specifies 'US_SIZE' as the main attribute and includes measurements for sizes 40 to 42. ```bash curl -X POST 'https://api.mercadolibre.com/catalog/charts' -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' --data-raw '{ "names": { "MLA": "Guía de talles de calzado de hombre" }, "domain_id": "SNEAKERS", "site_id": "MLA", "main_attribute": { "attributes": [ { "site_id": "MLA", "id": "M_US_SIZE" } ] }, "attributes": [ { "id": "GENDER", "values": [ { "id": "339666", "name": "Hombre" } ] } ], "rows": [ { "attributes": [ { "id": "AR_SIZE", "values": [ { "name": "40 AR" } ] }, { "id": "M_US_SIZE", "values": [ { "name": "8,5 US" } ] }, { "id": "FOOT_LENGTH", "values": [ { "name": "10 cm" } ] } ] }, { "attributes": [ { "id": "AR_SIZE", "values": [ { "name": "41 AR" } ] }, { "id": "M_US_SIZE", "values": [ { "name": "9 US" } ] }, { "id": "FOOT_LENGTH", "values": [ { "name": "15 cm" } ] } ] }, { "attributes": [ { "id": "AR_SIZE", "values": [ { "name": "42 AR" } ] }, { "id": "M_US_SIZE", "values": [ { "name": "9,5 US" } ] }, { "id": "FOOT_LENGTH", "values": [ { "name": "20 cm" } ] } ] } ] }' ``` -------------------------------- ### Get Application Response Example Source: https://developers.mercadolibre.com.ar/es_ar/gestiona-tus-aplicaciones Example response structure when fetching application details. ```json { "id": 213123928883922, "site_id": "MLB", "thumbnail": null, "url": "http://apps.mercadolivre.com.br/polipartes", "sandbox_mode": true, "project_id":null, "active": true, "max_requests_per_hour": 18000, "certification_status": "not_certified" } ``` -------------------------------- ### Create Size Guide Response Source: https://developers.mercadolibre.com.ar/es_ar/guias-de-talles Example JSON response confirming the creation of a size guide. It includes the guide's ID, name, domain, site, main attribute, and a list of attributes with their respective values. ```json { "id": "515255", "names": { "MLA": "Guia de tallas lista-multivalued pants test" }, "domain_id": "PANTS_TEST", "site_id": "MLA", "type": "SPECIFIC", "seller_id": 1108966308, "main_attribute_id": "SIZE", "attributes": [ { "id": "GENDER", "name": "Género", "values": [ { "name": "Hombre" } ] } ], "rows": [ { "id": "515255:1", "attributes": [ { "id": "SIZE", "name": "Talle", "values": [ { "name": "Small" } ] }, { "id": "SIZE", "name": "Talla de la etiqueta", "values": [ { "name": "Small" } ] }, { "id": "PANTS_TEST_FILTRABLE_SIZES", "name": "Talle estándar", "values": [ { "id": "4147746", "name": "26" }, { "id": "3259523", "name": "27" }, { "id": "3259504", "name": "28" }, { "id": "3259505", "name": "29" }, { "id": "3259506", "name": "30" } ] }, { "id": "WAIST_CIRCUMFERENCE_FROM", ``` -------------------------------- ### Example Query for Stock Details Source: https://developers.mercadolibre.com.ar/es_ar/stock-multi-origen An example of the GET request to query stock details, substituting the placeholder with an actual 'user_product_id'. ```curl curl -X GET https://api.mercadolibre.com/user-products/MLMU123456789/stock -H 'Authorization: Bearer $ACCESS_TOKEN' ``` -------------------------------- ### Example API Call to Consult Candidate Items Source: https://developers.mercadolibre.com.ar/es_ar/central-de-promociones?nocache=true Example of a GET request to the /seller-promotions/candidates endpoint with a specific candidate ID. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/candidates/CANDIDATE-MLB1254949426-803130663?app_version=v2 ``` -------------------------------- ### Create Custom Size Guide with Measurement Ranges Source: https://developers.mercadolibre.com.ar/es_ar/guias-de-talles Use this example to create a custom size guide by defining measurement ranges for product attributes. Ensure all required attributes and their corresponding values are correctly structured. ```json { "id": "463005:1", "attributes": [ { "id": "SIZE", "name": "Talle", "values": [ { "name": "8 US", "struct": { "number": 8.0, "unit": "US" } } ] }, { "id": "FOOT_LENGTH", "name": "Largo del pie", "values": [ { "name": "10 cm", "struct": { "number": 10.0, "unit": "cm" } } ] }, { "id": "AR_SIZE", "name": "AR", "values": [ { "name": "40 AR", "struct": { "number": 40.0, "unit": "AR" } } ] }, { "id": "M_US_SIZE", "name": "US-M", "values": [ { "name": "8,5 US", "struct": { "number": 8.5, "unit": "US" } } ] } ] } ``` ```json { "id": "463005:2", "attributes": [ { "id": "SIZE", "name": "Talle", "values": [ { "name": "9 US", "struct": { "number": 9.0, "unit": "US" } } ] }, { "id": "FOOT_LENGTH", "name": "Largo del pie", "values": [ { "name": "15 cm", "struct": { "number": 15.0, "unit": "cm" } } ] }, { "id": "AR_SIZE", "name": "AR", "values": [ { "name": "41 AR", "struct": { "number": 41.0, "unit": "AR" } } ] }, { "id": "M_US_SIZE", "name": "US-M", "values": [ { "name": "9 US", "struct": { "number": 9.0, "unit": "US" } } ] } ] } ``` ```json { "id": "463005:3", "attributes": [ { "id": "SIZE", "name": "Talle", "values": [ { "name": "9,5 US", "struct": { "number": 9.5, "unit": "US" } } ] }, { "id": "FOOT_LENGTH", "name": "Largo del pie", "values": [ { "name": "20 cm", "struct": { "number": 20.0, "unit": "cm" } } ] }, { "id": "AR_SIZE", "name": "AR", "values": [ { "name": "42 AR", "struct": { "number": 42.0, "unit": "AR" } } ] }, { "id": "M_US_SIZE", "name": "US-M", "values": [ { "name": "9,5 US", "struct": { "number": 9.5, "unit": "US" } } ] } ] } ``` -------------------------------- ### Get User Product Stock Details (Example) Source: https://developers.mercadolibre.com.ar/es_ar/stock-distribuido An example of the GET request to retrieve stock details for a User Product, using a placeholder ID. Replace $ACCESS_TOKEN with your valid token. ```curl curl -X GET https://api.mercadolibre.com/user-products/MLAU123456789/stock -H 'Authorization: Bearer $ACCESS_TOKEN' ``` -------------------------------- ### Example API Call for Interested Buyers Source: https://developers.mercadolibre.com.ar/es_ar/persona-interesadas An example of how to call the API to get interested buyers, specifying user ID, pagination, date range, and contact types like credit, question, and WhatsApp. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/vis/users/3052668868/leads/buyers?offset=0&limit=10&date_from=2026-01-15&date_to=2026-01-22&contac_types=credit,question,whatsapp ``` -------------------------------- ### Example API Call to Get Item Details Source: https://developers.mercadolibre.com.ar/es_ar/automatizaciones-de-precios This is a concrete example of the cURL command to fetch information for a specific item. The response will indicate if price automation is active. ```bash curl --location --request GET \ 'https://api.mercadolibre.com/items/MLB6713483676' \ --header 'Authorization: Bearer $ACCESS_TOKEN' ``` -------------------------------- ### Associate Size Guide to Publication (With Variations) Source: https://developers.mercadolibre.com.ar/es_ar/guias-de-talles This example demonstrates how to associate a size guide to a publication that includes variations. The SIZE_GRID_ROW_ID attribute is applied to each variation's attributes. ```curl curl -L -X POST 'https://api.mercadolibre.com/items' -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d '{ "title": "Tênis Unissex Eros Olympikus Test No Ofertar", "category_id": "MLB23332", "price": 349.9, "currency_id": "BRL", "available_quantity": 6, "buying_mode": "buy_it_now", "condition": "new", "listing_type_id": "gold_special", "pictures": [ { "source": "http://http2.mlstatic.com/D_686163-MLB51823676081_102022-O.jpg" }, { "source": "http://http2.mlstatic.com/D_945109-MLB51823569653_102022-O.jpg" } ], "attributes": [ { "id": "BRAND", "value_name": "Olympikus" }, { "id": "GENDER", "value_name": "Homem" }, { "id": "MODEL", "value_name": "EROS" }, { "id": "SIZE_GRID_ID", "value_name": "210058" } ], "variations": [ { "available_quantity": 5, "price": 349.9, "attribute_combinations": [ { "id": "COLOR", "value_name": "BRANCO-SAFFRON" }, { "id": "SIZE", "value_name": "36 BR" } ], "picture_ids": [ "https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670601935.jpg", "https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670605879.jpg", "https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670608926.jpg", ``` -------------------------------- ### Get Existing Price Automation Example Source: https://developers.mercadolibre.com.ar/es_ar/automatizaciones-de-precios Example of a GET request to retrieve the price automation details for item ID MLA12345678. ```curl curl -X GET -H "Authorization: Bearer $ACCESS_TOKEN" https://api.mercadolibre.com/pricing-automation/items/MLA12345678/automation ``` -------------------------------- ### Get User Products for a Family (Example) Source: https://developers.mercadolibre.com.ar/es_ar/precio-variacion Example of a GET request to retrieve user products for a specific family ID ('9871232123') on the MLA site. ```curl curl -X GET https://api.mercadolibre.com/sites/MLA/user-products-families/9871232123 -H 'Authorization: Bearer $ACCESS_TOKEN' ``` -------------------------------- ### Create SPONTH Campaign (Buy 2, Get 50% Off 2nd, Allow Combinations) Source: https://developers.mercadolibre.com.ar/es_ar/campanas-con-descuento-por-cantidad Use this example to create a 'Save P% on the Nth' campaign. Set 'allow_combination' to true to enable mixing different items for this specific discount. ```bash curl -X POST -H https://api.mercadolibre.com/seller-promotions/promotions?app_version=v2&version=test \ --header 'Content-Type: application/json' \ --header 'Authorization: ••••••' \ --data '{ \ "promotion_type": "VOLUME", \ "sub_type": "SPONTH", \ "buy_quantity": 2, \ "discount_percentage": 50, \ "allow_combination": true, \ "name": "DxV teste SPONTH", \ "start_date": "2024-08-29T00:00:00", \ "finish_date": "2024-09-29T00:00:00" \ }' ``` -------------------------------- ### Get Product Prices - Example Call Source: https://developers.mercadolibre.com.ar/es_ar/api-de-precios An example of how to call the API to get prices for a specific item ID (MLM237323192). Replace $ACCESS_TOKEN with your valid token. ```curl curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM237323192/prices ``` -------------------------------- ### Create BNSP Campaign (Buy 5, Get 30% Off, No Combinations) Source: https://developers.mercadolibre.com.ar/es_ar/campanas-con-descuento-por-cantidad This example demonstrates creating a 'Buy N Save P%' campaign. Set 'allow_combination' to false to ensure the discount applies only when purchasing the same item multiple times. ```bash curl -X POST -H https://api.mercadolibre.com/seller-promotions/promotions?app_version=v2&version=test \ --header 'Content-Type: application/json' \ --header 'Authorization: ••••••' \ --data '{ \ "promotion_type": "VOLUME", \ "sub_type": "BNSP", \ "buy_quantity": 5, \ "discount_percentage": 30, \ "allow_combination": false, \ "name": "DxV teste BNSP", \ "start_date": "2024-08-29T00:00:00", \ "finish_date": "2024-09-29T00:00:00" \ }' ``` -------------------------------- ### Example: Get Specific Campaign Metrics Source: https://developers.mercadolibre.com.ar/es_ar/ads-bads This example shows how to call the API to get metrics for a campaign within a specific date range. Replace placeholders with your actual IDs and token. ```curl curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/advertising/advertisers/10101010/brand_ads/campaigns/123456/metrics?date_from=2025-05-01&date_to=2025-05-05 ``` -------------------------------- ### Create BNGM Campaign (Buy 3, Pay 2, Allow Combinations) Source: https://developers.mercadolibre.com.ar/es_ar/campanas-con-descuento-por-cantidad Use this example to create a 'Buy N Get M' campaign where customers buy a certain quantity and pay for a lesser quantity. Set 'allow_combination' to true to permit mixing different items for the discount. ```bash curl -X POST -H https://api.mercadolibre.com/seller-promotions/promotions?app_version=v2 \ --header 'Content-Type: application/json' \ --header 'Authorization: ••••••' \ --data '{ \ "promotion_type": "VOLUME", \ "sub_type": "BNGM", \ "buy_quantity": 3, \ "pay_quantity": 2, \ "allow_combination": true, \ "name": "DxV teste BNGM", \ "start_date": "2024-08-29T00:00:00", \ "finish_date": "2024-09-29T00:00:00" \ }' ``` -------------------------------- ### List User Product Compatibilities Source: https://developers.mercadolibre.com.ar/es_ar/compatibilidades-entre-items-y-productos Use the /user-products/{user_product_id}/compatibilities endpoint to list compatibilities for a user's product. Include 'main_domain_id' and set 'extended=true' for full details. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/user-products/&USER_PRODUCT_ID/compatibilities?main_domain_id=MLM-CARS_AND_VANS_FOR_COMPATIBILITIES&extended=true ``` ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/user-products/MLMU427597763/compatibilities?main_domain_id=MLM-CARS_AND_VANS_FOR_COMPATIBILITIES&extended=true ``` -------------------------------- ### Example API Request for Missed Feeds Source: https://developers.mercadolibre.com.ar/es_ar/productos-recibe-notificaciones?nocache=true An example of a GET request to the missed_feeds endpoint, including a specific application ID. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/missed_feeds?app_id=3486171129139063 ``` -------------------------------- ### Consultar Tiempo de Ventana de Contactos para Múltiples Publicaciones Source: https://developers.mercadolibre.com.ar/es_ar/vehiculos-gestiona-preguntas-y-contactos Utiliza este endpoint para obtener el tiempo de ventana de contactos de WhatsApp para una lista de IDs de publicaciones. Asegúrate de proporcionar los IDs, la unidad de tiempo y la cantidad de tiempo atrás a cubrir. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/contacts/whatsapp/time_window?ids=$IDS&unit=$UNIT&last=$LAST&ending=$ENDING ``` -------------------------------- ### Example Item Promotions API Call Source: https://developers.mercadolibre.com.ar/es_ar/central-de-promociones An example of the GET request to consult promotions for a specific item ID (MLA1658866847). ```bash curl -X GET -H "Authorization: Bearer $ACCESS_TOKEN" https://api.mercadolibre.com/seller-promotions/items/MLA1658866847?app_version=v2 ``` -------------------------------- ### Get Item Sale Price with Net Taxes (Example Call) Source: https://developers.mercadolibre.com.ar/es_ar/precios-netos This example demonstrates how to call the API to get the net sale price for a specific item, quantity, and destination. Ensure you replace placeholders like $ITEM_ID, $BUYER_ID, and $ACCESS_TOKEN with actual values. ```curl curl -L -X GET 'https://api.mercadolibre.com/items/$ITEM_ID/sale_price?context=channel_marketplace,user_type_business&quantity=6&destination_states=BR-SP&buyer_id=$BUYER_ID' \ -H 'Authorization: Bearer $ACCESS_TOKEN' \ -H 'x-calculate-net-taxes: true' ``` ```curl curl -L -X GET 'https://api.mercadolibre.com/items/MLB5586809854/sale_price?context=channel_marketplace,user_type_business&quantity=6&destination_states=BR-SP&buyer_id=655590662' \ -H 'Authorization: Bearer $ACCESS_TOKEN' \ -H 'x-calculate-net-taxes: true' ``` -------------------------------- ### Example: Get MLA12345 Category Attributes Source: https://developers.mercadolibre.com.ar/es_ar/referencias-de-dominios-productos-y-atributos-para-autopartes?nocache=true This example demonstrates how to fetch attributes for a specific category, identified by 'MLA12345', using the categories API. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA12345/attributes ``` -------------------------------- ### Example: Get MLA-CARS_AND_VANS Domain Attributes Source: https://developers.mercadolibre.com.ar/es_ar/referencias-de-dominios-productos-y-atributos-para-autopartes?nocache=true This example shows how to specifically query for the attributes of the 'MLA-CARS_AND_VANS' domain using the catalog domains API. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS ``` -------------------------------- ### Consultar dominios y categorías compatibles Source: https://developers.mercadolibre.com.ar/es_ar/compatibilidades-entre-items-y-productos Utiliza este endpoint para obtener el listado de dominios y categorías compatibles para un sitio específico. La respuesta incluye información sobre si las compatibilidades son requeridas y qué tipos de compatibilidad son admitidos. ```bash curl -X GET http://api.mercadolibre.com/catalog/dumps/domains/$SITE_ID/compatibilities ``` ```bash curl -X GET https://api.mercadolibre.com/catalog/dumps/domains/MLB/compatibilities ``` -------------------------------- ### Create Size Guide API Request Source: https://developers.mercadolibre.com.ar/es_ar/guias-de-talles Use this `curl` command to create a new size guide for a specific domain and site. Ensure you replace `$ACCESS_TOKEN` with your valid authentication token. ```bash curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d { "names": { "MLA": "Guia de test para rangos niños" }, "domain_id": "SNEAKERS_TEST", "site_id": "MLA", "attributes": [ { "id": "GENDER", "values": [ { "id": "339667", "name": "Niños" } ] } ], "main_attribute": { "attributes": [ { "site_id": "MLA", "id": "MANUFACTURER_SIZE" } ] }, "rows": [ { "attributes": [ { "id": "MANUFACTURER_SIZE", "values": [ { "name": "3 US" } ] }, { "id": "FOOT_LENGTH", "values": [ { "name": "10 cm" } ] }, { "id": "FOOT_LENGTH_TO", "values": [ { "name": "13 cm" } ] } ] }, { "attributes": [ { "id": "MANUFACTURER_SIZE", "values": [ { "name": "4 US" } ] }, { "id": "FOOT_LENGTH", "values": [ { "name": "15 cm" } ] }, { "id": "FOOT_LENGTH_TO", "values": [ { "name": "20 cm" } ] } ] } ] }' https://api.mercadolibre.com/catalog/charts ``` -------------------------------- ### Example Query for Blocked Messages Source: https://developers.mercadolibre.com.ar/es_ar/mensajes-bloqueados An example of a GET request to the blocked messages endpoint, demonstrating the expected URL structure with specific IDs. ```curl curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/messages/packs/22175467/sellers/32086568493?tag=post_sale ``` -------------------------------- ### Consultar Tipos de Listado Disponibles por Categoría Source: https://developers.mercadolibre.com.ar/es_ar/usuarios-y-aplicaciones Verifica si un tipo de listado específico está disponible para un usuario en una categoría dada. Puede fallar si el usuario no tiene permisos. ```bash $ curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/206946886/available_listing_type/gold_special?category_id=MLA6602 ``` -------------------------------- ### Associate Size Guide to Publication (No Variations) Source: https://developers.mercadolibre.com.ar/es_ar/guias-de-talles This example shows how to associate a size guide to a publication that does not have variations. The SIZE_GRID_ROW_ID attribute is applied at the publication level. ```APIDOC ## POST /items ### Description Associates a size guide to a publication. ### Method POST ### Endpoint https://api.mercadolibre.com/items ### Request Body - **title** (string) - Required - The title of the item. - **pictures** (array) - Required - A list of pictures for the item. - **price** (number) - Required - The price of the item. - **currency_id** (string) - Required - The currency of the price. - **available_quantity** (integer) - Required - The available quantity of the item. - **catalog_listing** (boolean) - Required - Whether the item is a catalog listing. - **attributes** (array) - Required - A list of attributes for the item. This should include: - **SIZE_GRID_ID** (object) - Required - The ID of the size grid. - **SIZE_GRID_ROW_ID** (object) - Required - The ID of the row within the size grid. - **catalog_product_id** (string) - Required - The catalog product ID. - **category_id** (string) - Required - The category ID. - **listing_type_id** (string) - Required - The listing type ID. ### Request Example ```curl curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d '{ "title": "ITEM DE TEST MODA - NO OFERTAR", "pictures": [ { "secure_url": "https://http2.mlstatic.com/D_783501-MLB20327737026_062015-O.jpg", "url": "http://http2.mlstatic.com/D_783501-MLB20327737026_062015-O.jpg", "quality": "", "id": "783501-MLB20327737026_062015" } ], "price": 30000, "currency_id": "ARS", "available_quantity": 5, "catalog_listing": false, "attributes": [ { "id": "ITEM_CONDITION", "value_id": "2230284" }, { "id": "BRAND", "value_id": "14671", "value_name" : "Nike" }, { "id": "LINE", "value_id": "289533", "value_name": "Air Max" }, { "id": "MODEL", "value_id": "27030", "value_name": "AP" }, { "id": "GENDER", "value_id": "339665", "value_name": "Mujer" }, { "id": "AGE_GROUP", "value_id": "6725189", "value_name": "Adultos" }, { "id": "SIZE_GRID_ID", "value_id": "11273930", "value_name":"26008" }, { "id": "STYLE", "value_id": "6694772", "value_name": "Deportivo" }, { "id": "RECOMMENDED_SPORTS", "value_id": "6694768", "value_name": "Running" }, { "id": "EXTERIOR_MATERIALS", "value_id": "5017538", "value_name": "Cuero sintético" }, { "id": "OUTSOLE_MATERIALS", "value_id": "930364", "value_name": "Goma" }, { "id": "FOOTWEAR_TECHNOLOGIES", "value_id": "8668190", "value_name": "Air" }, { "id": "FOOTWEAR_TYPE", "value_id": "517583", "value_name": "Zapatilla" }, { "id": "COLOR", "value_id": null, "value_name": "Blanco/Blanco/Platino metalizado/Platino puro" }, { "id": "SIZE_GRID_ROW_ID", "value_id": "11286240", "value_name": "26008:1" } ], "catalog_product_id": "MLA18565233", "category_id": "MLA455855", "listing_type_id": "gold_pro" }' https://api.mercadolibre.com/items ``` ``` -------------------------------- ### Create Custom Size Guide Source: https://developers.mercadolibre.com.ar/es_ar/guias-de-talles Use this endpoint to create a custom size guide. Ensure all attributes sent are present in the technical data sheet to avoid errors. Required attributes must be sent at the general level, while specific attributes for rows need to include required ones and at least one main candidate. ```bash curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...} https://api.mercadolibre.com/catalog/charts ``` ```bash curl -X POST 'https://api.mercadolibre.com/catalog/charts' -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' --data-raw '{ "names": { "MLA": "Guía de talles de calzado de hombre" }, "domain_id": "SNEAKERS", "site_id": "MLA", "main_attribute": { "attributes": [ { "site_id": "MLA", "id": "M_US_SIZE" } ] }, "attributes": [ { "id": "GENDER", "values": [ { "id": "339666", "name": "Hombre" } ] } ], "rows": [ { "attributes": [ { "id": "AR_SIZE", "values": [ { "name": "40 AR" } ] }, { "id": "M_US_SIZE", "values": [ { "name": "8,5 US" } ] }, { "id": "FOOT_LENGTH", "values": [ { "name": "10 cm" } ] } ] }, { "attributes": [ { "id": "AR_SIZE", "values": [ { "name": "41 AR" } ] }, { "id": "M_US_SIZE", "values": [ { "name": "9 US" } ] }, { "id": "FOOT_LENGTH", "values": [ { "name": "15 cm" } ] } ] }, { "attributes": [ { "id": "AR_SIZE", "values": [ { "name": "42 AR" } ] }, { "id": "M_US_SIZE", "values": [ { "name": "9,5 US" } ] }, { "id": "FOOT_LENGTH", "values": [ { "name": "20 cm" } ] } ] } ] }' ``` -------------------------------- ### Associate Size Guide to Publication (No Variations) Source: https://developers.mercadolibre.com.ar/es_ar/guias-de-talles Use this example to associate a size guide to a publication that does not have variations. The SIZE_GRID_ROW_ID attribute is set at the publication level. ```curl curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d '{ "title": "ITEM DE TEST MODA - NO OFERTAR", "pictures": [ { "secure_url": "https://http2.mlstatic.com/D_783501-MLB20327737026_062015-O.jpg", "url": "http://http2.mlstatic.com/D_783501-MLB20327737026_062015-O.jpg", "quality": "", "id": "783501-MLB20327737026_062015" } ], "price": 30000, "currency_id": "ARS", "available_quantity": 5, "catalog_listing": false, "attributes": [ { "id": "ITEM_CONDITION", "value_id": "2230284" }, { "id": "BRAND", "value_id": "14671", "value_name" : "Nike" }, { "id": "LINE", "value_id": "289533", "value_name": "Air Max" }, { "id": "MODEL", "value_id": "27030", "value_name": "AP" }, { "id": "GENDER", "value_id": "339665", "value_name": "Mujer" }, { "id": "AGE_GROUP", "value_id": "6725189", "value_name": "Adultos" }, { "id": "SIZE_GRID_ID", "value_id": "11273930", "value_name":"26008" }, { "id": "STYLE", "value_id": "6694772", "value_name": "Deportivo" }, { "id": "RECOMMENDED_SPORTS", "value_id": "6694768", "value_name": "Running" }, { "id": "EXTERIOR_MATERIALS", "value_id": "5017538", "value_name": "Cuero sintético" }, { "id": "OUTSOLE_MATERIALS", "value_id": "930364", "value_name": "Goma" }, { "id": "FOOTWEAR_TECHNOLOGIES", "value_id": "8668190", "value_name": "Air" }, { "id": "FOOTWEAR_TYPE", "value_id": "517583", "value_name": "Zapatilla" }, { "id": "COLOR", "value_id": null, "value_name": "Blanco/Blanco/Platino metalizado/Platino puro" }, { "id": "SIZE_GRID_ROW_ID", "value_id": "11286240", "value_name": "26008:1" } ], "catalog_product_id": "MLA18565233", "category_id": "MLA455855", "listing_type_id": "gold_pro" }' https://api.mercadolibre.com/items ``` -------------------------------- ### Consultar paquetes de publicaciones contratados por un usuario Source: https://developers.mercadolibre.com.ar/es_ar/vehiculos-gestiona-paquetes Este endpoint permite verificar los paquetes de publicaciones que un cliente ha contratado y la cantidad de anuncios disponibles en cada uno. Se requiere el ID del usuario y el tipo de contenido del paquete. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs?package_content=$PACKAGE_CONTENT; ``` ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/135146148/classifieds_promotion_packs?package_content=ALL; ``` -------------------------------- ### Item Creation Response Example Source: https://developers.mercadolibre.com.ar/es_ar/precio-variacion This is an example of the JSON response received after successfully creating an item, showing details like ID, price, and title. ```json { "id": "MLM2061397137", "site_id": "MLM", "title": "Apple iPhone 256GB Rojo", "family_name": "Apple iPhone 256GB", "seller_id": 1008002397, "category_id": "MLM1055", "user_product_id": "MLMU367467963", "official_store_id": null, "price": 19800, "base_price": 19800, "original_price": null, "inventory_id": null, "currency_id": "MXN", "initial_quantity": 8, "available_quantity": 8, "sold_quantity": 0, "sale_terms": [ … ], "buying_mode": "buy_it_now", "listing_type_id": "gold_special", "start_time": "2024-05-07T12:57:08.016Z", "stop_time": "2044-05-02T04:00:00.000Z", "end_time": "2044-05-02T04:00:00.000Z", "expiration_time": "2024-07-26T12:57:08.119Z", "condition": "new", "permalink": "http://articulo.mercadolibre.com.mx/MLM-2061397137-apple-iphone-15-256-gb-rojo-_JM", /*el permalink va a redirigir al UPP del item*/ "pictures": [ … ], "video_id": null, "descriptions": [] } ``` -------------------------------- ### Associate Size Guide to Publication (With Variations) Source: https://developers.mercadolibre.com.ar/es_ar/guias-de-talles This example demonstrates how to associate a size guide to a publication that includes variations. The SIZE_GRID_ROW_ID attribute is applied at the variation level. ```APIDOC ## POST /items ### Description Associates a size guide to a publication with variations. ### Method POST ### Endpoint https://api.mercadolibre.com/items ### Request Body - **title** (string) - Required - The title of the item. - **category_id** (string) - Required - The category ID. - **price** (number) - Required - The price of the item. - **currency_id** (string) - Required - The currency of the price. - **available_quantity** (integer) - Required - The available quantity of the item. - **buying_mode** (string) - Required - The buying mode of the item. - **condition** (string) - Required - The condition of the item. - **listing_type_id** (string) - Required - The listing type ID. - **pictures** (array) - Required - A list of pictures for the item. - **attributes** (array) - Required - A list of general attributes for the item. This should include: - **SIZE_GRID_ID** (object) - Required - The ID of the size grid. - **variations** (array) - Required - A list of variations for the item. Each variation should include: - **available_quantity** (integer) - Required - The available quantity for this variation. - **price** (number) - Required - The price for this variation. - **attribute_combinations** (array) - Required - Combinations of attributes for this variation (e.g., COLOR, SIZE). - **picture_ids** (array) - Optional - Picture IDs specific to this variation. ### Request Example ```curl curl -L -X POST 'https://api.mercadolibre.com/items' -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d '{ "title": "Tênis Unissex Eros Olympikus Test No Ofertar", "category_id": "MLB23332", "price": 349.9, "currency_id": "BRL", "available_quantity": 6, "buying_mode": "buy_it_now", "condition": "new", "listing_type_id": "gold_special", "pictures": [ { "source": "http://http2.mlstatic.com/D_686163-MLB51823676081_102022-O.jpg" }, { "source": "http://http2.mlstatic.com/D_945109-MLB51823569653_102022-O.jpg" } ], "attributes": [ { "id": "BRAND", "value_name": "Olympikus" }, { "id": "GENDER", "value_name": "Homem" }, { "id": "MODEL", "value_name": "EROS" }, { "id": "SIZE_GRID_ID", "value_name": "210058" } ], "variations": [ { "available_quantity": 5, "price": 349.9, "attribute_combinations": [ { "id": "COLOR", "value_name": "BRANCO-SAFFRON" }, { "id": "SIZE", "value_name": "36 BR" } ], "picture_ids": [ "https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670601935.jpg", "https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670605879.jpg", "https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670608926.jpg" ] } ] }' https://api.mercadolibre.com/items ``` ```