Items & Searches

Contents

→Summary of available resources
→Values in sold_quantity and available_quantity fields
    ↳sold_quantity
    ↳available_quantity
→Get items by a search query
→Search items by seller
    ↳Get items from the listings by seller
    ↳By seller ID
    ↳By nickname
    ↳By seller ID to an specific category
→Get items from a seller account
    ↳By user_id
    ↳By SKU
    ↳By status
→Filter and sort the results of the seller's items
→Multiget
→Fields selection
→Search mode above 1000 records
    ↳Work with Scan + Hash
→Get the items mappings


Summary of available resources

Resource Description
/sites/$SITE_ID/search?category=$CATEGORY_ID Get items listed in a category.
/sites/$SITE_ID/search?q=Motorola%20G6 Get items from a search query.
/sites/$SITE_ID/search?nickname=$NICKNAME Get items from the listings by nickname.
/sites/$SITE_ID/search?seller_id=$SELLER_ID Can list items by seller.
/sites/$SITE_ID/search?seller_id=$SELLER_ID&category=$CATEGORY_ID Get items from listings by seller in a specific category.
/users/$USER_ID/items/search?access_token=$ACCESS_TOKEN Can list all a seller account´s items.
/items?ids=$ITEM_ID1,$ITEM_ID2&access_token=$ACCESS_TOKEN Multiget with multiple numbers of items.
/users?ids=$USER_ID1,$USER_ID2&access_token=$ACCESS_TOKEN Multiget with multiple numbers of users.
/items?ids=$ITEM_ID1,$ITEM_ID2&attributes=$ATTRIBUTE1,$ATTRIBUTE2,$ATTRIBUTE3&access_token=$ACCESS_TOKEN Multiget with multiple numbers of items selecting only the fields of interest.
/users/$USER_ID/items/search?search_type=scan&access_token=$ACCESS_TOKEN To get more than 1000 records.
/items/$ITEM_ID/marketplace_items To get the mapping between an item on the global site and the marketplace items.


Values in sold_quantity and available_quantity fields

In the public resources of Items and Searches, the information of the "sold_quantity" and "available_quantity" fields will be referential with the following values:


sold_quantity

Real data Reference
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

Real data Reference
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

Get items by a search query

With the next request you will get the items related to a query.


Request:

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

Example:

curl -X GET https://api.mercadolibre.com/sites/MLM/search?q=S20

Response:

{
  "site_id": "MLM",
  "query": "S20 ",
  "paging": {
    "total": 125,
    "offset": 0,
    "limit": 50,
    "primary_results": 51
  },
  "results": [{
    "id": "MLM773419330",
    "site_id": "MLM",
    "title": "Samsung Galaxy S20+ 128 Gb Cloud Blue 8 Gb Ram",
    "seller": {
      "id": 216279816,
      "permalink": null,
      "power_seller_status": null,
      "car_dealer": false,
      "real_estate_agency": false,
      "tags": []
    },
    "price": 23999,
    "currency_id": "MXN",
    "available_quantity": 1,
    "sold_quantity": 0,
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_pro",
    "stop_time": "2040-04-28T04:00:00.000Z",
    "condition": "new",
    "permalink": "https://www.mercadolibre.com.mx/samsung-galaxy-s20-128-gb-cloud-blue-8-gb-ram/p/MLM15482173",
    "thumbnail": "http://mlm-s1-p.mlstatic.com/611803-MLA41571767053_042020-I.jpg",
    "accepts_mercadopago": true,
    "installments": {
      "quantity": 12,
      "amount": 1999.92,
      "rate": 0,
      "currency_id": "MXN"
    },
    "address": {
      "state_id": "MX-JAL",
      "state_name": "Jalisco",
      "city_id": "TUxNQ1pBUDM4NzE",
      "city_name": "Zapopan"
    },
    "shipping": {
      "free_shipping": true,
      "mode": "me2",
      "tags": [
        "mandatory_free_shipping"
      ],
      "logistic_type": "drop_off",
      "store_pick_up": false
    },
    "seller_address": {
      "id": "",
      "comment": "",
      "address_line": "",
      "zip_code": "",
      "country": {
        "id": "MX",
        "name": "Mexico"
      },
      "state": {
        "id": "MX-JAL",
        "name": "Jalisco"
      },
      "city": {
        "id": "TUxNQ1pBUDM4NzE",
        "name": "Zapopan"
      },
      "latitude": "",
      "longitude": ""
    },
    "attributes": [{
        "value_id": "206",
        "value_struct": null,
        "attribute_group_id": "OTHERS",
        "source": 1,
        "id": "BRAND",
        "name": "Marca",
        "value_name": "Samsung",
        "values": [{
          "source": 1,
          "id": "206",
          "name": "Samsung",
          "struct": null
        }],
        "attribute_group_name": "Otros"
      },
      {
        "value_id": "8202725",
        "value_name": "2x2.73 GHz Mongoose M5/2x2.5 GHz Cortex-A76/4x2 GHz Cortex-A55",
        "values": [{
          "id": "8202725",
          "name": "2x2.73 GHz Mongoose M5/2x2.5 GHz Cortex-A76/4x2 GHz Cortex-A55",
          "struct": null,
          "source": 1
        }],
        "attribute_group_name": "Otros",
        "source": 1,
        "id": "CPU_MODEL",
        "name": "Modelo de CPU",
        "value_struct": null,
        "attribute_group_id": "OTHERS"
      },
      {
        "name": "Modelo de GPU",
        "value_struct": null,
        "values": [{
          "id": "8202445",
          "name": "Mali-G77 MP11",
          "struct": null,
          "source": 1
        }],
        "attribute_group_id": "OTHERS",
        "attribute_group_name": "Otros",
        "source": 1,
        "id": "GPU_MODEL",
        "value_id": "8202445",
        "value_name": "Mali-G77 MP11"
      },
      {
        "id": "ITEM_CONDITION",
        "value_struct": null,
        "attribute_group_id": "OTHERS",
        "source": 1505,
        "attribute_group_name": "Otros",
        "name": "Condición del ítem",
        "value_id": "2230284",
        "value_name": "Nuevo",
        "values": [{
          "struct": null,
          "source": 1505,
          "id": "2230284",
          "name": "Nuevo"
        }]
      },
      {
        "value_struct": null,
        "attribute_group_name": "Otros",
        "value_id": "249991",
        "value_name": "Galaxy S",
        "values": [{
          "id": "249991",
          "name": "Galaxy S",
          "struct": null,
          "source": 1
        }],
        "attribute_group_id": "OTHERS",
        "source": 1,
        "id": "LINE",
        "name": "Línea"
      },
      {
        "value_name": "S20+",
        "values": [{
          "id": "8081585",
          "name": "S20+",
          "struct": null,
          "source": 1
        }],
        "attribute_group_name": "Otros",
        "source": 1,
        "id": "MODEL",
        "value_id": "8081585",
        "value_struct": null,
        "attribute_group_id": "OTHERS",
        "name": "Modelo"
      },
      {
        "value_struct": null,
        "values": [{
          "source": 1,
          "id": "8202439",
          "name": "Exynos 990",
          "struct": null
        }],
        "attribute_group_name": "Otros",
        "source": 1,
        "id": "PROCESSOR_MODEL",
        "name": "Modelo del procesador",
        "value_id": "8202439",
        "value_name": "Exynos 990",
        "attribute_group_id": "OTHERS"
      }
    ],
    "differential_pricing": {
      "id": 19568774
    },
    "original_price": null,
    "category_id": "MLM1055",
    "official_store_id": null,
    "catalog_product_id": "MLM15482173",
    "tags": [
      "extended_warranty_eligible",
      "good_quality_picture",
      "good_quality_thumbnail",
      "immediate_payment",
      "cart_eligible"
    ],
    "catalog_listing": true
  }],
  "secondary_results": [],
  "related_results": [],
  "sort": {
    "id": "relevance",
    "name": "Más relevantes"
  },
  "available_sorts": [{
      "id": "price_asc",
      "name": "Menor precio"
    },
    {
      "id": "price_desc",
      "name": "Mayor precio"
    }
  ],
  "filters": [{
      "id": "category",
      "name": "Categorías",
      "type": "text",
      "values": [{
        "id": "MLM1055",
        "name": "Celulares y Smartphones",
        "path_from_root": [{
            "id": "MLM1051",
            "name": "Celulares y Telefonía"
          },
          {
            "id": "MLM1055",
            "name": "Celulares y Smartphones"
          }
        ]
      }]
    },
    {
      "id": "BRAND",
      "name": "Marca",
      "type": "STRING",
      "values": [{
        "id": "206",
        "name": "Samsung"
      }]
    }
  ],
  "available_filters": [{
      "id": "official_store",
      "name": "Tiendas oficiales",
      "type": "text",
      "values": [{
          "id": "all",
          "name": "Todas las tiendas oficiales",
          "results": 14
        },
        {
          "id": "2160",
          "name": "Hmovil",
          "results": 5
        },
        {
          "id": "2037",
          "name": "Celulandia",
          "results": 4
        },
        {
          "id": "295",
          "name": "Samsung",
          "results": 3
        },
        {
          "id": "2322",
          "name": "Phone Depot",
          "results": 2
        }
      ]
    },
    {
      "id": "discount",
      "name": "Descuentos",
      "type": "range",
      "values": [{
        "id": "10-100",
        "name": "Desde 10% off",
        "results": 4
      }]
    },

    {
      "id": "price",
      "name": "Precio",
      "type": "range",
      "values": [{
          "id": "*-20000.0",
          "name": "Hasta $20,000",
          "results": 38
        },
        {
          "id": "20000.0-*",
          "name": "Más de $20,000",
          "results": 82
        }
      ]
    },
    {
      "id": "accepts_mercadopago",
      "name": "Filtro por MercadoPago",
      "type": "boolean",
      "values": [{
        "id": "yes",
        "name": "Con MercadoPago",
        "results": 120
      }]
    },
    {
      "id": "installments",
      "name": "Pago",
      "type": "text",
      "values": [{
          "id": "yes",
          "name": "En mensualidades",
          "results": 116
        },
        {
          "id": "no_interest",
          "name": "Meses sin intereses",
          "results": 28
        }
      ]
    },
    {
      "id": "shipping",
      "name": "Tipo de envío",
      "type": "text",
      "values": [{
          "id": "mercadoenvios",
          "name": "Mercado Envíos",
          "results": 119
        },
        {
          "id": "fulfillment",
          "name": "Full",
          "results": 3
        }
      ]
    },
    {
      "id": "power_seller",
      "name": "Filtro por calidad de vendedores",
      "type": "boolean",
      "values": [{
        "id": "yes",
        "name": "Mejores vendedores",
        "results": 17
      }]
    },
    {
      "id": "since",
      "name": "Filtro por fecha de comienzo",
      "type": "text",
      "values": [{
        "id": "today",
        "name": "Publicados hoy",
        "results": 12
      }]
    },
    {
      "id": "has_video",
      "name": "Filtro por publicaciones con video",
      "type": "boolean",
      "values": [{
        "id": "yes",
        "name": "Publicaciones con video",
        "results": 10
      }]
    },
    {
      "id": "has_pictures",
      "name": "Filtro por publicaciones con imágenes",
      "type": "boolean",
      "values": [{
        "id": "yes",
        "name": "Con fotos",
        "results": 120
      }]
    },
    {
      "id": "shipping_cost",
      "name": "Costo de envío",
      "type": "text",
      "values": [{
        "id": "free",
        "name": "Gratis",
        "results": 103
      }]
    },
    {
      "id": "CARRIER",
      "name": "Compañía telefónica",
      "type": "STRING",
      "values": [{
          "id": "298335",
          "name": "Desbloqueado",
          "results": 97
        },
        {
          "id": "2120856",
          "name": "Telcel",
          "results": 21
        },
        {
          "id": "162191",
          "name": "AT&T",
          "results": 2
        }
      ]
    },
    {
      "id": "INTERNAL_MEMORY",
      "name": "Memoria interna",
      "type": "range",
      "values": [{
          "id": "(*-256GB)",
          "name": "Menos de 256 GB",
          "results": 109
        },
        {
          "id": "[256GB-512GB)",
          "name": "256 a 511 GB",
          "results": 4
        },
        {
          "id": "[512GB-*)",
          "name": "512 GB o más",
          "results": 6
        }
      ]
    },
    {
      "id": "IS_DUAL_SIM",
      "name": "Otras características",
      "type": "boolean",
      "values": [{
        "id": "242085",
        "name": "Es Dual SIM",
        "results": 27
      }]
    },
    {
      "id": "ITEM_CONDITION",
      "name": "Condición",
      "type": "STRING",
      "values": [{
          "id": "2230284",
          "name": "Nuevo",
          "results": 98
        },
        {
          "id": "2230581",
          "name": "Usado",
          "results": 22
        }
      ]
    },
    {
      "id": "LINE",
      "name": "Línea",
      "type": "STRING",
      "values": [{
          "id": "249991",
          "name": "Galaxy S",
          "results": 112
        },
        {
          "id": "43675",
          "name": "Galaxy",
          "results": 7
        }
      ]
    },
    {
      "id": "MODEL",
      "name": "Modelo",
      "type": "STRING",
      "values": [{
          "id": "8081585",
          "name": "S20+",
          "results": 34
        },
        {
          "id": "6358",
          "name": "S20",
          "results": 19
        },
        {
          "id": "8081589",
          "name": "S20 Ultra",
          "results": 16
        },
        {
          "id": "8081591",
          "name": "S20 Ultra 5G",
          "results": 8
        },
        {
          "id": "8081587",
          "name": "S20+ 5G",
          "results": 8
        },
        {
          "id": "8081582",
          "name": "S20 Duos",
          "results": 8
        },
        {
          "id": "8081586",
          "name": "S20+ Duos",
          "results": 6
        },
        {
          "id": "8081592",
          "name": "S20 Ultra 5G Duos",
          "results": 5
        },
        {
          "id": "8081588",
          "name": "S20+ 5G Duos",
          "results": 5
        },
        {
          "id": "8081590",
          "name": "S20 Ultra Duos",
          "results": 2
        },
        {
          "id": "8081584",
          "name": "S20 5G Duos",
          "results": 1
        },
        {
          "id": "8081583",
          "name": "S20 5G",
          "results": 1
        }
      ]
    },
    {
      "id": "WITH_FINGERPRINT_READER",
      "name": "Otras características",
      "type": "boolean",
      "values": [{
        "id": "242085",
        "name": "Con lector de huella digital",
        "results": 80
      }]
    }
  ]
}

Search items by seller

Depending on the type of resource you use, you will obtain the following data:
Public resource: /sites/{site_id}/search? You can get the results of active items directly from the Global Selling listings. Private resource: /users/{user_id}/items/search?access_token= You can obtain a list of the items published by a specific seller from your account. Only global items can be searched.


Get items from the listings by seller

This search conforms to the rules of the platform listings. The results will always be of active items.


By seller ID

If you already know the seller's ID, just do the following:

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

By nickname

When you do not know the seller_id of a user but the nickname, you can try the following search:

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

You can also apply different filters and systems.


Into /sites/{site_id}/search? are "available_sorts" and "available_filters" fields.


How to filter? For example, to filter items with free shipping, you will find the "shipping" ID available among the "available_filters" and within it the value with "free" ID.

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

How to order? In this case you must add “sort” with the available ID of the order you want to apply, for example: “price_asc”.

curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/search?seller_id=$SELLER_ID&sort=price_asc
Note:
By default the search in the listings already comes with a defined order of relevance.


By seller ID to an specific category

Using the following example you can search within a specific category.
With the next request you can check the publications of specific categories.

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

Get items from a seller account

This search is performed directly on the seller's account, so the resource is private and an access_token is required.


By user_id

If you already know the user_id, just do the following:

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

By SKU

  • Seller_custom_field: if the item contains a SKU in the “seller_custom_field” field, you can try as follows:
curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?sku=$SELLER_CUSTOM_FIELD&access_token=$ACCESS_TOKEN
  • Seller_sku: If the item contains a SKU in the “SELLER_SKU” field /attribute, you can try like this:
curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?seller_sku=$SELLER_SKU&access_token=$ACCESS_TOKEN

By status

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

Filter and sort the results of the seller's items

Inside the resource /users/{user_id}/items/search? there are the "available_orders" and "available_filters" fields.

How to order? In this case you must add “orders” with the available ID of the order you want to apply, for example: “start_time_desc”.

curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?orders=start_time_desc&access_token=$ACCESS_TOKEN
Note:
By default it already comes with a stop_time_asc order applied.
How to filter? For example, to filter items with listing_type "gold_pro" you will find the "listing_type_id" available among the "available_filters" and within it the value with "gold_pro" ID.

curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?listing_type_id=gold_pro&access_token=$ACCESS_TOKEN
Note:
The use of our item search resource from a seller does not replace the use of item notifications. This is always to have the most consistent and up-to-date integration about the publication data of the vendors that work with your application.

Multiget

Use the Multiget function to improve the interaction with the resources of items and users, and thus be able to access with a single request to a maximum of 20 results. Keep in mind that the response using multiget will be returned in verb format, which means that in addition to the json with the information, we will respond with a code that will indicate if the query was successful or not for each of the searches.


Request to /ítems:

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

Example:

curl -X GET http://api.mercadolibre.com/items?ids=CBT910553725,CBT910547444&access_token=$ACCESS_TOKEN

Response:

[{
    "code": 200,
    "body": {
      "id": "CBT910547444",
      "site_id": "CBT",
      "title": "Test Item - For Loadtest Tests",
      "subtitle": null,
      "seller_id": 523130418,
      "category_id": "CBT11796",
      "official_store_id": null,
      "price": 15.1,
      "base_price": 15.1,
      "original_price": null,
      "inventory_id": null,
      "currency_id": "USD",
      "initial_quantity": 100,
      "available_quantity": 100,
      "sold_quantity": 0,
      "sale_terms": [{
          "id": "WARRANTY_TYPE",
          "name": "Type of warranty",
          "value_id": "2230279",
          "value_name": "Factory warranty",
          "value_struct": null,
          "values": [{
            "id": "2230279",
            "name": "Factory warranty",
            "struct": null
          }]
        },
        {
          "id": "WARRANTY_TIME",
          "name": "Warranty time",
          "value_id": null,
          "value_name": "90 days",
          "value_struct": {
            "number": 90,
            "unit": "days"
          },
          "values": [{
            "id": null,
            "name": "90 days",
            "struct": {
              "number": 90,
              "unit": "days"
            }
          }]
        }
      ],
      "buying_mode": "buy_it_now",
      "listing_type_id": "gold_pro",
      "start_time": "2020-02-27T14:42:20.000Z",
      "historical_start_time": "2020-02-27T14:42:20.000Z",
      "stop_time": "2020-02-27T14:43:18.000Z",
      "end_time": "2040-02-22T04:00:00.000Z",
      "expiration_time": "2020-05-17T14:42:20.000Z",
      "condition": "new",
      "permalink": "",
      "thumbnail": "http://cbt-s1-p.mlstatic.com/691535-MLA29134565196_012019-I.jpg",
      "secure_thumbnail": "https://cbt-s1-p.mlstatic.com/691535-MLA29134565196_012019-I.jpg",
      "pictures": [{
        "id": "691535-MLA29134565196_012019",
        "url": "http://cbt-s1-p.mlstatic.com/691535-MLA29134565196_012019-O.jpg",
        "secure_url": "https://cbt-s1-p.mlstatic.com/691535-MLA29134565196_012019-O.jpg",
        "size": "500x500",
        "max_size": "500x500",
        "quality": ""
      }],
      "video_id": null,
      "descriptions": [{
        "id": "CBT910547444-2538852389"
      }],
      "accepts_mercadopago": true,
      "non_mercado_pago_payment_methods": [],
      "shipping": {
        "mode": "not_specified",
        "methods": [],
        "tags": [],
        "dimensions": null,
        "local_pick_up": false,
        "free_shipping": false,
        "logistic_type": "not_specified",
        "store_pick_up": false
      },
      "international_delivery_mode": "none",
      "seller_address": {
        "address_line": "498 NW 3rd Av",
        "zip_code": "12345",
        "city": {
          "id": "Q04tQ1FDaG9uZ3Fpbmc",
          "name": "Chongqing"
        },
        "state": {
          "id": "CN-CQ",
          "name": "Chongqing"
        },
        "country": {
          "id": "CN",
          "name": "China"
        },
        "id": 1086581840
      },
      "seller_contact": null,
      "location": {},
      "coverage_areas": [],
      "attributes": [{
          "id": "BRAND",
          "name": "Brand",
          "value_id": null,
          "value_name": "DOMINIQ",
          "value_struct": null,
          "values": [{
            "id": null,
            "name": "DOMINIQ",
            "struct": null
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        },
        {
          "id": "GENDER",
          "name": "Gender",
          "value_id": "371795",
          "value_name": "Babies",
          "value_struct": null,
          "values": [{
            "id": "371795",
            "name": "Babies",
            "struct": null
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        },
        {
          "id": "ITEM_CONDITION",
          "name": "Item condition",
          "value_id": "2230284",
          "value_name": "New",
          "value_struct": null,
          "values": [{
            "id": "2230284",
            "name": "New",
            "struct": null
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        },
        {
          "id": "MODEL",
          "name": "Model",
          "value_id": null,
          "value_name": "A-59081-6",
          "value_struct": null,
          "values": [{
            "id": null,
            "name": "A-59081-6",
            "struct": null
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        },
        {
          "id": "PACKAGE_HEIGHT",
          "name": "Package height",
          "value_id": null,
          "value_name": "10 cm",
          "value_struct": {
            "number": 10,
            "unit": "cm"
          },
          "values": [{
            "id": null,
            "name": "10 cm",
            "struct": {
              "number": 10,
              "unit": "cm"
            }
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        },
        {
          "id": "PACKAGE_LENGTH",
          "name": "Package length",
          "value_id": null,
          "value_name": "10 cm",
          "value_struct": {
            "number": 10,
            "unit": "cm"
          },
          "values": [{
            "id": null,
            "name": "10 cm",
            "struct": {
              "number": 10,
              "unit": "cm"
            }
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        },
        {
          "id": "PACKAGE_WEIGHT",
          "name": "Package weight",
          "value_id": null,
          "value_name": "0.7 lb",
          "value_struct": {
            "number": 0.7,
            "unit": "lb"
          },
          "values": [{
            "id": null,
            "name": "0.7 lb",
            "struct": {
              "number": 0.7,
              "unit": "lb"
            }
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        },
        {
          "id": "PACKAGE_WIDTH",
          "name": "Package width",
          "value_id": null,
          "value_name": "10 cm",
          "value_struct": {
            "number": 10,
            "unit": "cm"
          },
          "values": [{
            "id": null,
            "name": "10 cm",
            "struct": {
              "number": 10,
              "unit": "cm"
            }
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        }
      ],
      "warnings": [],
      "listing_source": "",
      "variations": [],
      "status": "closed",
      "sub_status": [],
      "tags": [
        "immediate_payment"
      ],
      "catalog_product_id": null,
      "domain_id": "CBT-BABIES_FOOTWEAR",
      "seller_custom_field": null,
      "parent_item_id": null,
      "differential_pricing": null,
      "deal_ids": [],
      "automatic_relist": false,
      "date_created": "2020-02-27T14:42:20.000Z",
      "last_updated": "2020-04-29T17:37:36.000Z",
      "total_listing_fee": null,
      "health": null,
      "catalog_listing": false,
      "item_relations": []
    }
  },
  {
    "code": 200,
    "body": {
      "id": "CBT910553725",
      "site_id": "CBT",
      "title": "Test Item - For Loadtest Tests",
      "subtitle": null,
      "seller_id": 523130418,
      "category_id": "CBT11796",
      "official_store_id": null,
      "price": 15.1,
      "base_price": 15.1,
      "original_price": null,
      "inventory_id": null,
      "currency_id": "USD",
      "initial_quantity": 0,
      "available_quantity": 0,
      "sold_quantity": 0,
      "sale_terms": [{
          "id": "WARRANTY_TYPE",
          "name": "Type of warranty",
          "value_id": "2230279",
          "value_name": "Factory warranty",
          "value_struct": null,
          "values": [{
            "id": "2230279",
            "name": "Factory warranty",
            "struct": null
          }]
        },
        {
          "id": "WARRANTY_TIME",
          "name": "Warranty time",
          "value_id": null,
          "value_name": "90 days",
          "value_struct": {
            "number": 90,
            "unit": "days"
          },
          "values": [{
            "id": null,
            "name": "90 days",
            "struct": {
              "number": 90,
              "unit": "days"
            }
          }]
        }
      ],
      "buying_mode": "buy_it_now",
      "listing_type_id": "gold_pro",
      "start_time": "2020-02-27T11:54:07.000Z",
      "historical_start_time": "2020-02-27T11:54:07.000Z",
      "stop_time": "2020-02-27T14:39:05.000Z",
      "end_time": "2040-02-22T04:00:00.000Z",
      "expiration_time": "2020-05-17T12:17:21.000Z",
      "condition": "new",
      "permalink": "",
      "thumbnail": "http://cbt-s2-p.mlstatic.com/691535-MLA29134565196_012019-I.jpg",
      "secure_thumbnail": "https://cbt-s2-p.mlstatic.com/691535-MLA29134565196_012019-I.jpg",
      "pictures": [{
        "id": "691535-MLA29134565196_012019",
        "url": "http://cbt-s2-p.mlstatic.com/691535-MLA29134565196_012019-O.jpg",
        "secure_url": "https://cbt-s2-p.mlstatic.com/691535-MLA29134565196_012019-O.jpg",
        "size": "500x500",
        "max_size": "500x500",
        "quality": ""
      }],
      "video_id": null,
      "descriptions": [{
        "id": "CBT910553725-2538613302"
      }],
      "accepts_mercadopago": true,
      "non_mercado_pago_payment_methods": [],
      "shipping": {
        "mode": "not_specified",
        "methods": [],
        "tags": [],
        "dimensions": null,
        "local_pick_up": false,
        "free_shipping": false,
        "logistic_type": "not_specified",
        "store_pick_up": false
      },
      "international_delivery_mode": "none",
      "seller_address": {
        "address_line": "498 NW 3rd Av",
        "zip_code": "12345",
        "city": {
          "id": "Q04tQ1FDaG9uZ3Fpbmc",
          "name": "Chongqing"
        },
        "state": {
          "id": "CN-CQ",
          "name": "Chongqing"
        },
        "country": {
          "id": "CN",
          "name": "China"
        },
        "id": 1086581840
      },
      "seller_contact": null,
      "location": {},
      "coverage_areas": [],
      "attributes": [{
          "id": "BRAND",
          "name": "Brand",
          "value_id": null,
          "value_name": "DOMINIQ",
          "value_struct": null,
          "values": [{
            "id": null,
            "name": "DOMINIQ",
            "struct": null
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        },
        {
          "id": "GENDER",
          "name": "Gender",
          "value_id": "371795",
          "value_name": "Babies",
          "value_struct": null,
          "values": [{
            "id": "371795",
            "name": "Babies",
            "struct": null
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        },
        {
          "id": "ITEM_CONDITION",
          "name": "Item condition",
          "value_id": "2230284",
          "value_name": "New",
          "value_struct": null,
          "values": [{
            "id": "2230284",
            "name": "New",
            "struct": null
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        },
        {
          "id": "MODEL",
          "name": "Model",
          "value_id": null,
          "value_name": "A-59081-6",
          "value_struct": null,
          "values": [{
            "id": null,
            "name": "A-59081-6",
            "struct": null
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        },
        {
          "id": "PACKAGE_HEIGHT",
          "name": "Package height",
          "value_id": null,
          "value_name": "10 cm",
          "value_struct": {
            "number": 10,
            "unit": "cm"
          },
          "values": [{
            "id": null,
            "name": "10 cm",
            "struct": {
              "number": 10,
              "unit": "cm"
            }
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        },
        {
          "id": "PACKAGE_LENGTH",
          "name": "Package length",
          "value_id": null,
          "value_name": "10 cm",
          "value_struct": {
            "number": 10,
            "unit": "cm"
          },
          "values": [{
            "id": null,
            "name": "10 cm",
            "struct": {
              "number": 10,
              "unit": "cm"
            }
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        },
        {
          "id": "PACKAGE_WEIGHT",
          "name": "Package weight",
          "value_id": null,
          "value_name": "0.7 lb",
          "value_struct": {
            "number": 0.7,
            "unit": "lb"
          },
          "values": [{
            "id": null,
            "name": "0.7 lb",
            "struct": {
              "number": 0.7,
              "unit": "lb"
            }
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        },
        {
          "id": "PACKAGE_WIDTH",
          "name": "Package width",
          "value_id": null,
          "value_name": "10 cm",
          "value_struct": {
            "number": 10,
            "unit": "cm"
          },
          "values": [{
            "id": null,
            "name": "10 cm",
            "struct": {
              "number": 10,
              "unit": "cm"
            }
          }],
          "attribute_group_id": "OTHERS",
          "attribute_group_name": "Others"
        }
      ],
      "warnings": [],
      "listing_source": "",
      "variations": [],
      "status": "closed",
      "sub_status": [],
      "tags": [
        "immediate_payment"
      ],
      "catalog_product_id": null,
      "domain_id": "CBT-BABIES_FOOTWEAR",
      "seller_custom_field": null,
      "parent_item_id": null,
      "differential_pricing": null,
      "deal_ids": [],
      "automatic_relist": false,
      "date_created": "2020-02-27T11:54:07.000Z",
      "last_updated": "2020-04-25T07:46:01.000Z",
      "total_listing_fee": null,
      "health": null,
      "catalog_listing": false,
      "item_relations": []
    }
  }
]

Request to /users:

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

Example:

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

Response:

[
   {
      "code":200,
      "body":{
         "id":523132944,
         "nickname":"TETE2690266",
         "registration_date":"2020-02-05T20:22:27.000-04:00",
         "country_id":"MX",
         "address":{
            "city":"Cuautitlan Izcalli",
            "state":"MX-MEX"
         },
         "user_type":"normal",
         "tags":[
            "normal",
            "test_user",
            "international_seller",
            "large_seller"
         ],
         "logo":null,
         "points":100,
         "site_id":"MLM",
         "permalink":"http://perfil.mercadolibre.com.mx/TETE2690266",
         "seller_reputation":{
            "level_id":"1_red",
            "power_seller_status":null,
            "transactions":{
               "canceled":5,
               "completed":23,
               "period":"historic",
               "ratings":{
                  "negative":0,
                  "neutral":1,
                  "positive":0
               },
               "total":28
            }
         },
         "buyer_reputation":{
            "tags":[

            ]
         },
         "status":{
            "site_status":"active"
         }
      }
   },
   {
      "code":200,
      "body":{
         "id":523133081,
         "nickname":"TETE2455145",
         "registration_date":"2020-02-05T20:23:32.000-04:00",
         "country_id":"BR",
         "address":{
            "city":"São Paulo",
            "state":"BR-SP"
         },
         "user_type":"normal",
         "tags":[
            "normal",
            "test_user",
            "international_seller",
            "large_seller"
         ],
         "logo":null,
         "points":100,
         "site_id":"MLB",
         "permalink":"http://perfil.mercadolivre.com.br/TETE2455145",
         "seller_reputation":{
            "level_id":null,
            "power_seller_status":null,
            "transactions":{
               "canceled":0,
               "completed":2,
               "period":"historic",
               "ratings":{
                  "negative":0,
                  "neutral":1,
                  "positive":0
               },
               "total":2
            }
         },
         "buyer_reputation":{
            "tags":[

            ]
         },
         "status":{
            "site_status":"active"
         }
      }
   }
]

Fields selection

Another alternative that you can implement in the GET to items is the selection of fields to receive only those that are necessary.
In order to define the fields you want to receive, you must add the attributes parameter as follows:


Request:

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

Example:

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

Response:

[
    {
        "code": 200,
        "body": {
            "title": "Test Item - For Loadtest Tests",
            "id": "CBT910547444",
            "category_id": "CBT11796",
            "price": 15.1
        }
    },
    {
        "code": 200,
        "body": {
            "category_id": "CBT11796",
            "price": 15.1,
            "id": "CBT910553725",
            "title": "Test Item - For Loadtest Tests"
        }
    }
]

Search mode above 1000 records

Work with Scan + Hash

All searches performed in the Items, Questions and Answers API of the form users/{user_id}/items/search or /questions/search greater than 1000 must have the new search_type = scan parameter without using the offset parameter.

Note:
If you want to consult data less than 1000, you can continue doing it as before (with offset).

The steps to consult more than 1000 results are as follows:

  • Add search_type=scan to queerrry and quit the offset.
  • In the result, you will get a scroll_id field that expires after 5 minutes.
  • You must add to the query scroll_id equal to the field obtained previously.
  • You will get the results from 1000.
  • If the limit parameter is not used, 50 items of the total will be returned by default. You can add a maximum limit of 100.
  • To continue to obtain the next pages of results, just make the same GET to the request until you reach the end of the list.

You can learn how do it:

  • Add search_type=scan
    To get the scroll_id:

Items:

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

Response:

"scroll_id": "YXBpY29yZS1pdGVtcw==:ZHMtYXBpY29yZS1pdGVtcy0wMQ==:DXF1ZXJ5QW5kRmV0Y2gBAAAAABIu7AgWMXl6anF3SU5SMVNaQXFxTkZubHBqQQ=="
  • We add the scroll_id= obtained in the previous step:
curl -X GET https://api.mercadolibre.com/users/$USER_ID/items/search?search_type=scan&access_token=$ACCESS_TOKEN&scroll_id=YXBpY29yZS1pdGVtcw==:ZHMtYXBpY29yZS1pdGVtcy0wMQ==:DXF1ZXJ5QW5kRmV0Y2gBAAAAABIu7AgWMXl6anF3SU5SMVNaQXFxTkZubHBqQQ==

To continue to obtain the next pages of results, just make the same GET to the request until you reach the end of the list. You will know when it reaches the end when it returns null said GET.


Get the items mappings

This service allows to obtain all the items of the marketplaces of a Global item.

Request:

curl -X GET http://api.mercadolibre.com/items/$ITEM_ID/marketplace_items?access_token=$ACCESS_TOKEN

Example:

curl -X GET https://api.mercadolibre.com/items/CBT910791762/marketplace_items?access_token=$ACCESS_TOKEN

Response:

  {
    "item_id": "CBT910791762",
    "user_id": 529231748,
    "site_id": "CBT",
    "date_created": "2020-03-03T03:37:01Z",
    "marketplace_items": [
        {
            "item_id": "MLB1455155305",
            "user_id": 529229673,
            "site_id": "MLB",
            "date_created": "2020-03-03T03:37:00Z",
            "parent_id": "CBT910791762"
        },
        {
            "item_id": "MLM760763629",
            "user_id": 529234242,
            "site_id": "MLM",
            "date_created": "2020-03-03T03:37:00Z",
            "parent_id": "CBT910791762"
        }
    ],
    "parent_id": ""
}