Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Categorías y Atributos
Mira nuestro webinar sobre Predictor de categorías:
Categorías
El recurso /sites puede ofrecerte la estructura de categorías para un país en particular, en este caso Argentina.
Llamada:curl -X GET https://api.mercadolibre.com/sites/MLA/categories[
{
"id": "MLA5725",
"name": "Accesorios para Vehículos"
},
{
"id": "MLA1512",
"name": "Agro"
},
{
"id": "MLA1403",
"name": "Alimentos y Bebidas"
},
{
"id": "MLA1071",
"name": "Animales y Mascotas"
},
{
"id": "MLA1367",
"name": "Antigüedades y Colecciones"
},
{
"id": "MLA1368",
"name": "Arte, Librería y Mercería"
},
{
"id": "MLA1743",
"name": "Autos, Motos y Otros"
},
{
"id": "MLA1384",
"name": "Bebés"
},
{
"id": "MLA1246",
"name": "Belleza y Cuidado Personal"
},
{
"id": "MLA1039",
"name": "Cámaras y Accesorios"
},
{
"id": "MLA1051",
"name": "Celulares y Teléfonos"
},
{
"id": "MLA1648",
"name": "Computación"
},
{
"id": "MLA1144",
"name": "Consolas y Videojuegos"
},
{
"id": "MLA1276",
"name": "Deportes y Fitness"
},
{
"id": "MLA5726",
"name": "Electrodomésticos y Aires Ac."
},
{
"id": "MLA1000",
"name": "Electrónica, Audio y Video"
},
{
"id": "MLA2547",
"name": "Entradas para Eventos"
},
{
"id": "MLA407134",
"name": "Herramientas y Construcción"
},
{
"id": "MLA1574",
"name": "Hogar, Muebles y Jardín"
},
{
"id": "MLA1499",
"name": "Industrias y Oficinas"
},
{
"id": "MLA1459",
"name": "Inmuebles"
},
{
"id": "MLA1182",
"name": "Instrumentos Musicales"
},
{
"id": "MLA3937",
"name": "Joyas y Relojes"
},
{
"id": "MLA1132",
"name": "Juegos y Juguetes"
},
{
"id": "MLA3025",
"name": "Libros, Revistas y Comics"
},
{
"id": "MLA1168",
"name": "Música, Películas y Series"
},
{
"id": "MLA1430",
"name": "Ropa y Accesorios"
},
{
"id": "MLA409431",
"name": "Salud y Equipamiento Médico"
},
{
"id": "MLA1540",
"name": "Servicios"
},
{
"id": "MLA9304",
"name": "Souvenirs, Cotillón y Fiestas"
},
{
"id": "MLA1953",
"name": "Otras categorías"
}
]Para categorías de segundo nivel o información relacionada con categorías específicas, debes utilizar el recurso /categories y enviar el ID de categoría como parámetro. Veamos qué encontramos en la categoría MLA1743 “Auto, Motos y Otros”.
Llamada:
curl -X GET https://api.mercadolibre.com/categories/MLA1743Respuesta:
{
"id": "MLA1743",
"name": "Autos, Motos y Otros",
"picture": "http://resources.mlstatic.com/category/images/e1a43666-ad57-4b8b-b405-f9d04dbbd8fc.png",
"permalink": "http://www.mercadolibre.com.ar/vehiculos/",
"total_items_in_this_category": 176713,
"path_from_root": [
{
"id": "MLA1743",
"name": "Autos, Motos y Otros"
}
],
"children_categories": [
{
"id": "MLA93412",
"name": "Autos Chocados y Averiados",
"total_items_in_this_category": 1406
},
{
"id": "MLA1745",
"name": "Autos de Colección",
"total_items_in_this_category": 2670
},
{
"id": "MLA1744",
"name": "Autos y Camionetas",
"total_items_in_this_category": 104271
},
{
"id": "MLA58254",
"name": "Camiones",
"total_items_in_this_category": 3242
},
{
"id": "MLA51547",
"name": "Colectivos",
"total_items_in_this_category": 555
},
{
"id": "MLA7312",
"name": "Maquinaria Agrícola",
"total_items_in_this_category": 3644
},
{
"id": "MLA405183",
"name": "Maquinaria Vial",
"total_items_in_this_category": 2293
},
{
"id": "MLA80579",
"name": "Motorhomes",
"total_items_in_this_category": 984
},
{
"id": "MLA1763",
"name": "Motos",
"total_items_in_this_category": 38878
},
{
"id": "MLA1785",
"name": "Náutica",
"total_items_in_this_category": 7730
},
{
"id": "MLA1784",
"name": "Planes de Ahorro",
"total_items_in_this_category": 1708
},
{
"id": "MLA93430",
"name": "Semirremolques",
"total_items_in_this_category": 1147
},
{
"id": "MLA1907",
"name": "Otros Vehículos",
"total_items_in_this_category": 8081
}
],
"attribute_types": "none",
"settings": {
"adult_content": false,
"buying_allowed": false,
"buying_modes": [
"classified"
],
"catalog_domain": null,
"coverage_areas": "not_allowed",
"currencies": [
"USD",
"ARS"
],
"fragile": false,
"immediate_payment": "optional",
"item_conditions": [
"used",
"not_specified",
"new"
],
"items_reviews_allowed": false,
"listing_allowed": false,
"max_description_length": 50000,
"max_pictures_per_item": 15,
"max_pictures_per_item_var": 6,
"max_sub_title_length": 70,
"max_title_length": 60,
"maximum_price": null,
"minimum_price": null,
"mirror_category": null,
"mirror_master_category": null,
"mirror_slave_categories": [],
"price": "required",
"reservation_allowed": "mandatory",
"restrictions": [],
"rounded_address": false,
"seller_contact": "optional",
"shipping_modes": [
"not_specified",
"custom"
],
"shipping_options": [],
"shipping_profile": "not_allowed",
"show_contact_information": true,
"simple_shipping": "not_allowed",
"stock": "required",
"sub_vertical": null,
"subscribable": false,
"tags": [],
"vertical": "motors",
"vip_subdomain": "vehiculo",
"buyer_protection_programs": [
"delivered",
"undelivered"
],
"status": "enabled"
},
"meta_categ_id": null,
"attributable": false,
"date_created": "2018-04-25T08:12:56.000Z"
}Realiza una llamada a una categoría en particular, encontrarás todos los atributos disponibles y puedes saber si son obligatorios u opcionales para publicar en la categoría. Por ejemplo, para explorar el árbol de categorías debes utilizar “path_from_root” para conocer los niveles anteriores y "children_categories" para los niveles abajo. Realizaremos otra llamada, ahora en la categoría MLA1744, que es la categoría de los automóviles.
Llamada:
curl -X GET https://api.mercadolibre.com/categories/MLA1744Respuesta:
{
"id": "MLA1744",
"name": "Autos y Camionetas",
"picture": "http://resources.mlstatic.com/category/images/470e5a62-5d07-432a-8f00-6a67b2ffada8.png",
"permalink": null,
"total_items_in_this_category": 104271,
"path_from_root": [
{
"id": "MLA1743",
"name": "Autos, Motos y Otros"
},
{
"id": "MLA1744",
"name": "Autos y Camionetas"
}
],
"children_categories": [
{
"id": "MLA6039",
"name": "Alfa Romeo",
"total_items_in_this_category": 199
},
{
"id": "MLA411489",
"name": "Aro",
"total_items_in_this_category": 11
},
{
"id": "MLA10356",
"name": "Asia",
"total_items_in_this_category": 8
},
{
"id": "MLA420506",
"name": "Aston Martin",
"total_items_in_this_category": 0
},
{
"id": "MLA5782",
"name": "Audi",
"total_items_in_this_category": 3375
},
{
"id": "MLA410981",
"name": "BAIC",
"total_items_in_this_category": 108
},
{
"id": "MLA5783",
"name": "BMW",
"total_items_in_this_category": 2184
},
{
"id": "MLA422397",
"name": "Changan",
"total_items_in_this_category": 58
},
{
"id": "MLA42429",
"name": "Chery",
"total_items_in_this_category": 698
},
{
"id": "MLA3185",
"name": "Chevrolet",
"total_items_in_this_category": 12132
},
{
"id": "MLA4357",
"name": "Chrysler",
"total_items_in_this_category": 186
},
{
"id": "MLA5779",
"name": "Citroën",
"total_items_in_this_category": 3786
},
{
"id": "MLA411740",
"name": "Dacia",
"total_items_in_this_category": 4
},
{
"id": "MLA5680",
"name": "Daewoo",
"total_items_in_this_category": 21
},
{
"id": "MLA6619",
"name": "Daihatsu",
"total_items_in_this_category": 33
},
{
"id": "MLA412008",
"name": "DFSK",
"total_items_in_this_category": 97
},
{
"id": "MLA6671",
"name": "Dodge",
"total_items_in_this_category": 510
},
{
"id": "MLA411856",
"name": "DS",
"total_items_in_this_category": 123
},
{
"id": "MLA97714",
"name": "Ferrari",
"total_items_in_this_category": 23
},
{
"id": "MLA3174",
"name": "Fiat",
"total_items_in_this_category": 11657
},
{
"id": "MLA3180",
"name": "Ford",
"total_items_in_this_category": 9319
},
{
"id": "MLA410982",
"name": "Foton",
"total_items_in_this_category": 67
},
{
"id": "MLA406048",
"name": "Geely",
"total_items_in_this_category": 104
},
{
"id": "MLA413791",
"name": "Great Wall",
"total_items_in_this_category": 43
},
{
"id": "MLA413792",
"name": "Haval",
"total_items_in_this_category": 116
},
{
"id": "MLA5791",
"name": "Honda",
"total_items_in_this_category": 1555
},
{
"id": "MLA8509",
"name": "Hummer",
"total_items_in_this_category": 8
},
{
"id": "MLA5683",
"name": "Hyundai",
"total_items_in_this_category": 788
},
{
"id": "MLA6599",
"name": "Isuzu",
"total_items_in_this_category": 50
},
{
"id": "MLA412827",
"name": "Iveco",
"total_items_in_this_category": 33
},
{
"id": "MLA417839",
"name": "JAC",
"total_items_in_this_category": 61
},
{
"id": "MLA83415",
"name": "Jaguar",
"total_items_in_this_category": 42
},
{
"id": "MLA6600",
"name": "Jeep",
"total_items_in_this_category": 3015
},
{
"id": "MLA7079",
"name": "Kia",
"total_items_in_this_category": 909
},
{
"id": "MLA7219",
"name": "Lada",
"total_items_in_this_category": 8
},
{
"id": "MLA8125",
"name": "Land Rover",
"total_items_in_this_category": 175
},
{
"id": "MLA412093",
"name": "Lexus",
"total_items_in_this_category": 7
},
{
"id": "MLA389337",
"name": "Lifan",
"total_items_in_this_category": 248
},
{
"id": "MLA407429",
"name": "Maserati",
"total_items_in_this_category": 25
},
{
"id": "MLA5681",
"name": "Mazda",
"total_items_in_this_category": 39
},
{
"id": "MLA6038",
"name": "Mercedes Benz",
"total_items_in_this_category": 2717
},
{
"id": "MLA8480",
"name": "Mini",
"total_items_in_this_category": 377
},
{
"id": "MLA5743",
"name": "Mitsubishi",
"total_items_in_this_category": 366
},
{
"id": "MLA6173",
"name": "Nissan",
"total_items_in_this_category": 1525
},
{
"id": "MLA4100",
"name": "Peugeot",
"total_items_in_this_category": 8293
},
{
"id": "MLA8503",
"name": "Porsche",
"total_items_in_this_category": 179
},
{
"id": "MLA411743",
"name": "Proton",
"total_items_in_this_category": 0
},
{
"id": "MLA99993",
"name": "Ram",
"total_items_in_this_category": 461
},
{
"id": "MLA3205",
"name": "Renault",
"total_items_in_this_category": 11829
},
{
"id": "MLA6041",
"name": "Rover",
"total_items_in_this_category": 48
},
{
"id": "MLA411512",
"name": "Saab",
"total_items_in_this_category": 4
},
{
"id": "MLA6109",
"name": "Seat",
"total_items_in_this_category": 58
},
{
"id": "MLA440813",
"name": "Sero Electric",
"total_items_in_this_category": 6
},
{
"id": "MLA413532",
"name": "Shineray",
"total_items_in_this_category": 94
},
{
"id": "MLA106929",
"name": "Smart",
"total_items_in_this_category": 127
},
{
"id": "MLA11927",
"name": "Ssangyong",
"total_items_in_this_category": 23
},
{
"id": "MLA7078",
"name": "Subaru",
"total_items_in_this_category": 121
},
{
"id": "MLA6583",
"name": "Suzuki",
"total_items_in_this_category": 329
},
{
"id": "MLA11807",
"name": "Tata",
"total_items_in_this_category": 8
},
{
"id": "MLA5753",
"name": "Toyota",
"total_items_in_this_category": 5099
},
{
"id": "MLA3196",
"name": "Volkswagen",
"total_items_in_this_category": 19957
},
{
"id": "MLA440812",
"name": "Volt Motors",
"total_items_in_this_category": 0
},
{
"id": "MLA7080",
"name": "Volvo",
"total_items_in_this_category": 179
},
{
"id": "MLA417354",
"name": "Zanella",
"total_items_in_this_category": 4
},
{
"id": "MLA1939",
"name": "Otras Marcas",
"total_items_in_this_category": 313
}
],
"attribute_types": "attributes",
"settings": {
"adult_content": false,
"buying_allowed": false,
"buying_modes": [
"classified"
],
"catalog_domain": "MLA-CARS_AND_VANS",
"coverage_areas": "not_allowed",
"currencies": [
"USD",
"ARS"
],
"fragile": false,
"immediate_payment": "optional",
"item_conditions": [
"used",
"not_specified",
"new"
],
"items_reviews_allowed": false,
"listing_allowed": false,
"max_description_length": 50000,
"max_pictures_per_item": 15,
"max_pictures_per_item_var": 6,
"max_sub_title_length": 70,
"max_title_length": 60,
"maximum_price": null,
"minimum_price": null,
"mirror_category": null,
"mirror_master_category": null,
"mirror_slave_categories": [],
"price": "required",
"reservation_allowed": "mandatory",
"restrictions": [],
"rounded_address": false,
"seller_contact": "optional",
"shipping_modes": [
"not_specified",
"custom"
],
"shipping_options": [],
"shipping_profile": "not_allowed",
"show_contact_information": true,
"simple_shipping": "not_allowed",
"stock": "required",
"sub_vertical": "cars",
"subscribable": false,
"tags": [],
"vertical": "motors",
"vip_subdomain": "auto",
"buyer_protection_programs": [
"delivered",
"undelivered"
],
"status": "enabled"
},
"meta_categ_id": null,
"attributable": true,
"date_created": "2018-04-25T08:12:56.000Z"
}Predictor de categorías
Para identificar la mejor categoría para su publicación, realiza una llamada GET en el recurso /domain_discovery a partir del título provisto. En la respuesta, la primera es la de mayor probabilidad.
Parámetros obligatorios
site_id: es el sitio en el que realizas la publicación.
q: es el título del artículo a predecir y debe estar completamente en el idioma del sitio (español o portugués).
Parámetros opcionales
limit: por defecto, el límite será de 4 con un máximo de 8, por lo que podrías definir un limit entre 1 a 8.
target: puede estar compuesto por core (Producto) o classified (Clasificados) dependiendo la vertical en el que estés publicando.
Llamada:
curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/domain_discovery/search?q=$QEjemplo:
curl -X GET https://api.mercadolibre.com/sites/MLA/domain_discovery/search?limit=1&q=fiat%20unoRespuesta
[
{
"domain_id": "MLA-CARS_AND_VANS",
"domain_name": "Autos y camionetas",
"category_id": "MLA24322",
"category_name": "Uno",
"attributes": []
}
]Campos de respuesta
domain_id: es el ID del dominio que predices para el artículo.
domain_name: es el nombre del dominio que predices.
category_id: es el ID de la categoría que predices para el artículo.
category_name: es el nombre de la categoría que predices.
attributes: listado de atributos para la categoría que se predijo.
Atributos específicos de las categorías
Para conocer los atributos específicos y valores posibles de las categorías para publicar un automóvil, consulta el recurso /attributes.
Llamada:
curl -X GET https://api.mercadolibre.com/categories/MLA1744/attributesRespuesta acotada:
[
{
"id": "BRAND",
"name": "Marca",
"tags": {
"catalog_required": true,
"required": true
},
"hierarchy": "PARENT_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"values": [
...
{
"id": "389168",
"name": "Chery"
},
{
"id": "58955",
"name": "Chevrolet"
},
{
"id": "66395",
"name": "Chrysler"
},
{
"id": "389169",
"name": "Citroën"
},
...
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "MODEL",
"name": "Modelo",
"tags": {
"catalog_required": true,
"required": true
},
"hierarchy": "PARENT_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"values": [
...
{
"id": "389394",
"name": "Aircross"
},
{
"id": "389395",
"name": "Airtrek"
},
{
"id": "71720",
"name": "Albea"
},
{
"id": "60597",
"name": "Alhambra"
},
{
"id": "64101",
"name": "Alliance"
},
...
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "VEHICLE_YEAR",
"name": "Año",
"tags": {
"required": true
},
"hierarchy": "PARENT_PK",
"relevance": 1,
"value_type": "number",
"value_max_length": 18,
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "TRIM",
"name": "Versión",
"tags": {
"catalog_required": true,
"required": true
},
"hierarchy": "PARENT_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
...
}
]Atributos obligatorios
Los atributos obligatorios se configuran como “required” en el detalle de la categoría. En el ejemplo anterior, puedes ver que precio y stock son obligatorios; no se permiten las áreas de cobertura y el seller_contact es opcional.
Valores más utilizados (top values)
Con este recurso podrás conocer cuáles son los valores más usados para determinado atributo de un dominio. También podrás profundizar la búsqueda indicando otros valores de atributos para que se listen solo los valores que apliquen a ellos.
Los vendedores podrán utilizar los valores obtenidos para elegir dentro de ellos cuál es el correcto y mejorar la calidad de las publicaciones.
Parámetros obligatorios
domain_id: es el ID del dominio al cual queremos hacer referencia.
attribute_id: es el ID del atributo del cual necesitamos conocer los valores más usados.
Parámetros opcionales
limit: es el límite de resultados que se solicita tiene un máximo de 1000.
metric_type: es la métrica por la cual se ordenarán los resultados, en principio solo se admiten NOLs (nuevas publicaciones en los últimos 90 días). El único parámetro por el momento es NOL_90. Próximamente, sumaremos nuevos criterios. Ejemplo: metric_type=NOL_90.
Para identificar los atributos recomendados y conocidos, debes realizar un POST.
Llamada simple con un solo atributo:
curl -X POST https://api.mercadolibre.com/catalog_domains/$DOMAIN_ID/attributes/$ATTRIBUTE_ID/top_valuesEjemplo:
curl -X POST https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS/attributes/BRAND/top_valuesRespuesta:
[
{
"id": "60249",
"name": "Volkswagen",
"metric": 7987
},
{
"id": "66432",
"name": "Ford",
"metric": 5619
},
{
"id": "9909",
"name": "Renault",
"metric": 4659
},
{
"id": "58955",
"name": "Chevrolet",
"metric": 4319
},
{
"id": "60279",
"name": "Peugeot",
"metric": 4285
},
{
"id": "67781",
"name": "Fiat",
"metric": 4172
},
...
]Ejemplo con más de un atributo:
Llamada:
curl -X POST https://api.mercadolibre.com/catalog_domains/$DOMAIN_ID/attributes/$ATTRIBUTE_ID/top_values
{
"known_attributes": [
{
"id": "attributes.id",
"value_id": "attributes.value_id"
}
]
}Ejemplo:
curl -X POST https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS/attributes/MODEL/top_values
{
"known_attributes": [
{
"id": "BRAND",
"value_id": "60249"
}
]
}En este caso, el contenido de la respuesta serán los modelos más utilizados de la marca 6249 Volkswagen.
Descarga de categorías
Recuerda que te recomendamos utilizar el predictor de categorías en tu desarrollo, pero si prefieres, puedes descargar el árbol de categorías para el sitio del país destinado al procesamiento offline. Este recurso te devuelve el árbol de categorías en formato JSON dentro de una respuesta codificada con gzip. Para obtener las categorías de Argentina, utiliza esta URL:
curl -X GET https://api.mercadolibre.com/sites/MLA/categories/allContiene 2 encabezados que pueden utilizarse para verificar cuándo se generó el último volcado.
X-Content-Created [contenido X creado]: contiene la fecha de la última generación.
X-Content-MD5: contiene la suma de comprobación MD5 de la última generación.
Llamada:
curl -X GET https://api.mercadolibre.com/sites/MLA/categories/allRespuesta:
HTTP/2 200
content-type: application/json
content-length: 0
date: Wed, 29 Apr 2020 20:40:14 GMT
x-amz-id-2: VTcFVSUdn06VM4dbsuP5vZyHQ5fycw3kHjUgzRxEzSJxSJfEuYpr9DlHZ6ab+2DPvJ/SD97R7OQ=
x-amz-replication-status: COMPLETED
x-amz-request-id: 8BA998DE0241013D
x-amz-version-id: nhcoZXYi83Rh5CjxRYMmFLRIPO_cz7yl
x-content-type-options: nosniff
x-request-id: 071f0a43-1b95-4b04-accd-77646bd6dc3e
x-frame-options: DENY
x-xss-protection: 1; mode=block
access-control-allow-origin: *
access-control-allow-headers: Content-Type
access-control-allow-methods: PUT, GET, POST, DELETE, OPTIONS
access-control-max-age: 86400
accept-ranges: bytes
last-modified: Wed, 29 Apr 2020 20:01:12 GMT
cache-control: max-age=300
content-encoding: gzip
x-content-created: 2020-04-29T20:01:12.000Z
x-content-md5: 7526ed93467ec227359522beac126d82
x-cache: Miss from cloudfront
via: 1.1 b7b2667a8f791fb60d70bb1835ef9b2b.cloudfront.net (CloudFront)
x-amz-cf-pop: GRU1-C1
x-amz-cf-id: bvgXHVEFMS1BSLQCqEJxXmUL6zMRQQnCHBCCJMg78WUfPLVYGubO8Q==
Búsqueda por categoría
La operación de búsqueda devuelve publicaciones que pertenecen a una categoría de publicación de Mercado Libre; si bien pueden haber muchas publicaciones en ciertas categorías, no te preocupes, puedes paginar los resultados. Lee sobre paginación de los resultados de búsqueda. Para acceder a todos los publicaciones en una categoría determinada, tienes que hacer lo siguiente:
curl -X GET https://api.mercadolibre.com/MLA/search?category=MLA5726La respuesta de búsqueda tiene gran cantidad de parámetros. Utiliza el método OPCIONES http para obtener una respuesta codificada con JSON que describirá la API, con todos los métodos y conexiones permitidos entre otra parte de la API.
Paginación y dimensionamiento de resultados
Ahora podrás trabajar con conjuntos específicos de resultados cada vez que realices una llamada al reecurso. La mayoría de los recursos presentan parámetros url comunes para paginar y dimensionar resultados: limit e offset.
Valores por defecto
Los valores por defecto son offset=0 y limit=50.
curl -X GET https://api.mercadolibre.com/sites/MLA/search?q=ipodnanoEn la sección de paginación de la respuesta JSON, puedes ver la cantidad total de publicaciones que coinciden con la búsqueda y el valor de offset con el limit por defecto aplicado.
.....
"paging": {
"total": 285,
"offset": 0,
"limit": 50,
}
.....Limit
Para reducir el tamaño de página, puedes cambiar el parámetro de limit. Por ejemplo, si estás interesado en recuperar solo los primeros 3 publicaciones.
Ejemplo:
curl -X GET https://api.mercadolibre.com/sites/MLA/search?q=ipodnano&limit=3Esta acción recupera un dato JSON con un conjunto de 3 publicaciones, como en la respuesta a continuación:
{
"site_id": "MLA",
"query": "ipod nano",
"paging": {
"total": 284,
"offset": 0,
"limit": 3,
},
"results": [
{...},
{...},
{...},
],
"sort": {...},
"available_sorts": [...],
"filters": [...],
"available_filters": [...],
}Offset
Al utilizar el atributo offset, puedes mover el límite inferior del bloque de resultados. Por ejemplo, si te interesa recuperar las 50 publicaciones que siguen la respuesta por defecto.
Ejemplo:
curl -X GET https://api.mercadolibre.com/sites/MLA/search?q=ipodnano&offset=50Respuesta:
{
"site_id": "MLA",
"query": "ipod nano",
"paging": {
"total": 285,
"offset": 50,
"limit": 50,
},
"results": [...],
"sort": {...},
"available_sorts": [...],
"filters": [...],
"available_filters": [...],
}Esta respuesta recupera 50 publicaciones a partir de los primeros cincuenta.
Definir un rango de resultados
Es posible combinar ambos parámetros. Puedes recuperar publicaciones desde el tercero al sexto en el resultado de búsqueda original:
curl -X GET https://api.mercadolibre.com/sites/MLA/search?q=ipodnano&offset=3&limit=3Esta acción recupera un dato JSON con un conjunto de 3 publicaciones, como se ilustra a continuación:
{
"site_id": "MLA",
"query": "ipod nano",
"paging": {
"total": 285,
"offset": 3,
"limit": 3,
},
"results": [
{...},
{...},
{...},
],
"sort": {...},
"available_sorts": [...],
"filters": [...],
"available_filters": [...],
}