Búsqueda de ítems

Contenidos

→Resumen de los recursos disponibles
→Buscar artículos por categoría
→Valores en campos sold_quantity y available_quantity
    ↳sold_quantity
    ↳available_quantity
→Obtener ítems de una consulta de búsqueda
    ↳Obtener ítems de los listados por vendedor
→Buscar ítems por vendedor
    ↳Obtener ítems de los listados por vendedor
    ↳Por nickname
    ↳Por ID de vendedor
    ↳Por ID de vendedor para una categoría específica
→Obtiene ítems de la cuenta de un vendedor
    ↳Por user_id
    ↳Por SKU
    ↳Por estado
→Multiget
→Selección de campos
→Modo de búsqueda por encima de 1000 registros
    ↳Trabajar con Scan + Hash


Resumen de los recursos disponibles

Recurso Descripción
/sites/$SITE_ID/search?category=$CATEGORY_ID Obtener ítems listados en una categoría.
/sites/$SITE_ID/search?q=Motorola%20G6 Obtener ítems de una consulta de búsqueda.
/sites/$SITE_ID/search?nickname=$NICKNAME Obtener ítems de los listados por nickname.
/sites/$SITE_ID/search?seller_id=$SELLER_ID Permite listar ítems por vendedor.
/sites/$SITE_ID/search?seller_id=$SELLER_ID&category=$CATEGORY_ID Obtener ítems de los listados por vendedor en una categoría específica.
/users/$USER_ID/items/search?access_token=$ACCESS_TOKEN Permite listar todos los ítems de la cuenta de un vendedor.
/items?ids=$ITEM_ID1,$ITEM_ID2&access_token=$ACCESS_TOKEN Multiget con múltiples números de ítems.
/users?ids=$USER_ID1,$USER_ID2&access_token=$ACCESS_TOKEN Multiget con múltiples números de usuarios.
/items?ids=$ITEM_ID1,$ITEM_ID2&attributes=$ATTRIBUTE1,$ATTRIBUTE2,$ATTRIBUTE3&access_token=$ACCESS_TOKEN Multiget con múltiples números de ítems seleccionando sólo los campos de interés.
/users/$USER_ID/items/search?search_type=scan&access_token=$ACCESS_TOKEN Para obtener más de 1000 registros.

Buscar artículos por categoría

Con la siguiente llamada obtendrás los artículos que pertenecen a una categoría.
Ten en cuenta que al inicio de los resultados verás los ítems que pertenecen a catálogo identificándolos en el campo catalog_listing con el valor true.
Documentaciones recomendadas:
- Para conocer más detalles sobre las categorías y la jerarquía, consulta la siguiente guía de Categorías y Atributos.
- Si estás interesado en definir una respuesta con paginación de resultados, accede al siguiente link.
- Recuerda que para más información sobre catálogo podés entrar acá.


Llamada:

  curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/search?category=$CATEGORY_ID

Ejemplo:

  curl -X GET https://api.mercadolibre.com/sites/MLA/search?category=MLA1055

Respuesta:

  {
   "site_id": "MLA",
   "paging": {
       "total": 84846,
       "offset": 0,
       "limit": 50,
       "primary_results": 1000
   },
   "results": [
       {
           "id": "MLA810164558",
           "site_id": "MLA",
           "title": "Motorola E5 Play (android Go Edition) 16 Gb Dorado",
           "seller": {
               "id": 174556876,
               "power_seller_status": "platinum",
               "car_dealer": false,
               "real_estate_agency": false,
               "tags": []
           },
           "price": 7299,
           "currency_id": "ARS",
           "available_quantity": 500,
           "sold_quantity": 5,
           "buying_mode": "buy_it_now",
           "listing_type_id": "gold_special",
           "stop_time": "2039-08-15T04:00:00.000Z",
           "condition": "new",
           "permalink": "https://www.mercadolibre.com.ar/p/MLA13156516",
           "thumbnail": "http://mla-s1-p.mlstatic.com/916515-MLA31002756138_062019-I.jpg",
           "accepts_mercadopago": true,
           "installments": {
               "quantity": 12,
               "amount": 996.13,
               "rate": 63.77,
               "currency_id": "ARS"
           },
           "address": {
               "state_id": "AR-C",
               "state_name": "Capital Federal",
               "city_id": "TUxBQlZJTDQyMjBa",
               "city_name": "Villa Crespo"
           },
           "shipping": {
               "free_shipping": true,
               "mode": "me2",
               "tags": [
                   "self_service_in",
                   "fbm_in_process",
                   "mandatory_free_shipping"
               ],
               "logistic_type": "cross_docking",
               "store_pick_up": false
           },
           "seller_address": {
               "id": "",
               "comment": "",
               "address_line": "",
               "zip_code": "",
               "country": {
                   "id": "AR",
                   "name": "Argentina"
               },
               "state": {
                   "id": "AR-C",
                   "name": "Capital Federal"
               },
               "city": {
                   "id": "TUxBQlZJTDQyMjBa",
                   "name": "Villa Crespo"
               },
               "latitude": "",
               "longitude": ""
           },
           "attributes": [
               {
                   "attribute_group_name": "Otros",
                   "source": 1,
                   "id": "BRAND",
                   "name": "Marca",
                   "value_id": "2503",
                   "value_name": "Motorola",
                   "value_struct": null,
                   "attribute_group_id": "OTHERS"
               },
               {
                   "value_id": "6954119",
                   "value_name": "4x1.4 GHz Cortex-A53",
                   "value_struct": null,
                   "attribute_group_id": "OTHERS",
                   "attribute_group_name": "Otros",
                   "source": 1,
                   "id": "CPU_MODEL",
                   "name": "Modelo de CPU"
               },
               {
                   "source": 1,
                   "id": "PROCESSOR_MODEL",
                   "name": "Modelo del procesador",
                   "value_id": "2087879",
                   "value_name": "Snapdragon 425",
                   "value_struct": null,
                   "attribute_group_id": "OTHERS",
                   "attribute_group_name": "Otros"
               }
           ],
           "original_price": null,
           "category_id": "MLA1055",
           "official_store_id": null,
           "catalog_product_id": "MLA13156516",
           "tags": [
               "loyalty_discount_eligible",
               "brand_verified",
               "extended_warranty_eligible",
               "good_quality_picture",
               "good_quality_thumbnail",
               "immediate_payment",
               "cart_eligible"
           ],
           "catalog_listing": true
       },
       {
           "id": "MLA811611159",
           "site_id": "MLA",
           "title": "Motorola G7 64 Gb Ceramic Black 4 Gb Ram",
           "seller": {
               "id": 185702920,
               "power_seller_status": "platinum",
               "car_dealer": false,
               "real_estate_agency": false,
               "tags": []
           },
           "price": 17299,
           "currency_id": "ARS",
           "available_quantity": 1,
           "sold_quantity": 1,
           "buying_mode": "buy_it_now",
           "listing_type_id": "gold_special",
           "stop_time": "2039-08-22T04:00:00.000Z",
           "condition": "new",
           "permalink": "https://www.mercadolibre.com.ar/p/MLA14063506",
           "thumbnail": "http://mla-s2-p.mlstatic.com/780760-MLA31818439856_082019-I.jpg",
           "accepts_mercadopago": true,
           "installments": {
               "quantity": 12,
               "amount": 2360.88,
               "rate": 63.77,
               "currency_id": "ARS"
           },
           "address": {
               "state_id": "AR-C",
               "state_name": "Capital Federal",
               "city_id": null,
               "city_name": "Once"
           },
           "shipping": {
               "free_shipping": true,
               "mode": "me2",
               "tags": [
                   "self_service_in",
                   "mandatory_free_shipping"
               ],
               "logistic_type": "cross_docking",
               "store_pick_up": false
           },
           "seller_address": {
               "id": "",
               "comment": "",
               "address_line": "",
               "zip_code": "",
               "country": {
                   "id": "AR",
                   "name": "Argentina"
               },
               "state": {
                   "id": "AR-C",
                   "name": "Capital Federal"
               },
               "city": {
                   "id": null,
                   "name": "Once"
               },
               "latitude": "",
               "longitude": ""
           },
           "attributes": [
               {
                   "id": "BRAND",
                   "name": "Marca",
                   "value_id": "2503",
                   "value_name": "Motorola",
                   "value_struct": null,
                   "attribute_group_id": "OTHERS",
                   "attribute_group_name": "Otros",
                   "source": 1
               },
               {
                   "value_name": "4x1.8 GHz Kryo 250 Gold/4x1.8 GHz Kryo 250 Silver",
                   "value_struct": null,
                   "attribute_group_id": "OTHERS",
                   "attribute_group_name": "Otros",
                   "source": 1,
                   "id": "CPU_MODEL",
                   "name": "Modelo de CPU",
                   "value_id": "6954315"
               },
               {
                   "value_name": "Snapdragon 632",
                   "value_struct": null,
                   "attribute_group_id": "OTHERS",
                   "attribute_group_name": "Otros",
                   "source": 1,
                   "id": "PROCESSOR_MODEL",
                   "name": "Modelo del procesador",
                   "value_id": "6954318"
               }
           ],
           "original_price": null,
           "category_id": "MLA1055",
           "official_store_id": null,
           "catalog_product_id": null,
           "tags": [
               "brand_verified",
               "extended_warranty_eligible",
               "good_quality_picture",
               "good_quality_thumbnail",
               "immediate_payment",
           ],
           "catalog_listing": false
       }
  ]
}

Valores en campos sold_quantity y available_quantity

En los recursos públicos de Ítems y Búsquedas la información de los campos "sold_quantity" y "available_quantity" será referencial con los siguientes valores:


sold_quantity

Dato real Referencia
1 1
2 2
3 3
4 4
5 5
RANGO_6_25 5
RANGO_26_50 25
RANGO_51_100 50
RANGO_101_150 100
RANGO_151_200 150
RANGO_201_250 200
RANGO_251_500 250
RANGO_501_5000 500
RANGO_5001_50000 5000
RANGO_50001_500000 50000

available_quantity

Dato real Referencia
RANGO_0_50 1
RANGO_51_100 50
RANGO_101_150 100
RANGO_151_200 150
RANGO_201_250 200
RANGO_251_500 250
RANGO_501_5000 500
RANGO_5001_50000 5000
RANGO_50001_99999 50000

Obtener ítems de una consulta de búsqueda

Con la siguiente llamada obtendrás los los ítems relacionados a una consulta.
Ten en cuenta que, al igual que en artículos por categoría, al inicio de los resultados podrás ver todos los ítems que pertenecen a catálogo identificándolos en el campo catalog_listing es con el valor true.
Aquí puedes obtener más información sobre catálogo.


Llamada:

  curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/search?q=Motorola%20G6

Ejemplo:

  curl -X GET https://api.mercadolibre.com/sites/MLA/search?q=Motorola%20G6

Respuesta:

  {
   "site_id": "MLA",
   "query": "Motorola G6",
   "paging": {
       "total": 916,
       "offset": 0,
       "limit": 50,
       "primary_results": 916
   },
   "results": [
       {
           "id": "MLA810645375",
           "site_id": "MLA",
           "title": "Motorola G6 Plus 64 Gb Nimbus",
           "seller": {
               "id": 143125485,
               "power_seller_status": "platinum",
               "car_dealer": false,
               "real_estate_agency": false,
               "tags": []
           },
           "price": 17999,
           "currency_id": "ARS",
           "available_quantity": 100,
           "sold_quantity": 0,
           "buying_mode": "buy_it_now",
           "listing_type_id": "gold_special",
           "stop_time": "2039-08-17T04:00:00.000Z",
           "condition": "new",
           "permalink": "https://www.mercadolibre.com.ar/p/MLA9452524",
           "thumbnail": "http://mla-s2-p.mlstatic.com/795558-MLA31003306206_062019-I.jpg",
           "accepts_mercadopago": true,
           "installments": {
               "quantity": 12,
               "amount": 2456.41,
               "rate": 63.77,
               "currency_id": "ARS"
           },
           "address": {
               "state_id": "AR-C",
               "state_name": "Capital Federal",
               "city_id": "TUxBQkJBTDMxMDZa",
               "city_name": "Balvanera"
           },
           "shipping": {
               "free_shipping": false,
               "mode": "custom",
               "tags": [],
               "logistic_type": "custom",
               "store_pick_up": true
           },
           "seller_address": {
               "id": "",
               "comment": "",
               "address_line": "",
               "zip_code": "",
               "country": {
                   "id": "AR",
                   "name": "Argentina"
               },
               "state": {
                   "id": "AR-C",
                   "name": "Capital Federal"
               },
               "city": {
                   "id": "TUxBQkJBTDMxMDZa",
                   "name": "Balvanera"
               },
               "latitude": "",
               "longitude": ""
           },
           "attributes": [
               {
                   "name": "Marca",
                   "value_id": "2503",
                   "value_name": "Motorola",
                   "value_struct": null,
                   "attribute_group_id": "OTHERS",
                   "attribute_group_name": "Otros",
                   "source": 1,
                   "id": "BRAND"
               },
               {
                   "attribute_group_name": "Otros",
                   "source": 1,
                   "id": "CPU_MODEL",
                   "name": "Modelo de CPU",
                   "value_id": "7070889",
                   "value_name": "4x2.2 GHz Cortex-A53/4x1.8 GHz Cortex-A53",
                   "value_struct": null,
                   "attribute_group_id": "OTHERS"
               },
           ],
           "original_price": null,
           "category_id": "MLA1055",
           "official_store_id": 229,
           "catalog_product_id": "MLA9452524",
           "tags": [
               "brand_verified",
               "extended_warranty_eligible",
               "good_quality_picture",
               "good_quality_thumbnail",
               "immediate_payment"
           ],
           "catalog_listing": true
       },
       {
           "id": "MLA805330648",
           "site_id": "MLA",
           "title": "Motorola G6 32 Gb Plata",
           "seller": {
               "id": 185702920,
               "power_seller_status": "platinum",
               "car_dealer": false,
               "real_estate_agency": false,
               "tags": []
           },
           "price": 14899,
           "currency_id": "ARS",
           "available_quantity": 1,
           "sold_quantity": 0,
           "buying_mode": "buy_it_now",
           "listing_type_id": "gold_special",
           "stop_time": "2039-07-28T17:33:48.000Z",
           "condition": "new",
           "permalink": "https://www.mercadolibre.com.ar/p/MLA9652755",
           "thumbnail": "http://mla-s1-p.mlstatic.com/685061-MLA31003463570_062019-I.jpg",
           "accepts_mercadopago": true,
           "installments": {
               "quantity": 12,
               "amount": 2033.34,
               "rate": 63.77,
               "currency_id": "ARS"
           },
           "address": {
               "state_id": "AR-C",
               "state_name": "Capital Federal",
               "city_id": null,
               "city_name": "Once"
           },
           "shipping": {
               "free_shipping": true,
               "mode": "me2",
               "tags": [
                   "fulfillment",
                   "mandatory_free_shipping"
               ],
               "logistic_type": "fulfillment",
               "store_pick_up": false
           },
           "seller_address": {
               "id": "",
               "comment": "",
               "address_line": "",
               "zip_code": "",
               "country": {
                   "id": "AR",
                   "name": "Argentina"
               },
               "state": {
                   "id": "AR-C",
                   "name": "Capital Federal"
               },
               "city": {
                   "id": null,
                   "name": "Once"
               },
               "latitude": "",
               "longitude": ""
           },
           "attributes": [
               {
                   "name": "Marca",
                   "value_id": "2503",
                   "value_name": "Motorola",
                   "value_struct": null,
                   "attribute_group_id": "OTHERS",
                   "attribute_group_name": "Otros",
                   "source": 1,
                   "id": "BRAND"
               },
               {
                   "value_id": "6936760",
                   "value_name": "8x1.8 GHz Cortex-A53",
                   "value_struct": null,
                   "attribute_group_id": "OTHERS",
                   "attribute_group_name": "Otros",
                   "source": 1,
                   "id": "CPU_MODEL",
                   "name": "Modelo de CPU"
               },
               {
                   "value_name": "Snapdragon 450",
                   "value_struct": null,
                   "attribute_group_id": "OTHERS",
                   "attribute_group_name": "Otros",
                   "source": 1,
                   "id": "PROCESSOR_MODEL",
                   "name": "Modelo del procesador",
                   "value_id": "6936759"
               }
           ],
           "original_price": null,
           "category_id": "MLA1055",
           "official_store_id": null,
           "catalog_product_id": "MLA9652755",
           "tags": [
               "good_quality_picture",
               "good_quality_thumbnail",
               "brand_verified",
               "extended_warranty_eligible",
               "immediate_payment",
               "cart_eligible"
           ],
           "catalog_listing": true
       }
     }
   ]
}

Buscar ítems por vendedor

Según el tipo de recurso que utilices obtendrás los siguientes datos:
Recurso público: /sites/{site_id}/search? podrás obtener los resultados de ítems activos directamente de los listados de Mercado Libre. Recurso privado: /users/{user_id}/items/search?access_token= podrás obtener un listado de los ítems publicados por determinado vendedor desde su cuenta.



Obtener ítems de los listados por vendedor

Esta búsqueda se ajusta a las reglas de los listados de la plataforma. Los resultados siempre serán de ítems activos.


Por nickname

Cuando no conoces el seller_id de un usuario pero sí el apodo, puedes intentar realizar la siguiente búsqueda:

  curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/search?nickname=$NICKNAME

Por ID de vendedor

Si ya conoces el ID del vendedor, solo haz lo siguiente:

  curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/search?seller_id=$SELLER_ID

También se pueden aplicar diferentes filtros y ordenamientos.


Dentro de /sites/{site_id}/search? están los campos "available_sorts" y "available_filters".


¿Cómo filtrar? Por ejemplo, para filtrar ítems con envío gratis encontrarás entre los ”available_filters" disponibles el ID "shipping" y dentro de éste el value con ID “free”.

  curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/search?seller_id=$SELLER_ID&shipping=free

¿Cómo ordenar? En este caso deberás agregar “sort” con el ID disponible del orden que quieras aplicar, por ejemplo: “price_asc”

  curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/search?seller_id=$SELLER_ID&sort=price_asc

Nota: Por defecto la búsqueda en los listados ya viene con un orden de relevancia definido.

También este método de ordenamiento tiene efecto sobre los primeros resultados de ítems de catálogo.



Por ID de vendedor para una categoría específica

Utilizando el siguiente ejemplo podrás buscar dentro de una categoría específica.
Con la siguiente llamada podrás consultar las publicaciones de categorías específicas.

  curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/search?seller_id=$SELLER_ID&category=$CATEGORY_ID

Obtiene ítems de la cuenta de un vendedor

Esta búsqueda se realiza directamente sobre la cuenta del vendedor, por lo que el recurso es privado y se necesita de un access_token.


Por user_id

Si ya conoces el user_id, solo haz lo siguiente:

  curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?access_token=$ACCESS_TOKEN

Por SKU

  • Seller_custom_field: si el ítem contiene un SKU en el campo “seller_custom_field”, puedes probar de la siguiente forma:
  curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?sku=$SELLER_CUSTOM_FIELD&access_token=$ACCESS_TOKEN
 
  • Seller_sku: Si el ítem contiene un SKU en el campo/atributo “SELLER_SKU”, puedes probar así:
  curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?seller_sku=$SELLER_SKU&access_token=$ACCESS_TOKEN

Por estado

  curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?status=active&access_token=$ACCESS_TOKEN

Filtra y ordena los resultados de los ítems del vendedor

Dentro del recurso /users/{user_id}/items/search? están los campos "available_orders" y "available_filters".

¿Cómo ordenar? En este caso deberás agregar “orders” con el ID disponible del orden que quieras aplicar, por ejemplo: “start_time_desc”.

  curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?orders=start_time_desc&access_token=$ACCESS_TOKEN

Nota: Por defecto ya viene con un orden stop_time_asc aplicado.
¿Cómo filtrar? Por ejemplo, para filtrar ítems con listing_type “gold_pro” encontrarás entre los ”available_filters" disponibles el ID "listing_type_id" y dentro de éste el value con ID “gold_pro”.

  curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?listing_type_id=gold_pro&access_token=$ACCESS_TOKEN

Multiget

Utiliza la función Multiget para mejorar la interacción con los recursos de ítems y users, y así poder acceder con una sola llamada a un máximo de 20 resultados. Ten en cuenta que la respuesta utilizando multiget será devuelta en formato verbose, lo que significa que además del json con la información, responderemos con un código que indicará si la consulta fue exitosa o no para cada una de las búsquedas.


Llamada a /ítems:

  curl -X GET https://api.mercadolibre.com/items?ids=$ITEM_ID1,$ITEM_ID2&access_token=$ACCESS_TOKEN

Ejemplo:

  curl -X GET https://api.mercadolibre.com/items?ids=MLA599260060,MLA594239600&access_token=$ACCESS_TOKEN

Respuesta:

  [
     {
      "code": 200,
      "body": {

                "id": "MLA599260060",
                "site_id": "MLA",
                "title": "Item De Test - Por Favor No Ofertar",
                "subtitle": null,
                "seller_id": 303888594,
                "category_id": "MLA401685",
                "official_store_id": null,
                "price": 130,
                "base_price": 130,
                "original_price": null,
                "currency_id": "ARS",
                "initial_quantity": 1,
                "available_quantity": 1,
                "sold_quantity": 0,
                "sale_terms": [],
                [...]
                "automatic_relist": false,
                "date_created": "2018-02-26T18:15:05.000Z",
                "last_updated": "2018-03-29T04:14:39.000Z",
                "health": null
              }
    },
    {
          "code": 200,
           "body": {

                "id": "MLA594239600",
                "site_id": "MLA",
                "title": "Item De Test - Por Favor No Ofertar",
                "subtitle": null,
                "seller_id": 303888594,
                "category_id": "MLA401685",
                "official_store_id": null,
                "price": 120,
                "base_price": 120,
                "original_price": null,
                "currency_id": "ARS",
                "initial_quantity": 1,
                "available_quantity": 1,
                "sold_quantity": 0,
                "sale_terms": [],
                [...]
                "automatic_relist": false,
                "date_created": "2018-02-26T18:15:05.000Z",
                "last_updated": "2018-03-29T04:14:39.000Z",
                "health": null
              }
    }
]

Llamada a /users:

  curl -X GET https://api.mercadolibre.com/users?ids=$USER_ID1,$USER_ID2&access_token=$ACCESS_TOKEN

Ejemplo:

  curl -X GET https://api.mercadolibre.com/users?ids=401114259,287440999&access_token=$ACCESS_TOKEN

Respuesta:

  [
  {
    "code": 200,
    "body": {

      "id": 401114259,
      "nickname": "user_test234",
      "registration_date": "2019-02-05T10:38:03.000-04:00",
      "country_id": "BR",
      "address": {
        "city": null,
        "state": null
      },
      "user_type": "normal",
      "tags": [
        "normal"
      ],
      "logo": null,
      "points": 0,
      "site_id": "MLB",
      "permalink": "http://perfil.mercadolivre.com.br/user_test234",
      "seller_reputation": {
        "level_id": null,
        "power_seller_status": null,
        "transactions": {
          "canceled": 0,
          "completed": 0,
          "period": "historic",
          "ratings": {
            "negative": 0,
            "neutral": 0,
            "positive": 0
          },
          "total": 0
        }
      },
      "buyer_reputation": {
        "tags": [
        ]
      },
      "status": {
        "site_status": "guest"
      }
    }
  },
  {
    "code": 200,
    "body": {
      "id": 287440999,
      "nickname": "user_test111",
      "registration_date": "2019-03-06T00:16:08.000-04:00",
      "country_id": "MX",
      "address": {
        "city": null,
        "state": null
      },
      "user_type": "normal",
      "tags": [
        "normal"
      ],
      "logo": null,
      "points": 0,
      "site_id": "MLM",
      "permalink": "http://perfil.mercadolibre.com.mx/user_test111",
      "seller_reputation": {
        "level_id": null,
        "power_seller_status": null,
        "transactions": {
          "canceled": 0,
          "completed": 0,
          "period": "historic",
          "ratings": {
            "negative": 0,
            "neutral": 0,
            "positive": 0
          },
          "total": 0
        }
      },
      "buyer_reputation": {
        "tags": [
        ]
      },
      "status": {
        "site_status": "active"
      }
    }
  }
]

Selección de campos

Otra alternativa que puedes implementar en el GET a ítems es la selección de campos para recibir solamente aquellos que sean necesarios.
Para poder definir los campos que quieres recibir, deberás agregar el parámetro attributes de la siguiente manera:


Llamada:

  curl -X GET https://api.mercadolibre.com/items?ids=$ITEM_ID1,$ITEM_ID2&attributes=$ATTRIBUTE1,$ATTRIBUTE2,$ATTRIBUTE3&access_token=$ACCESS_TOKEN

Ejemplo:

  curl -X GET https://api.mercadolibre.com/items?ids=MLA599260060,MLA594239600&attributes={id,price,category_id,title}&access_token=$ACCESS_TOKEN

Respuesta:

  [
     {
          "code": 200,
           "body": {

    "id": "MLA599260060",
    "title": "Item De Test - Por Favor No Ofertar",
    "category_id": "MLA401685",
    "price": 130
              }
        }

 {
          "code": 200,
           "body": {

    "id": "MLA594239600",
    "title": "Item De Test - Por Favor No Ofertar",
    "category_id": "MLA401685",
    "official_store_id": null,
    "price": 120,
              }
        }

]

Modo de búsqueda por encima de 1000 registros

Trabajar con Scan + Hash

Todas las búsquedas que se realicen en la API de Items, Preguntas y Respuestas de la forma users/{user_id}/items/search o /questions/search mayor a 1.000 deberán tener el nuevo parámetro search_type=scan sin utilizar el parámetro offset.

Nota: en caso que desees consultar datos menores a 1.000, podrás seguir haciéndolo como hasta ahora (con offset).
Los pasos para consultar más de 1.000 resultados son los siguientes:

  • Agregar search_type=scan a la consulta y quitar el offset.
  • En el resultado obtendrás un campo scroll_id.
  • Deberás agregar a la consulta scroll_id igual al campo obtenido anteriormente.
  • Obtendrás los resultados a partir de los 1.000.
  • En caso de no utilizar el parámetro limit se devolverá por defecto 50 items del total. Podrás agregar un limit máximo de 100.
  • Para seguir obteniendo las próximas páginas de resultados basta con hacer el mismo GET a la llamada hasta llegar al final de la lista.

A continuación te mostraremos paso a paso cómo hacerlo:

  • Agregar search_type=scan
    Para obtener el scroll_id:

Items:

  curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?search_type=scan&access_token=$ACCESS_TOKEN

Questions:

  curl -X GET https://api.mercadolibre.com/questions/search?search_type=scan&item=$ITEM_ID&access_token=$ACCESS_TOKEN

Respuesta:

  "scroll_id": "YXBpY29yZS1pdGVtcw==:ZHMtYXBpY29yZS1pdGVtcy0wMQ==:DXF1ZXJ5QW5kRmV0Y2gBAAAAABIu7AgWMXl6anF3SU5SMVNaQXFxTkZubHBqQQ=="
  • Agregamos el scroll_id= obtenido en el paso anterior:
  curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?search_type=scan&access_token=$ACCESS_TOKEN&scroll_id=YXBpY29yZS1pdGVtcw==:ZHMtYXBpY29yZS1pdGVtcy0wMQ==:DXF1ZXJ5QW5kRmV0Y2gBAAAAABIu7AgWMXl6anF3SU5SMVNaQXFxTkZubHBqQQ==

Para seguir obteniendo las próximas páginas de resultados basta con hacer el mismo GET a la llamada hasta llegar al final de la lista. Sabrás cuando llegue al final cuando devuelva null dicho GET.

Forma parte de nuestra comunidad