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 14/03/2023

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.

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.
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.
/users/$SELLER_ID/questions_blacklist/$BUYERID Gerenciar perguntas da blacklist. GET GET POST DELETE
Go back X

Testar as perguntas da blacklist do usuário (Com limit e offset).

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/users/$SELLER_ID/questions_blacklist
 

Resposta (Caso ter usuários bloqueados)

{
    "paging": {
        "total": 5,
        "limit": 50,
        "offset": 0
    },
    "users": [{
        "id": 70927648
    }, {
        "id": 170577643
    }, {
        "id": 82411799
    }, {
        "id": 158470042
    }, {
        "id": 194938540
    }]
}

Resposta (Caso não ter usuários bloqueados)

{
    "paging": {
        "total": 0,
        "limit": 50,
        "offset": 0
    },
    "users": []
}
Go back X

Testar as perguntas da blacklist do usuário (Sem offset e limit)

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'"http://api.mercadolibre.com/users/${seller_id}/questions_blacklist?limit=1&offset=2"
 

Resposta (Caso ter usuários bloqueados)

{
    "paging": {
        "total": 5,
        "limit": 50,
        "offset": 0
    },
    "users": [{
        "id": 70927648
    }, {
        "id": 170577643
    }, {
        "id": 82411799
    }, {
        "id": 158470042
    }, {
        "id": 194938540
    }]
}

Resposta (Caso não ter usuários bloqueados)

{
    "paging": {
        "total": 0,
        "limit": 50,
        "offset": 0
    },
    "users": []
}
Ler mais.
Voltar X

Bloquear usuários de perguntas

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
  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.