Items & Searches

Summary of available resources

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:

Get items by a search query

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/search?q=$TEXT_TO_SEARCH

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 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": {
      "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 resource you use, you will obtain the following data:
- /sites/$SITE_ID/search?: get the results of active items directly from the Global Selling listings.
- /users/$USER_ID/items/search: get 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 -H 'Authorization: Bearer $ACCESS_TOKEN' 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 -H 'Authorization: Bearer $ACCESS_TOKEN' 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 -H 'Authorization: Bearer $ACCESS_TOKEN' 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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/search?seller_id=$SELLER_ID&sort=price_asc

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 -H 'Authorization: Bearer $ACCESS_TOKEN' 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

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search

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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?sku=$SELLER_CUSTOM_FIELD

• Seller_sku: If the item contains a SKU in the “SELLER_SKU” field /attribute, you can try like this:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?seller_sku=$SELLER_SKU

By status

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?status=active

With/without product identifier

Using the parameters:
- missing_product_identifiers=true get items that not have a Product Identifier loaded or submitting. Thus, you identify which listings you can improve by complying with one of the most important quality requirements.
- missing_product_identifiers=false you get the list of listings with PIs uploaded or sending.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?missing_product_identifiers=true

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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?orders=start_time_desc

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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?listing_type_id=gold_pro

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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items?ids=$ITEM_ID1,$ITEM_ID2

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/items?ids=CBT910553725,CBT910547444

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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users?ids=$USER_ID1,$USER_ID2

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users?ids=523132944,523133081

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 shown in the example. Learn more about how to work with Attributes in the documentation.

Request:

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

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items?ids=CBT910553725,CBT910547444&attributes=id,price,category_id,title

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.

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

• Add search_type=scan to query 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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?search_type=scan

Response:

"scroll_id": "YXBpY29yZS1pdGVtcw==:ZHMtYXBpY29yZS1pdGVtcy0wMQ==:DXF1ZXJ5QW5kRmV0Y2gBAAAAABIu7AgWMXl6anF3SU5SMVNaQXFxTkZubHBqQQ=="

• We add the scroll_id= obtained in the previous step:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?search_type=scan&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 -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/items/$ITEM_ID/marketplace_items

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/CBT910791762/marketplace_items

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": ""
}