### Retrieve Display Campaign Metrics (Example) Source: https://developers.mercadolivre.com.br/pt_br/display-ads This example demonstrates how to call the API to get metrics for a campaign between April 1st and April 15th, 2024. Replace $ACCESS_TOKEN with your valid authentication token. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Api-Version: 1" https://api.mercadolibre.com/advertising/advertisers/11111/display/campaigns/80/metrics?date_from=2024-04-01&date_to=2024-04-15 ``` -------------------------------- ### Example Get Product Suggestion Source: https://developers.mercadolivre.com.br/pt_br/brand-central An example of how to call the API to get details for a specific product suggestion, identified by its ID (e.g., 123456). ```curl curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_suggestions/123456 ``` -------------------------------- ### Get Shippability Services - Example Call with Legacy Attributes Source: https://developers.mercadolivre.com.br/pt_br/mercado-envios This example demonstrates calling the shippability services endpoint with the legacy_attributes parameter set to true. ```bash curl -X GET 'https://api.mercadolibre.com/customers/marketplace/sites/MLA/user-products/MLAU1234567890/contracts/shippability/services?legacy_attributes=true' -H 'Content-Type: application/json' -H 'Accept: application/json' ``` -------------------------------- ### Get Available Listing Type by Category (Example) Source: https://developers.mercadolivre.com.br/pt_br/usuarios-e-aplicativos Example of how to call the API to get available listing types for a specific user and category. This endpoint checks if a user is allowed to use a particular listing type within a given category. ```bash $ curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/206946886/available_listing_type/gold_special?category_id=MLA6602 ``` -------------------------------- ### Example: Get Questions by Time Window for an Item Source: https://developers.mercadolivre.com.br/pt_br/automovel-gerenciamento-de-contatos An example request to retrieve questions for a specific item over the last 2 hours. ```curl curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour ``` -------------------------------- ### Query User Products by Family ID (Example) Source: https://developers.mercadolivre.com.br/pt_br/preco-variacao This example demonstrates how to retrieve user products associated with a specific family using a GET request to the Mercado Livre API. Ensure you include your authorization token. ```curl curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/user-products-families/$FAMILY_ID -H 'Authorization: Bearer $ACCESS_TOKEN' ``` -------------------------------- ### Indicate Item for Campaign Example Source: https://developers.mercadolivre.com.br/pt_br/campanha-com-co-participacao Specific example of how to POST an item to a campaign, using a concrete promotion ID and item ID. ```bash curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \ -d '{ "promotion_id":"P-MLB1806015", "promotion_type":"MARKETPLACE_CAMPAIGN" }' https://api.mercadolibre.com/seller-promotions/items/MLB3293401659?app_version=v2 ``` -------------------------------- ### Get Attachment Information Example (cURL) Source: https://developers.mercadolivre.com.br/pt_br/gerenciar-mensagem-de-uma-eclamacao An example cURL request to get information about a specific attachment, using sample IDs. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/post-purchase/v1/claims/555555555/attachments/exemple.jpg' ``` -------------------------------- ### Example Get Moderations Infractions API Call Source: https://developers.mercadolivre.com.br/pt_br/publicacoes-necessarias-do-catalogo An example of the GET request to retrieve moderation infractions, using a placeholder user ID. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/1234567 ``` -------------------------------- ### Example Search for a Specific User Product Source: https://developers.mercadolivre.com.br/pt_br/preco-variacao This is a concrete example of searching for items belonging to a specific user product ID. Replace the example IDs with your own. ```bash curl -X GET https://api.mercadolibre.com/users/1234/items/search?user_product_id=MLBU206642488 -H 'Authorization: Bearer $ACCESS_TOKEN' ``` -------------------------------- ### Example: Get Total Questions for an Item Source: https://developers.mercadolivre.com.br/pt_br/automovel-gerenciamento-de-contatos An example request to get the total questions for a specific item within a given date range. ```curl curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLV421672596/contacts/questions?date_from=2014-08-01T00:00:00.000-03:00&date_to=2014-08-02T23:59:59.999 ``` -------------------------------- ### API Call Example with Financing Options Source: https://developers.mercadolivre.com.br/pt_br/publicacao-de-automoveis This example demonstrates a complete API call to create an item listing, including the sale_terms attribute to enable financing options. Ensure the 'price' field is always populated. ```bash curl -L -X POST 'https://api.mercadolibre.com/items' \ -H 'Authorization: Bearer $ACCESS_TOKEN' \ -H 'Content-Type: application/json' \ -d '{ "title": "Anuncio Prueba Auto - No Comprar 3", "description": "Veículo em ótimo estado", "channels": [ "marketplace" ], "pictures": [ { "id": "859393-MLB92379478091_092025" } ], "video_id": "sJLCxVgshzY", "category_id": "MLA1744", "price": 18000000, "currency_id": "ARS", "listing_type_id": "silver", "available_quantity": 1, "location": { "address_line": "Solís 2222", "zip_code": "", "neighborhood": { "id": "TUxBQk9MSTgzODNa", "name": "Olivos" }, "city": { "id": "TUxBQ1ZJQ2E3MTQz", "name": "Vicente López" }, "state": { "id": "TUxBUEdSQWU4ZDkz", "name": "Bs.as. G.b.a. Norte" }, "country": { "id": "AR", "name": "Argentina" }, "open_hours": "", "latitude": -34.5101161, "longitude": -58.4765109 }, "sale_terms": [ { "id": "WITH_FINANCING_OPTIONS", "value_id": "242085", "value_name": "Si" } ], "attributes": [ { "id": "BRAND", "value_name": "Citroën" }, { "id": "MODEL", "value_name": "C4 Picasso" }, { "id": "VEHICLE_YEAR", "value_name": "2015" }, { "id": "DOORS", "value_name": "2" }, { "id": "KILOMETERS", "value_name": "92000km" }, { "id": "FUEL_TYPE", "value_name": "Diésel" }, { "id": "COLOR", "value_name": "Rojo" }, { "id": "STEERING", "value_name": "Hidráulica" }, { "id": "TRANSMISSION", "value_name": "Manual" }, { "id": "TRACTION_CONTROL", "value_name": "Delantera" }, { "id": "HAS_ABS_BRAKES", "value_name": "Sí" }, { "id": "HAS_AIR_CONDITIONING", "value_name": "Sí" }, { "id": "HAS_ALARM", "value_name": "Sí" }, { "id": "HAS_ALLOY_WHEELS", "value_name": "Sí" }, { "id": "HAS_AMFM_RADIO", "value_name": "Sí" }, { "id": "HAS_AUXILIARY_PORT", "value_name": "Sí" }, { "id": "ITEM_CONDITION", "value_name": "Usado" }, { "id": "PASSENGER_CAPACITY", "value_name": "7" }, { "id": "TRIM", "value_name": "1.6 Origine Hdi 115cv" }, { "id": "SINGLE_OWNER", "value_name": "Sí" }, { "id": "HAS_WINDSCREEN_WIPER", "value_name": "Sí" }, { "id": "HAS_USB", "value_name": "Sí" }, { "id": "HAS_STEERING_WHEEL_CONTROL", "value_name": "Sí" }, { "id": "HAS_POWER_DOOR_LOCKS", "value_name": "Sí" }, { "id": "HAS_POWER_WINDOWS", "value_name": "Sí" }, { "id": "HAS_RAIN_SENSOR", "value_name": "Sí" }, { "id": "HAS_REAR_FOGLIGHTS", "value_name": "Si" }, { "id": "HAS_HEIGHT_ADJUSTABLE_DRIVER_SEAT", "value_name": "Sí" } ] }' ``` -------------------------------- ### Get Brand Ads Keyword Metrics (Example) Source: https://developers.mercadolivre.com.br/pt_br/ads-brand-ads An example of calling the API to get keyword metrics for a campaign between July 1st and July 10th, 2024. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/advertising/advertisers/101010/brand_ads/campaigns/123456/keywords/metrics?date_from=2024-07-01&date_to=2024-07-10 ``` -------------------------------- ### Response Example for Items with Price Suggestions Source: https://developers.mercadolivre.com.br/pt_br/referencias-de-precos Example response structure for the endpoint that retrieves items with price suggestions for a seller. ```json { "total": 3, "items": [ "MLM2098685855", "MLM3092970874", "MLM2081093293" ] } ``` -------------------------------- ### Get Currencies Example Source: https://developers.mercadolivre.com.br/pt_br/consideracoes-de-design Example of how to retrieve currency information using the API. ```APIDOC ## GET /currencies/:id ### Description Retrieves information about a specific currency. ### Method GET ### Endpoint https://api.mercadolibre.com/currencies/:id ### Parameters #### Path Parameters - **id** (string) - Required - The ISO code of the currency (e.g., ARS). ### Response #### Success Response (200) - **id** (string) - The ISO code of the currency. - **description** (string) - The official name of the currency. - **symbol** (string) - The ISO symbol to represent the currency. - **decimal_places** (integer) - The number of decimal places handled with the currency. ### Request Example ```bash curl -X GET https://api.mercadolibre.com/currencies/ARS ``` ### Response Example ```json { "id": "ARS", "description": "Peso argentino", "symbol": "$", "decimal_places": 2 } ``` ``` -------------------------------- ### Product Search Response Example Source: https://developers.mercadolivre.com.br/pt_br/buscador-de-produtos Example JSON response when searching for a product with the 'q' parameter. It includes details about the search query, pagination, and a list of matching results with their attributes. ```json { "keywords": "Samsung 20 Galaxy S8 64 GB rosa", "paging": { "total": 1, "limit": 10, "offset": 0 }, "results": [ { "id": "MLA16240160", "status": "active", "domain_id": "MLA-CELLPHONES", "settings": { "listing_strategy": "catalog_required" }, "name": "Samsung Galaxy S8 64 GB rosa 4 GB RAM", "main_features": [], "attributes": [ { "id": "BRAND", "name": "Marca", "value_id": "206", "value_name": "Samsung" }, { "id": "LINE", "name": "Línea", "value_id": "249991", "value_name": "Galaxy S" }, { "id": "MODEL", "name": "Modelo", "value_id": "8030", "value_name": "S8" }, { "id": "IS_DUAL_SIM", "name": "Es Dual SIM", "value_id": "242084", "value_name": "No" }, { "id": "COLOR", "name": "Color", "value_id": "51994", "value_name": "Rosa" }, { "id": "INTERNAL_MEMORY", "name": "Memoria interna", "value_id": "59726", "value_name": "64 GB" }, { "id": "RAM", "name": "Memoria RAM", "value_id": "98852", "value_name": "4 GB" }, { "id": "MAIN_COLOR", "name": "Color principal", "value_id": "2450312", "value_name": "Rosa" }, { "id": "GTIN", "name": "Código universal de producto", "value_id": "11069790", "value_name": "08801643066918" }, { "id": "OPERATING_SYSTEM_NAME", "name": "Nombre del sistema operativo", "value_id": "7403813", "value_name": "Android" }, { "id": "OS_ORIGINAL_VERSION", "name": "Versión original del sistema operativo", "value_id": "7199644", "value_name": "7.0 Nougat" }, { "id": "OS_LAST_COMPATIBLE_VERSION", "name": "Última versión compatible del sistema operativo", "value_id": "9123308", "value_name": "10" }, { "id": "DISPLAY_SIZE", "name": "Tamaño de la pantalla", "value_id": "6927988", "value_name": "5.8 \"" }, { "id": "DISPLAY_RESOLUTION", "name": "Resolución de la pantalla", "value_id": "7222492", "value_name": "1440 px x 2960 px" }, { "id": "MAIN_REAR_CAMERA_RESOLUTION", "name": "Resolución de la cámara trasera principal", "value_id": "7199628", "value_name": "12 Mpx" }, { "id": "REAR_CAMERA_RECORDING_RESOLUTION", "name": "Resolución de video de la cámara trasera", "value_id": "7199630", "value_name": "3840 px x 2160 px" }, { "id": "MAIN_FRONT_CAMERA_RESOLUTION", "name": "Resolución de la cámara frontal principal", "value_id": "7207052", "value_name": "8 Mpx" }, { "id": "BATTERY_CAPACITY", "name": "Capacidad de la batería", "value_id": "98435", "value_name": "3000 mAh" }, { "id": "WITH_FINGERPRINT_READER", "name": "Con lector de huella digital", "value_id": "242085", "value_name": "Sí" }, { "id": "SIM_CARD_SLOTS_NUMBER", "name": "Cantidad de ranuras para tarjeta SIM", "value_id": "2087812", "value_name": "1" } ] } ] } ``` -------------------------------- ### GET Brand Ads Campaign Metrics (Example) Source: https://developers.mercadolivre.com.br/pt_br/ads-brand-ads Example of a GET request to retrieve daily metrics for a specific advertiser and date range. Replace placeholders with actual values. ```curl curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/advertising/advertisers/10101010/brand_ads/campaigns/metrics?date_from=2025-04-01&date_to=2025-04-07&aggregation_type=daily ``` -------------------------------- ### Example Catalog Product Creation Response Source: https://developers.mercadolivre.com.br/pt_br/publicacao-no-catalogo This is a sample response received after successfully creating a catalog product listing. It includes details about the item, pricing, shipping, and other relevant metadata. ```json { "id": "MLM1477990462", "site_id": "MLM", "title": "Huawei Y6p Dual Sim 64 Gb Emerald Green 3 Gb Ram", "subtitle": null, "seller_id": 1008002397, "category_id": "MLM1055", "official_store_id": null, "price": 9999, "base_price": 9999, "original_price": null, "inventory_id": null, "currency_id": "MXN", "initial_quantity": 2, "available_quantity": 2, "sold_quantity": 0, "sale_terms": [ { "id": "WARRANTY_TYPE", "name": "Tipo de garantía", "value_id": "2230280", "value_name": "Garantía del vendedor", "value_struct": null, "values": [ { "id": "2230280", "name": "Garantía del vendedor", "struct": null } ] }, { "id": "WARRANTY_TIME", "name": "Tiempo de garantía", "value_id": null, "value_name": "3 meses", "value_struct": { "number": 3, "unit": "meses" }, "values": [ { "id": null, "name": "3 meses", "struct": { "number": 3, "unit": "meses" } } ] } ], "buying_mode": "buy_it_now", "listing_type_id": "gold_special", "start_time": "2022-08-10T16:28:40.141Z", "stop_time": "2042-08-05T04:00:00.000Z", "end_time": "2042-08-05T04:00:00.000Z", "expiration_time": "2022-10-29T16:28:40.255Z", "condition": "new", "permalink": "http://articulo.mercadolibre.com.mx/MLM-1477990462-huawei-y6p-dual-sim-64-gb-emerald-green-3-gb-ram-_JM", "pictures": [ ... ], "video_id": null, "descriptions": [], "accepts_mercadopago": true, "non_mercado_pago_payment_methods": [], "shipping": { "mode": "me2", "local_pick_up": false, "free_shipping": true, "methods": [], "dimensions": null, "tags": [ "mandatory_free_shipping" ], "logistic_type": "drop_off", "store_pick_up": false }, "international_delivery_mode": "none", "seller_address": { ... }, "seller_contact": null, "location": {}, "geolocation": { "latitude": 20.7846638, "longitude": -103.4679048 }, "coverage_areas": [], "attributes": [ ... ], "warnings": [ ... ], "listing_source": "", "variations": [], "thumbnail_id": "753526-MLA49391002480_032022", "thumbnail": "http://mlm-s1-p.mlstatic.com/753526-MLA49391002480_032022-I.jpg", "secure_thumbnail": "https://mlm-s1-p.mlstatic.com/753526-MLA49391002480_032022-I.jpg", "status": "active", "sub_status": [], "tags": [ "cart_eligible", "immediate_payment", "test_item" ], "warranty": "Garantía del vendedor: 3 meses", "catalog_product_id": "MLM15996654", "domain_id": "MLM-CELLPHONES", "seller_custom_field": null, "parent_item_id": null, "differential_pricing": null, "deal_ids": [], "automatic_relist": false, "date_created": "2022-08-10T16:28:40.371Z", "last_updated": "2022-08-10T16:28:40.419Z", "health": null, "catalog_listing": true, "item_relations": [ { "id": "MLM1477978125", "variation_id": 174997747229, "stock_relation": 1 } ], "channels": [ "marketplace" ] } ``` -------------------------------- ### Consulta por Item com Boost Source: https://developers.mercadolivre.com.br/pt_br/campanhas-tradicionais Use este endpoint para consultar detalhes de um item específico, incluindo informações sobre descontos automáticos aplicados pelo Mercado Livre (boost). ```bash GET /seller-promotions/items/$ITEM_ID ``` -------------------------------- ### Example Item Migration Status Request Source: https://developers.mercadolivre.com.br/pt_br/preco-variacao An example of a GET request to check the migration status for item MLA123456. ```bash curl -X GET https://api.mercadolibre.com/items/MLA123456/migration_live_listing? -H 'Authorization: Bearer $ACCESS_TOKEN' ``` -------------------------------- ### Example Request for Failed Return Reasons Source: https://developers.mercadolivre.com.br/pt_br/gerenciar-devolucoes This example shows how to request reasons for a failed seller return, specifying the flow and a claim ID. The response will list available reasons. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \ 'https://api.mercadolibre.com/post-purchase/v1/returns/reasons?flow=seller_return_failed&claim_id=5555555' ``` -------------------------------- ### Example Request for Pricing Automation Source: https://developers.mercadolivre.com.br/pt_br/automatizacoes-de-precos An example of a GET request to the pricing automation endpoint for a specific item ID. ```curl curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/pricing-automation/items/MLA12345678/automation ``` -------------------------------- ### Example Product Search with Product Identifier Source: https://developers.mercadolivre.com.br/pt_br/buscador-de-produtos This example demonstrates a product search using a specific product identifier for the MLA site and active status. Replace placeholder values with actual credentials. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/products/search?status=active&site_id=MLA&product_identifier=0123456789 ``` -------------------------------- ### Example: Total WhatsApp Clicks Per User Source: https://developers.mercadolivre.com.br/pt_br/automovel-gerenciamento-de-contatos An example request to get the total number of WhatsApp clicks for a user. ```curl curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/127232529/contacts/phone_views?date_from=2014-05-28T00:00:00.000-03:00&date_to=2014-05-29T23:59:59.999 ``` -------------------------------- ### Pagination Example Source: https://developers.mercadolivre.com.br/pt_br/consideracoes-de-design Demonstrates how to use limit and offset parameters for paginating results. ```APIDOC ## GET /sites/:site_id/search?q=:query&limit=:limit ### Description Searches for items and allows control over the number of results returned per page using the 'limit' parameter. ### Method GET ### Endpoint https://api.mercadolibre.com/sites/:site_id/search?q=:query&limit=:limit ### Parameters #### Path Parameters - **site_id** (string) - Required - The ID of the site to search within (e.g., MLA). #### Query Parameters - **q** (string) - Required - The search query. - **limit** (integer) - Optional - The maximum number of items to return in the response. Defaults to 50. - **offset** (integer) - Optional - The number of items to skip from the beginning of the result set. Defaults to 0. ### Response #### Success Response (200) - **paging** (object) - Contains pagination details: 'total' (total items matching the query), 'offset' (current offset), and 'limit' (current limit). - **results** (array) - A list of items matching the search query. ### Request Example ```bash curl -X GET https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&limit=3 ``` ### Response Example ```json { "site_id": "MLA", "query": "ipod nano", "paging": { "total": 284, "offset": 0, "limit": 3 }, "results": [ {...}, {...}, {...} ], "sort": {...}, "available_sorts": [...], "filters": [...], "available_filters": [...] } ``` ``` -------------------------------- ### Excluir item de promoção (Exemplo) Source: https://developers.mercadolivre.com.br/pt_br/campanha-com-co-participacao Exemplo prático de como excluir um item de uma promoção com parâmetros específicos. ```bash curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/items/MLB1834747833?promotion_type=MARKETPLACE_CAMPAIGN&promotion_id=P-MLB379009&offer_id=MLB1834747833-9eafadd4-16d2-49ae-b272-9a7a34585cb8&app_version=v2' ``` -------------------------------- ### Example: Total WhatsApp Clicks Per Ad Source: https://developers.mercadolivre.com.br/pt_br/automovel-gerenciamento-de-contatos An example request to get the total number of WhatsApp clicks for a specific ad. ```curl curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA1116194549/contacts/whatsapp?date_from=2014-05-28T00:00:00.000-03:00&date_to=2014-05-29T23:59:59.999 ``` -------------------------------- ### Example of File Command Output Source: https://developers.mercadolivre.com.br/pt_br/trabalhar-com-imagens This is an example output from the 'file' command, indicating that the file is an XML document, which might be an error if a JPG was expected. ```text 146.111111.jpg: XML 1.0 document text, ASCII text ``` -------------------------------- ### Example Search for Adidas Brand, Women Gender in SNEAKERS Source: https://developers.mercadolivre.com.br/pt_br/primeiros-pasos This example demonstrates a POST request to search for available measurement tables for the 'Adidas' brand and 'Mujer' (Women) gender within the 'SNEAKERS' domain. It includes pagination parameters. ```bash curl -X POST 'https://api.mercadolibre.com/catalog/charts/search?offset=1&limit=100' -H 'x-caller-id: 123456' -H 'Content-Type: application/json' -H 'Authorization: Bearer $ACCESS_TOKEN' --data-raw '{ "domain_id": "SNEAKERS", "site_id": "MLA", "seller_id": 123456, "attributes": [ { "id": "GENDER", "values": [ { "name": "Mujer" } ] }, { "id": "BRAND", "values": [ { "name": "adidas" } ] } ] }' ``` -------------------------------- ### Example General Notification Response Source: https://developers.mercadolivre.com.br/pt_br/produto-receba-notificacoes An example of a notification response for a general topic. Use the 'resource' field to construct the GET request URL. ```json { "_id": "f9f08571-1f65-4c46-9e0a-c0f43faa1557e", "resource": "/items/MLA686791111", "user_id": 123456789, "topic": "items", "application_id": 2069392825111111, "attempts": 1, "sent": "2025-01-21T13:44:33.006Z", "received": "2025-01-21T13:44:32.984Z" } ``` -------------------------------- ### Example Query for Sales Feedback Source: https://developers.mercadolivre.com.br/pt_br/feedback-de-uma-venda An example of how to query feedback for a specific order ID. This demonstrates the structure of the request. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/2000003508419013/feedback ``` -------------------------------- ### Identify Carrier Code - Example Request Source: https://developers.mercadolivre.com.br/pt_br/envios-flex An example of a GET request to identify the carrier for a shipment with a specific site ID and shipment ID. ```curl curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/flex/sites/MLA/shipments/40070866801/assignment/v2 ``` -------------------------------- ### Product Information Response Example Source: https://developers.mercadolivre.com.br/pt_br/gerenciamento-de-vendas Example response showing product attributes like IMEI and entry date. For Fulfillment orders, IMEI is also available directly on the fiscal note. ```json { "attributes": [ { "name": "IMEI", "value": "111", "id": 1 }, { "name": "IMEI", "value": "222", "id": 2 }, { "name": "entry_date", "value": "01/01/2001", "id": 3 } ] } ``` -------------------------------- ### Example of Associating Item with Products and Product Families Source: https://developers.mercadolivre.com.br/pt_br/compatibilidades-itens-e-produtos-de-autopecas This example demonstrates a specific request to associate an item with products and product families, including concrete IDs and values for attributes and restrictions. The 'note' field has a character limit and is moderated. ```bash curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM794706391/compatibilities { "products": [{ "id": "MLB155254", "creation_source": "ITEM_SUGGESTIONS", "note": "Modelos posteriores a Mayo de 2018", "restrictions": [] }], "products_families": [{ "domain_id": "MLB-CARS_AND_VANS", "attributes": [{ "id": "BRAND", "value_id": "60249" }, { "id": "YEAR", "value_name": "2010" }, ], "note": "Solamente para vehículos de fabricación Europea", "restrictions": [{ "attribute_id": "POSITION", "attribute_values": [{ "values":[{"value_id": "12456","value_name": "Delantero"}] }, { "values":[{"value_id": "65432","value_name": "Trasero"}, {"value_id": "87675","value_name": "Inferior"}] } ] }] }] } ``` -------------------------------- ### Example API Request to Get Lead Details Source: https://developers.mercadolivre.com.br/pt_br/pessoas-interessadas An example cURL request to retrieve the details of a specific lead using its ID with the /vis/leads/ endpoint. ```bash curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/vis/leads/3f2dedf2-dfbd-4981-a726-40b13aa172ff ``` -------------------------------- ### Example: Total Phone Clicks Per User Source: https://developers.mercadolivre.com.br/pt_br/automovel-gerenciamento-de-contatos An example request to get total phone clicks for a user within a specific date range. ```curl curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/52366166/contacts/phone_views?date_from=2014-05-28T00:00:00.000-03:00&date_to=2014-05-29T23:59:59.999 ``` -------------------------------- ### Example call to get shipping attributes for MLA-AUTOMOTIVE_TIRES Source: https://developers.mercadolivre.com.br/pt_br/mercado-envios This example demonstrates how to call the API for a specific domain, MLA-AUTOMOTIVE_TIRES. The domain_id can be found in the /categories or /items endpoints. ```curl curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/MLA-AUTOMOTIVE_TIRES/shipping_attributes ``` -------------------------------- ### Resource Not Found Error Example Source: https://developers.mercadolivre.com.br/pt_br/erros Returned when the requested resource does not exist. Verify the resource identifier and ensure it has been created. ```json { "message": "Resource not found", "error": "business_logic_error", "status": 404, "cause": [] } ```