Busca de itens

Contenidos

→Resumo dos recursos disponíveis
→Buscar itens por categoria
→Obter itens de uma consulta de busca
→Buscar itens por vendedor
    ↳Obter itens das listagens por vendedor
    ↳Por nickname
    ↳Por ID de vendedor
    ↳Por ID de vendedor para uma categoria específica
→Obtém itens da conta de um vendedor
    ↳Por user_id
    ↳Por SKU
    ↳Por estado
→Filtra e ordena os resultados dos itens do vendedor
→Multiget
→Seleção de campos
→Modo de busca acima de 1000 registros
    ↳Trabalhar com Scan + Hash


Resumo dos recursos disponíveis

Recurso Descripción
/sites/$SITE_ID/search?category=$CATEGORY_ID Obter itens listados numa categoria.
/sites/$SITE_ID/search?q=Motorola%20G6 Obter itens de uma consulta de busca.
/sites/$SITE_ID/search?nickname=$NICKNAME Obter itens das listagens por nickname.
/sites/$SITE_ID/search?seller_id=$SELLER_ID Permite listar itens por vendedor.
/sites/$SITE_ID/search?seller_id=$SELLER_ID&category=$CATEGORY_ID Obter itens das listagens por vendedor numa categoria específica.
/users/$USER_ID/items/search?access_token=$ACCESS_TOKEN Permite listar todos os itens da conta de um vendedor.
/items?ids=$ITEM_ID1,$ITEM_ID2&access_token=$ACCESS_TOKEN Multiget com múltiplos números de itens.
/users?ids=$USER_ID1,$USER_ID2&access_token=$ACCESS_TOKEN Multiget com múltiplos números de usuários.
/items?ids=$ITEM_ID1,$ITEM_ID2&attributes=$ATTRIBUTE1,$ATTRIBUTE2,$ATTRIBUTE3&access_token=$ACCESS_TOKEN Multiget com múltiplos números de itens selecionando apenas os campos de interesse.
/users/$USER_ID/items/search?search_type=scan&access_token=$ACCESS_TOKEN Para obter mais de 1000 registros.

Buscar itens por categoria

Com a chamada seguinte obterá os itens pertencentes a uma categoria.
Leve em consideração que ao início dos resultados você verá os itens que pertençam a um catálogo identificando-os no campo catalog_listing com o valor true.
Documentações recomendadas:
- Para conhecer mais detalhes sobre as categorias e a hierarquia, consulte o guia de Categorias e Atributos a seguir.
- Se tiver interesse em definir uma resposta com paginação de resultados, acesse o seguinte link.
- Lembre que para mais informações sobre catálogo pode clicar aqui.


Chamada:

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

Exemplo:

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

Resposta:

  {
   "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
       }
  ]
}

Obter itens de uma consulta de busca

Com a seguinte chamada, você obterá os itens relacionados com uma consulta.
Lembre que, da mesma forma que com os itens por categoria, no início dos resultados você poderá ver todos os itens pertencentes a um catálogo identificando-os no campo catalog_listing com o valor true.
Para mais informações sobre Catálogo, você pode acessar link.

Chamada:

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

Exemplo:

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

Resposta:

  {
   "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 itens por vendedor

Segundo o tipo de recurso que você utilizar, vai obter os dados seguintes:
Recurso público: /sites/{site_id}/search? poderá obter os resultados de itens ativos diretamente das listagens de Mercado Libre.podrás obtener los resultados de ítems activos directamente de los listados de Mercado Libre.
Recurso privado: /users/{user_id}/items/search?access_token= poderás obter uma listagem dos itens publicados por determinado vendedor desde sua conta.



Obter itens das listagens por vendedor

Esta busca se ajusta às regras das listagens da plataforma. Os resultados sempre serão de itens ativos.


Por nickname

Quando você não conheça o ID do vendedor, mas sim o apelido, poderá tentar realizar a seguinte busca:

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

Por ID de vendedor

Se você já conhece o ID do vendedor, faça apenas o seguinte:

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

Filtros e ordenamentos também poderão ser aplicados.

Dentro de /sites/{site_id}/search? tem os campos "available_sorts" e "available_filters".


Como filtrar? Por exemplo, para filtrar itens com envio sem custo extra, você achará entre os "available_filters" disponíveis o ID "shipping" e, dentro dele, o value com ID “free”.

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

Como ordenar? Neste caso, você deverá adicionar “sort” com o ID disponível da ordem que quiser aplicar, por exemplo: “price_asc”.

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

Observação: Se você não aplicar o filtro de ordem, a busca nas listagens será por defeito segundo sua relevância.

Da mesma forma, também será aplicado o método de ordem nos itens de catálogo, isto é, os primeiros resultados visíveis.



Por ID de vendedor para uma categoria específica

Utilizando o seguinte exemplo, você poderá buscar dentro de uma categoria específica.
Com a seguinte chamada, você poderá consultar as publicações de categorias específicas.

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

Obtém itens da conta de um vendedor

Esta busca é realizada diretamente sobre a conta do vendedor, portanto, o recurso é privado e você precisa um access_token.


Por user_id

Se você já conhece o user_id, faça apenas o seguinte:

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

Por SKU

  • Seller_custom_field: se o item contém um SKU no campo “seller_custom_field”, você pode tentar na forma a seguir:
  curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?sku=$SELLER_CUSTOM_FIELD&access_token=$ACCESS_TOKEN
 
  • Seller_sku: Se o item contiver um SKU no campo/atributo “SELLER_SKU”, você pode tentar assim:
  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 e ordena os resultados dos itens do vendedor

Dentro do recurso /users/{user_id}/items/search? tem os campos "available_orders" e "available_filters".


Como ordenar? Nesse caso, você deverá adicionar “orders” com o ID disponível da ordem que quiser aplicar, por exemplo: “start_time_desc”.

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

Observação: Por defeito, já vem com uma ordem stop_time_asc aplicada.

Como filtrar? Por exemplo, para filtrar itens com listing_type “gold_pro”, entre os ”available_filters" disponíveis achará o ID "listing_type_id" e, dentro dele, o value com 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 a função Multiget para melhorar a interação com os recursos de itens e users e poder acessar assim um máximo de 20 resultados com uma única chamada. Lembre que a resposta utilizando multiget será restituída no formato verbose, o que significa que, além do JSON com as informações, responderemos com um código que vai indicar se a consulta foi exitosa ou não, para cada uma das buscas.


Chamada a /itens:

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

Exemplo:

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

Resposta:

  [
     {
      "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
              }
    }
]

Chamada a /users:

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

Exemplo:

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

Resposta:

  [
  {
    "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"
      }
    }
  }
]

Seleção de campos

Outra alternativa que você pode implementar no GET para itens na seleção de campos, para receber somente aqueles que sejam necessários.
Para poder definir os campos que você queira receber, deverá adicionar o parâmetro attributes na forma seguinte:


Chamada:

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

Exemplo:

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

Resposta:

  [
     {
          "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 busca acima de 1000 registros

Trabalhar com Scan + Hash

Todas as buscas que forem realizadas no API de Itens, Perguntas e Respostas da forma users/{user_id}/items/search ou /questions/search maior de 1000 deverão ter o novo parâmetro search_type=scan sem utilizar o parâmetro offset.

Observação: se desejar consultar dados menores de 1000, você poderá continuar fazendo como até agora (com offset).
Siga os passos a seguir para consultar mais de 1000 resultados:

  • Adicione search_type=scan à consulta e remova o offset.
  • No resultado, vai obter um campo scroll_id.
  • Deverá adicionar à consulta scroll_id igual ao campo obtido anteriormente.
  • Obterá os resultados a partir de 1000.
  • Se não utilizar o parâmetro limit, serão restituídos por defeito 50 itens do total. Você poderá adicionar um limite máximo de 100.
  • Para continuar obtendo as próximas páginas de resultados, é só fazer o mesmo GET à chamada até chegar ao fim da listagem.

A seguir mostramos passo por passo como fazê-lo:

  • Adicionar search_type=scan
    Para obter o scroll_id:

Itens:

  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

Resposta:

  "scroll_id": "YXBpY29yZS1pdGVtcw==:ZHMtYXBpY29yZS1pdGVtcy0wMQ==:DXF1ZXJ5QW5kRmV0Y2gBAAAAABIu7AgWMXl6anF3SU5SMVNaQXFxTkZubHBqQQ=="
  • Adicionamos o scroll_id= obtido no passo 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 continuar obtendo as próximas páginas de resultados, você deverá fazer o mesmo GET à chamada até chegar ao final da listagem. Você saberá quando chegar ao final quando esse GET aparecer null.

Faça parte da nossa comunidade