Developers

Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.

Última atualização em 04/11/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	Opcional	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.

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.