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

Perguntas e Respostas

Nota:
Por segurança, você pode obter o e-mail, telefone e nome do comprador em / questions / $ QUESTION_ID.
Use o parâmetro api_version = 4 e obtenha as perguntas e respostas com a nova estrutura.

Os seguintes exemplos servirão para gerenciar perguntas e respostas.

Recurso Descrição Exemplo
/questions/search?item=$ITEM_ID Busca uma pergunta feita nos items do usuário. GET
Voltar X

Obter perguntas por ID do item

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

Resposta

{
    "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"
    ]
}
Ler mais.
/questions Fazer perguntas sobre os items de outros usuários. POST
Voltar X

Realizar uma pergunta.

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
 

Resposta

{
	"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
	}
}
Ler mais.
/answers Responder às perguntas realizadas em seus items. POST
Voltar X

Responder uma pergunta.

 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
 

Resposta

{
	"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
	}
}
Ler mais.
/questions/$QUESTION_ID Obter informação de uma pergunta especifica de um ID. GET
Voltar X

Obter detalhes da pergunta.

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

Resposta

{
  "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
  }
}
Ler mais.
/block-api/search/users/$USER_ID Consultar os bloqueios associados a um user GET
Go back X

Verificar perguntas de users bloqueados

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

Resposta (no caso de users bloqueados)


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

Resposta (no caso de não haver users bloqueados)


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

Parâmetro obrigatório:

- Type: string - Tipo de bloqueio: blocked_by_questions.

Parâmetros opcionais:

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

- offset: Int - valor por defeito: 0.

- limit: Int - máximo: 1000, valor por defeito: 10
/users/$SELLER_ID/questions_blacklist/$BUYERID Gerenciar perguntas da blacklist. POST DELETE
Go back X

Remover um usuário bloqueado

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$SELLER_ID/questions_blacklist/$USER_ID
  Ler mais.
/my/received_questions/search Perguntas recebidas por usuário. GET
Voltar X

Obter perguntas feitas em seus items.

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

Resposta

{
    "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"
    ]
}
Ler mais.

Seguinte: Pedidos e opiniões.