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 21/11/2024

Preguntas y Respuestas

Nota:
Por seguridad, puedes obtener el email, teléfono y nombre del comprador en en /questions/$QUESTION_ID.
Utiliza el parámetro api_version=4 y obtén las preguntas y respuestas con la nueva estructura.

Este ejemplo servirá para gestionar preguntas y respuestas

Recurso Descripción Ejemplo
/questions/search?item=$ITEM_ID Buscar cualquier pregunta realizada en los ítems del usuario. GET
Go back X

Obtener preguntas por ID de ítem

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/questions/search?item_id=MLA608007087
 

Respuesta

{
    "total": 0,
    "limit": 50,
    "questions": [],
    "filters": {
        "limit": 50,
        "offset": 0,
        "api_version": "4",
        "is_admin": false,
        "sorts": [],
        "caller": 447594313,
        "item": "MLA608007087"
    },
    "available_filters": [
        {
            "id": "from",
            "name": "From user id",
            "type": "number"
        },
        {
            "id": "seller",
            "name": "Seller id",
            "type": "number"
        },
        {
            "id": "totalDivisions",
            "name": "total divisions",
            "type": "number"
        },
        {
            "id": "division",
            "name": "Division",
            "type": "number"
        },
        {
            "id": "status",
            "name": "Status",
            "type": "text",
            "values": [
                "ANSWERED",
                "BANNED",
                "CLOSED_UNANSWERED",
                "DELETED",
                "DISABLED",
                "UNANSWERED",
                "UNDER_REVIEW"
            ]
        }
    ],
    "available_sorts": [
        "item_id",
        "from_id",
        "date_created",
        "seller_id"
    ]
}
Leer más.
/questions Realizar preguntas sobre los items de otros usuarios. POST
Go back X

Realizar una pregunta.

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d '{
   "text":"Test question.",
   "item_id":"MLA608007087"
}' https://api.mercadolibre.com/questions
 

Respuesta

{
	"id": 3957150025,
	"answer": null,
	"date_created": "2016-02-29T11:19:42.957-04:00",
	"item_id": "MLA608007087",
	"seller_id": 202593498,
	"status": "UNANSWERED",
	"text": "Test question.",
	"from": {
		"id": 207119838
	}
}
Leer más.
/answers Responder a las preguntas realizadas en sus items. POST
Go back X

Responder una pregunta.

 curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H ""Content-Type: application/json"" -d '{
     "question_id": 3957150025, 
     "text":"Test answer..." 
}' https://api.mercadolibre.com/answers
 

Respuesta

{
	"id": 3957150025,
	"answer": {
		"date_created": "2016-02-29T11:21:27.831-04:00",
		"status": "ACTIVE",
		"text": "Test answer..."
	},
	"date_created": "2016-02-29T11:19:42.000-04:00",
	"deleted_from_listing": false,
	"hold": false,
	"item_id": "MLA608007087",
	"seller_id": 202593498,
	"status": "ANSWERED",
	"text": "Test question.",
	"from": {
		"id": 207119838,
		"answered_questions": 0
	}
}
Leer más.
/questions/$QUESTION_ID Recuperar información de una pregunta específica de un ID. GET
Go back X

Obtener detalles de la pregunta.

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

Respuesta

{
  "id": 3957150025,
  "answer": {
    "date_created": "2016-02-29T11:21:27.000-04:00",
    "status": "ACTIVE",
    "text": "Test answer..."
  },
  "date_created": "2016-02-29T11:19:42.000-04:00",
  "deleted_from_listing": false,
  "hold": false,
  "item_id": "MLA608007087",
  "seller_id": 202593498,
  "status": "ANSWERED",
  "text": "Test question.",
  "from": {
    "id": 207119838,
    "answered_questions": 1
  }
}
Leer más.
/block-api/search/users/$USER_ID Consultar bloqueos asociados a un usuario GET
Go back X

Comprobar las preguntas de usuarios bloqueados.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/block-api/search/users/72641919?type=blocked_by_questions'
 

Respuesta (en caso que haya usuarios bloqueados)


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

Respuesta (en caso que no haya usuarios bloqueados)


    { 
        "users": [],
        "paging": { 
            "total": 0, 
            "limit": 10,
            "offset": 0 } 
    }

Parametro Obligatorio:

- Type: string - Tipo de bloqueo: blocked_by_questions.

Parametros Opcionales:

- user_blocked: Int - ID del usuario bloqueado (Buyer).

- offset: Int - por defecto: 0.

- limit: Int - máximo: 1000, por defecto: 10
/users/$SELLER_ID/questions_blacklist/$BUYER_ID Gestionar preguntas de usuarios bloqueados. POST
DELETE
Go back X

Enviar usuarios bloqueados de preguntas

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
  "user_id": blocked user id
}'
https://api.mercadolibre.com/users/$SELLER_ID/questions_blacklist
Leer más.
Go back X

Sacar al usuario para preguntar cualquier duda sobre sus artículos.

$ curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/users/$SELLER_ID/questions_blacklist/$USER_ID'
  Leer más.
/my/received_questions/search Preguntas recibidas por usuario. GET
Go back X

Obtener preguntas realizadas en sus items.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/my/received_questions/search
 

Respuesta

{
    "total": 3,
    "limit": 50,
    "questions": [
        {
            "date_created": "2020-04-14T16:30:02.000-04:00",
            "item_id": "MLB1494945960",
            "seller_id": 447594313,
            "status": "ANSWERED",
            "text": "Olá, vc teria máscaras com filtro tbm? E com estampas personalizada tipo de desenho animado?",
            "id": 6940134223,
            "deleted_from_listing": false,
            "hold": false,
            "answer": {
                "text": "Olá Tudo bem? Temos sim o filtro interno e diversas estampas. =)",
                "status": "ACTIVE",
                "date_created": "2020-04-14T19:53:43.069-04:00"
            },
            "from": {
                "id": 546874560
            }
        },
        {
            "date_created": "2020-04-26T00:47:49.000-04:00",
            "item_id": "MLB1494945960",
            "seller_id": 447594313,
            "status": "ANSWERED",
            "text": "Tem cm escolher as estampas?",
            "id": 6994706979,
            "deleted_from_listing": false,
            "hold": false,
            "answer": {
                "text": "",
                "status": "BANNED",
                "date_created": "2020-04-26T10:14:18.529-04:00"
            },
            "from": {
                "id": 212866079
            }
        },
        {
            "date_created": "2020-05-03T20:46:00.000-04:00",
            "item_id": "MLB1494945960",
            "seller_id": 447594313,
            "status": "ANSWERED",
            "text": "Olá Tem mais estampas disponíveis ou somente as do anúncio?",
            "id": 7101218884,
            "deleted_from_listing": false,
            "hold": false,
            "answer": {
                "text": "Olá, esperamos q esteja bem. Apenas as do anúncio e algumas infantis",
                "status": "ACTIVE",
                "date_created": "2020-05-04T10:52:19.697-04:00"
            },
            "from": {
                "id": 129810625
            }
        }
    ],
    "filters": {
        "limit": 50,
        "offset": 0,
        "api_version": "4",
        "is_admin": false,
        "sorts": [],
        "caller": 447594313,
        "seller": 447594313
    },
    "available_filters": [
        {
            "id": "item",
            "name": "Item",
            "type": "text"
        },
        {
            "id": "from",
            "name": "From user id",
            "type": "number"
        },
        {
            "id": "totalDivisions",
            "name": "total divisions",
            "type": "number"
        },
        {
            "id": "division",
            "name": "Division",
            "type": "number"
        },
        {
            "id": "status",
            "name": "Status",
            "type": "text",
            "values": [
                "ANSWERED",
                "BANNED",
                "CLOSED_UNANSWERED",
                "DELETED",
                "DISABLED",
                "UNANSWERED",
                "UNDER_REVIEW"
            ]
        }
    ],
    "available_sorts": [
        "item_id",
        "from_id",
        "date_created",
        "seller_id"
    ]
}
Leer más.