Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Última actualización 28/09/2023
Manage users
If you registered your application, got authenticated and created a Test user successfully, the next step is to learn how to work with users (sellers and buyers).Register as a real estate agency (Optional)
If you are a real estate agency, you can register your user as such to gain access to our promotional real estate packs. To accomplish this, access the Help section. This step can’t be accessed through API, you need to follow the path: Ayuda > Configuración de mi cuenta > Registrarme como empresa, concesionaria e inmobiliaria.
Once you choose "Registrarme como Inmobiliaria" you'll be redirected to a form which must be filled with the proper information and you will also be able to choose your desired promotional package. After completing the form, one of our agents will get in touch with you.
Keep in mind that having a promotional pack is not mandatory for listing through the API but it’s really helpful for real estate agencies. Learn how to work with Promotion Packs.
Get my personal data
If you are logged in MercadoLibre and have a token, you will be able to make the call below and learn about your user-related information: Example:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/me{
"id": 202593498,
"nickname": "TETE2870021",
"registration_date": "2016-01-06T11:31:42.000-04:00",
"country_id": "AR",
"address": {
"state": "AR-C",
"city": "Palermo"
},
"user_type": "real_estate_agency",
"tags": [
"real_estate_agency",
"test_user",
"user_info_verified"
],
"logo": null,
"points": 100,
"site_id": "MLA",
"permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
"seller_reputation": {
"level_id": null,
"power_seller_status": null,
"transactions": {
"period": "historic",
"total": 0,
"completed": 0,
"canceled": 0,
"ratings": {
"positive": 0,
"negative": 0,
"neutral": 0
}
}
},
"buyer_reputation": {
"tags": [
]
},
"status": {
"site_status": "active"
}
}Get data from other users
If you want to query third-party user data, you will be able to identify two information levels: public data, which you can find navigating the MercadoLibre profile of any other user, e.g.: http://perfil.mercadolibre.com.ar/TETE2870021, and private data, which will be hidden unless you have user permission and a valid token to work on his/her behalf. In both cases, first you need to know the user ID.How to get a user’s ID?
If you do not have the ID but you know the user’s nickname and the site he/she belongs to, you will be able to get their ID using the following search: Call:curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/{Site_id}/search?nickname={Nickname}curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/search?nickname=TETE2870021{
"site_id": "MLA",
"seller": {
"id": 202593498,
"seller_reputation": {
"power_seller_status": null
},
"real_estate_agency": false,
"car_dealer": false,
"tags": [
]
},
"paging": {
"total": 2,
"offset": 0,
"limit": 50
},
"results": [
{
"id": "MLA598903377",
"site_id": "MLA",
"title": "Test Item - Nao Ofertar",
"subtitle": null,
"seller": {
"id": 202593498,
"power_seller_status": null,
"car_dealer": false,
"real_estate_agency": false,
"tags": [
]
},
"price": 200,
"currency_id": "ARS",
"available_quantity": 1,
"sold_quantity": 0,
"buying_mode": "buy_it_now",
"listing_type_id": "bronze",
"stop_time": "2016-03-06T17:16:49.000Z",
"condition": "new",
"permalink": "http://articulo.mercadolibre.com.ar/MLA-598903377-test-item-nao-ofertar-_JM",
"thumbnail": "http://mla-s2-p.mlstatic.com/546311-MLA20539702714_012016-I.jpg",
"accepts_mercadopago": true,
"installments": {
"quantity": 6,
"amount": 42.33,
"currency_id": "ARS"
},
"address": {
"state_id": "AR-C",
"state_name": "Capital Federal",
"city_id": "",
"city_name": "Palermo"
},
"shipping": {
"free_shipping": false,
"mode": "not_specified"
},
"seller_address": {
"id": 175597910,
"comment": "",
"address_line": "",
"zip_code": "",
"country": {
"id": "AR",
"name": "Argentina"
},
"state": {
"id": "AR-C",
"name": "Capital Federal"
},
"city": {
"id": "",
"name": "Palermo"
},
"latitude": -34.571148,
"longitude": -58.423298
},
"attributes": [
],
"original_price": null,
"category_id": "MLA374515",
"official_store_id": null
},
{
"id": "MLA599121050",
"site_id": "MLA",
"title": "Item De Test - No Ofertar",
"subtitle": null,
"seller": {
"id": 202593498,
"power_seller_status": null,
"car_dealer": false,
"real_estate_agency": false,
"tags": [
]
},
"price": 1000,
"currency_id": "ARS",
"available_quantity": 1,
"sold_quantity": 0,
"buying_mode": "buy_it_now",
"listing_type_id": "bronze",
"stop_time": "2016-03-07T20:12:41.000Z",
"condition": "new",
"permalink": "http://articulo.mercadolibre.com.ar/MLA-599121050-item-de-test-no-ofertar-_JM",
"thumbnail": "http://mla-s2-p.mlstatic.com/493311-MLA20538550251_012016-I.jpg",
"accepts_mercadopago": true,
"installments": {
"quantity": 6,
"amount": 211.65,
"currency_id": "ARS"
},
"address": {
"state_id": "AR-C",
"state_name": "Capital Federal",
"city_id": "",
"city_name": "Palermo"
},
"shipping": {
"free_shipping": false,
"mode": "not_specified"
},
"seller_address": {
"id": 175597910,
"comment": "",
"address_line": "",
"zip_code": "",
"country": {
"id": "AR",
"name": "Argentina"
},
"state": {
"id": "AR-C",
"name": "Capital Federal"
},
"city": {
"id": "",
"name": "Palermo"
},
"latitude": -34.571148,
"longitude": -58.423298
},
"attributes": [
],
"original_price": null,
"category_id": "MLA90105",
"official_store_id": null
}
],
"secondary_results": [
],
"related_results": [
],
"sort": {
"id": "relevance",
"name": "More relevant"
},
"available_sorts": [
{
"id": "price_asc",
"name": "Lower price"
},
{
"id": "price_desc",
"name": "Higher price"
}
],
"filters": [
],
"available_filters": [
{
"id": "category",
"name": "Categories",
"type": "text",
"values": [
{
"id": "MLA1648",
"name": "Computación",
"results": 1
},
{
"id": "MLA1430",
"name": "Ropa y Accesorios",
"results": 1
}
]
},
{
"id": "state",
"name": "Location",
"type": "text",
"values": [
{
"id": "TUxBUENBUGw3M2E1",
"name": "Capital Federal",
"results": 2
}
]
},
{
"id": "accepts_mercadopago",
"name": "MercadoPago filter",
"type": "boolean",
"values": [
{
"id": "yes",
"name": "With MercadoPago",
"results": 2
}
]
},
{
"id": "installments",
"name": "Pago",
"type": "text",
"values": [
{
"id": "yes",
"name": "Installments",
"results": 2
},
{
"id": "no_interest",
"name": "Sin interés",
"results": 0
}
]
},
{
"id": "condition",
"name": "Condition filter",
"type": "text",
"values": [
{
"id": "new",
"name": "New",
"results": 2
}
]
},
{
"id": "buying_mode",
"name": "Buying mode filter",
"type": "text",
"values": [
{
"id": "buy_it_now",
"name": "Buy it now",
"results": 2
}
]
},
{
"id": "has_pictures",
"name": "Items with images filter",
"type": "boolean",
"values": [
{
"id": "yes",
"name": "With pictures",
"results": 2
}
]
}
]
}Get a user’s public information
Now, as you already know the user ID, you can make a call to the users’ resource as shown below in order to get the public information of the user you want: Call:curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/{User_id}curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/202593498
{
"id": 202593498,
"nickname": "TETE2870021",
"registration_date": "2016-01-06T11:31:42.000-04:00",
"country_id": "AR",
"address": {
"state": "AR-C",
"city": "Palermo"
},
"user_type": "normal",
"tags": [
"normal",
"test_user",
"user_info_verified"
],
"logo": null,
"points": 100,
"site_id": "MLA",
"permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
"seller_reputation": {
"level_id": null,
"power_seller_status": null,
"transactions": {
"period": "historic",
"total": 0,
"completed": 0,
"canceled": 0,
"ratings": {
"positive": 0,
"negative": 0,
"neutral": 0
}
}
},
"buyer_reputation": {
"tags": [
]
},
"status": {
"site_status": "active"
}
}Get private information of a user who accepted the use of my application
In order to get a user’s private data, you just need to know the user's ACCESS_TOKEN at the end of the call that you made before. Call:curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/{User_id}curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/202593498{
"id": 202593498,
"nickname": "TETE2870021",
"registration_date": "2016-01-06T11:31:42.000-04:00",
"first_name": "Test",
"last_name": "Test",
"country_id": "AR",
"email": "test_user_50698062@testuser.com",
"identification": {
"type": "DNI",
"number": "1111111"
},
"address": {
"state": "AR-C",
"city": "Palermo",
"address": "Test Address 123",
"zip_code": "1414"
},
"phone": {
"area_code": "01",
"number": "1111-1111",
"extension": "",
"verified": false
},
"alternative_phone": {
"area_code": "",
"number": "",
"extension": ""
},
"user_type": "real_estate_agency",
"tags": [
"real_estate_agency",
"test_user",
"user_info_verified"
],
"logo": null,
"points": 100,
"site_id": "MLA",
"permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
"shipping_modes": [
"custom",
"not_specified"
],
"seller_experience": "ADVANCED",
"seller_reputation": {
"level_id": null,
"power_seller_status": null,
"transactions": {
"period": "historic",
"total": 0,
"completed": 0,
"canceled": 0,
"ratings": {
"positive": 0,
"negative": 0,
"neutral": 0
}
}
},
"buyer_reputation": {
"canceled_transactions": 0,
"transactions": {
"period": "historic",
"total": null,
"completed": null,
"canceled": {
"total": null,
"paid": null
},
"unrated": {
"total": null,
"paid": null
},
"not_yet_rated": {
"total": null,
"paid": null,
"units": null
}
},
"tags": [
]
},
"status": {
"site_status": "active",
"list": {
"allow": true,
"codes": [
],
"immediate_payment": {
"required": false,
"reasons": [
]
}
},
"buy": {
"allow": true,
"codes": [
],
"immediate_payment": {
"required": false,
"reasons": [
]
}
},
"sell": {
"allow": true,
"codes": [
],
"immediate_payment": {
"required": false,
"reasons": [
]
}
},
"billing": {
"allow": true,
"codes": [
]
},
"mercadopago_tc_accepted": true,
"mercadopago_account_type": "personal",
"mercadoenvios": "not_accepted",
"immediate_payment": false,
"confirmed_email": false,
"user_type": "eventual",
"required_action": ""
},
"credit": {
"consumed": 100,
"credit_level_id": "MLA1"
}
}Update user’s information
You can use our resources to update your user information after registration. This is a common issue, since at this instance you’re not asked to fill your address or personal identification, but you need to have them filled or you’ll be unable to list items on MercadoLibre. To update your user information, follow the example: Example:curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
"identification_type": "DNI",
"identification_number": "33333333",
"address": "Triunvirato 5555",
"state":"AR-C",
"city":"Capital Federal",
"zip_dode": "1431",
"phone":{
"area_code":"011",
"number":"4444-4444",
"extension":"001"
},
"first_name":"Pedro",
"last_name": "Picapiedras",
"company":{
"corporate_name":"Acme",
"brand_name":"Acme Company"
},
"mercadoenvios": "accepted"
}
https://api.mercadolibre.com/users/{User_id}>Congratulations, you've updated your user Information. Remember to only send the fields you want to update.
Consult blocked users
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-type: application/json" -d curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$CUYOUR_CUST_IDST_ID/order_blacklistDelete blocked user
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$YOUR_CUST_ID/order_blacklist/$SELLER_IDBlock users from asking questions
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' "Content-Type: application/json" -d
{
"user_id": blocked user id
}
https://api.mercadolibre.com/users/$SELLER_ID/questions_blacklistView blocked users from asking questions
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$SELLER_ID/questions_blacklistDelete a blocked user
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$SELLER_ID/questions_blacklist/$USER_IDCommon error codes
206 – Partial content: in some cases Users API resource will return a 206 – Partial Content code. This is going to happen when the request to some of the data fails (for example, user reputation), to make you aware that you’re getting an incomplete response.Next topic: Choose operation and property type
Related article: Categories and Attributes.