Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 04/12/2024

Consultas sobre el usuario

Si ya lograste registrar tu aplicación, autenticarte y generar un usuario de Test, el siguiente paso a seguir es aprender a trabajar con usuarios (vendedores y compradores):


Consultar mis datos personales

Si te encuentras logueado en MercadoLibre y tienes un token podrás hacer la siguiente llamada y conocer qué información se encuentra relacionada a tu usuario:

Ejemplo:

Llamada:

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

Respuesta:

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

Consultar dados de usuários terceiros

Si no tienes el id, pero conoces el nickname y el site al que pertenece un usuario, podrás obtenerlo con la siguiente búsqueda:

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/{Site_id}/search?nickname={Nickname}

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/search?nickname=TETE2870021

Respuesta:

{
  "site_id": "MLA",
  "seller": {
    "id": 202593498,
    "seller_reputation": {
      "power_seller_status": null
    },
    "real_estate_agency": false,
    "car_dealer": false,
    "tags": []
  }
}

¿Cómo obtener el Id de un usuario?

Si no tienes el id, pero conoces el nickname y el site al que pertenece un usuario, podrás obtener su Id con la siguiente búsqueda:

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/{Site_id}/search?nickname={Nickname}

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/search?nickname=TETE2870021

Respuesta:

{
  "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": "MLA374515",
      "official_store_id": null
    }
  ]
}

Consultar información pública de un usuario

Los datos públicos son aquellos que puedes consultar de manera abierta en el perfil de un usuario. Los datos que puedes consultar son los siguientes:

  • Id de usuario
  • Nickname
  • Fecha de registro
  • Estado del usuario
  • Dirección (ciudad y provincia)
  • Reputación como vendedor
  • Reputación como comprador

Para poder consultar esta información debes tener el id del usuario:

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/{User_id}

Ejemplo:

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

Respuesta:

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

Consultar información privada de un usuario que ha aceptado el uso de mi aplicación

La información privada es aquella que solo podrá ser consultada con el consentimiento del usuario. La información a la que se puede acceder incluye:

  • Reputación como vendedor
  • Reputación como comprador
  • Dirección (incluye datos específicos)
  • Datos de contacto

Para poder consultar esta información debes tener el id del usuario y el token que permita realizar la consulta:

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/{User_id}/private

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/202593498/private

Respuesta:

{
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "country_id": "AR",
  "address": {
    "state": "AR-C",
    "city": "Palermo",
    "street": "Av. Santa Fe",
    "number": "1234"
  },
  "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"
  }
}

Actualizar datos de usuario

Si deseas actualizar la información de un usuario (que te haya otorgado el permiso), debes realizar la siguiente llamada:

Llamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d '{
  "address": {
    "street": "Nueva Calle",
    "number": "123",
    "city": "Nueva Ciudad",
    "state": "Nuevo Estado"
  }
}' https://api.mercadolibre.com/users/{User_id}/address

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d '{
  "address": {
    "street": "Av. Libertador",
    "number": "6789",
    "city": "Buenos Aires",
    "state": "Capital Federal"
  }
}' https://api.mercadolibre.com/users/202593498/address

Respuesta:

{
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "country_id": "AR",
  "address": {
    "state": "AR-C",
    "city": "Palermo",
    "street": "Av. Libertador",
    "number": "6789"
  },
  "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"
  }
}

Ten en cuenta que la información proporcionada es solo un ejemplo, y que puede variar según el estado actual del usuario y la información que el mismo haya decidido compartir.

Consultar usuarios bloqueados

Recupera todos los usuarios bloqueados de la oferta en los ítems de un vendedor:

Llamada:


curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-type: application/json" -d '{
    "request": {
        "curl": "curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$CUSTOMER_ID/order_blacklist"
    }
}'

Ver usuarios bloqueados de preguntas

Gestiona buyer bloqueados de preguntas:

Llamada:


curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-type: application/json" -d '{
    "request": {
        "curl": "curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$SELLER_ID/questions_blacklist"
    }
}'
Importante:
Estamos migrando los endpoints utilizados para bloquear y desbloquear a los buyers en las funcionalidades de orders y preguntas. La fecha de apagado de las rutas anteriores y por lo tanto de migración es: 2/12/2024. Con esto, solo será válida la información del tópico siguiente.

Endpoint block-api/search/users: Consultar usuários bloqueados para orders y question:

El endpoint block-api/search/users permite consultar bloqueos asociados a un usuario (Buyer) específico, devolviendo información sobre el estado del bloqueo. Los servicios de bloqueo de preguntas y orders se han unificado en un único endpoint.

  • Blocked_by_questions: Para bloqueos relacionados con preguntas.
  • Blocked_by_order: Para bloqueos relacionados con pedidos.
Parámetro TIPO Obligatorio Descripción
client.id string Opcional ID del cliente que realiza la solicitud.
type string Obligatório Tipo de bloqueo: blocked_by_questions o blocked_by_order.
user_blocked int Opcional ID del usuario bloqueado (Buyer).
caller.id string Obligatorio ID del usuario que realiza la solicitud.
offset int Opcionales por defecto: 0
limit int Opcionales máximo 1000, por defecto: 10

Llamada:


curl -X GET  'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/block-api/search/users/{user_id}

Ejemplo de request: blocked_by_questions


curl -X GET - location 'https://api.mercadolibre.com/block-api/search/users/123456?type=blocked_by_questions' \
--header 'Authorization: Bearer {ACCESS_TOKEN}'

Response:


{
  "users": [
    {
      "id": 123456,
      "blocked_at": "2024-02-07T15:04:05Z"
    }
  ],
  "paging": {
    "offset": 0,
    "limit": 10,
    "total": 1
  }
}

Código de Estado: 200 OK - La solicitud fue procesada con éxito.


Ejemplo de request: blocked_by_order


curl -X GET -location 'https://api.mercadolibre.com/block-api/search/users/123456?type=blocked_by_order' \
--header 'Authorization: Bearer {ACCESS_TOKEN}'

Response:


{
  "users": [
    {
      "id": 123456,
      "blocked_at": "2024-02-07T15:04:05Z"
    }
  ],
  "paging": {
    "offset": 0,
    "limit": 10,
    "total": 1
  }
}

Código de Estado: 200 OK - La solicitud fue procesada con éxito.


Ejemplo de Respuesta Sin Bloqueos (blocked_by_questions o blocked_by_order.)

Response:


{ "users": [],
 "paging": { 
"total": 0, 
"limit": 10,
 "offset": 0 } 
}
  • users: Indica que no hay usuarios bloqueados relacionados ni con preguntas ni con pedidos para el usuario solicitado.
  • paging: Muestra que no hay resultados, con total igual a 0.

Campos de la Respuesta:

Campo Tipo Descripción
users.id int ID del usuario bloqueado.
users.blocked_at string Fecha y hora de creación del bloqueo.
paging.offset int Número de bloqueos que fueron omitidos antes de retornar los resultados.
paging.limit int Cantidad máxima de bloqueos a recuperar (default 10, max 1000).
paging.total int Total de bloqueos recuperados.

Eliminar usuario bloqueado

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$YOUR_CUST_ID/order_blacklist/$SELLER_ID

Bloquear usuarios de preguntas 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_blacklist

Eliminar un usuario bloqueado

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$SELLER_ID/questions_blacklist/$USER_ID

Códigos de error comunes

206 – Partial content: en algunos casos, el recurso de la API de Usuarios devolverá un código 206 – Partial content. Esto ocurrirá cuando falle la solicitud a algunos de los datos (por ejemplo, reputación del usuario) para informarte que recibirás una respuesta incompleta.