// docs

Mercado Livre Review

Extrai avaliacoes de produto no Mercado Livre com paginação.

Nota importante: alguns campos podem retornar null em produção, dependendo da página de origem. Nesta documentação, os exemplos de output são preenchidos intencionalmente com valores não nulos para facilitar integração.

Chamada HTTP

cURL

curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.mercadolivre.com.br/p/MLB4997536398",
  "target": "mercadolivre.com.br",
  "type": "review",
  "page": 0
}'

Possibilidades de input

Campos suportados nesta API do POST /v1/extract, com regras específicas de obrigatoriedade e condicionais.

Campo	Tipo	Status	Regra	Default	Exemplo
url URL alvo da extração. Para alguns PLPs pode ser omitida quando a API monta a URL a partir de outros campos.	string (URL)	Obrigatório	Obrigatorio para este seam.	-	https://www.mercadolivre.com.br/p/MLB123456
target Fonte alvo da extração.	enum	Obrigatório	Sempre obrigatorio no payload e deve combinar com o seam.	-	mercadolivre.com.br
type Tipo da extração: pdp, plp ou review.	enum	Obrigatório	Sempre obrigatorio no payload e deve combinar com o seam.	-	pdp
page Paginação. Em PLP inicia em 1; em MercadoLivre review inicia em 0.	integer	Opcional	Suportado para review; pode iniciar em 0.	-	2

Exemplos de request

Reviews por URL

Extracao de avaliacoes iniciando na pagina 0.

Reviews por URL

{
  "url": "https://www.mercadolivre.com.br/p/MLB4997536398",
  "target": "mercadolivre.com.br",
  "type": "review",
  "page": 0
}

Schema de response (leaf paths)

Mapa de paths de saída com tipo esperado para esta API.

responseSchema

{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "data.source": "string",
  "data.type": "string",
  "data.url": "string",
  "data.requestUrl": "string",
  "data.extractedAt": "string (iso datetime)",
  "data.objectId": "string",
  "data.siteId": "string",
  "data.isItem": "boolean",
  "data.page": "number",
  "data.resultsPerPage": "number",
  "data.offset": "number",
  "data.totalReviews": "number",
  "data.hasNextPage": "boolean",
  "data.nextPage": "number",
  "data.nextPageUrl": "string",
  "data.reviews[].reviewId": "string",
  "data.reviews[].rating": "number",
  "data.reviews[].title": "string",
  "data.reviews[].comment": "string",
  "data.reviews[].reviewDate": "string",
  "data.reviews[].reviewDateIso": "string",
  "data.reviews[].helpfulCount": "number",
  "data.reviews[].media[].id": "string",
  "data.reviews[].media[].type": "string",
  "data.reviews[].media[].alt": "string",
  "data.reviews[].media[].url": "string",
  "data.reviews[].media[].variations[].size": "string",
  "data.reviews[].media[].variations[].url": "string"
}

Exemplo de response

responseExample

{
  "requestId": "33333333-1111-4111-8111-333333333333",
  "executionId": "33333333-2222-4222-8222-333333333333",
  "data": {
    "source": "mercadolivre.com.br",
    "type": "review",
    "url": "https://www.mercadolivre.com.br/p/MLB4997536398",
    "requestUrl": "https://www.mercadolivre.com.br/reviews/search?objectId=MLB4997536398&page=0",
    "extractedAt": "2026-02-12T12:35:56.000Z",
    "objectId": "MLB4997536398",
    "siteId": "MLB",
    "isItem": true,
    "page": 0,
    "resultsPerPage": 15,
    "offset": 0,
    "totalReviews": 321,
    "hasNextPage": true,
    "nextPage": 1,
    "nextPageUrl": "https://www.mercadolivre.com.br/reviews/search?objectId=MLB4997536398&page=1",
    "reviews": [
      {
        "reviewId": "2728303718",
        "rating": 5,
        "title": "Excelente produto",
        "comment": "Otima qualidade e entrega rapida.",
        "reviewDate": "2026-02-05",
        "reviewDateIso": "2026-02-05",
        "helpfulCount": 3,
        "media": [
          {
            "id": "media-1",
            "type": "image",
            "alt": "Foto enviada pelo comprador",
            "url": "https://http2.mlstatic.com/review-media-1.jpg",
            "variations": [
              {
                "size": "small",
                "url": "https://http2.mlstatic.com/review-media-1-small.jpg"
              }
            ]
          }
        ]
      }
    ]
  }
}

Referência completa de campos

Path	Tipo	Descrição	Exemplo
data.extractedAt	string (iso datetime)	Campo data.extractedAt retornado no payload de resposta.	2026-02-12T12:35:56.000Z
data.hasNextPage	boolean	Campo data.hasNextPage retornado no payload de resposta.	true
data.isItem	boolean	Campo data.isItem retornado no payload de resposta.	true
data.nextPage	number	Campo data.nextPage retornado no payload de resposta.	1
data.nextPageUrl	string	Campo data.nextPageUrl retornado no payload de resposta.	https://www.mercadolivre.com.br/reviews/search?objectId=MLB4997536398&page=1
data.objectId	string	Campo data.objectId retornado no payload de resposta.	MLB4997536398
data.offset	number	Campo data.offset retornado no payload de resposta.	0
data.page	number	Campo data.page retornado no payload de resposta.	0
data.requestUrl	string	Campo data.requestUrl retornado no payload de resposta.	https://www.mercadolivre.com.br/reviews/search?objectId=MLB4997536398&page=0
data.resultsPerPage	number	Campo data.resultsPerPage retornado no payload de resposta.	15
data.reviews[].comment	string	Campo data.reviews[].comment retornado no payload de resposta.	Otima qualidade e entrega rapida.
data.reviews[].helpfulCount	number	Campo data.reviews[].helpfulCount retornado no payload de resposta.	3
data.reviews[].media[].alt	string	Campo data.reviews[].media[].alt retornado no payload de resposta.	Foto enviada pelo comprador
data.reviews[].media[].id	string	Campo data.reviews[].media[].id retornado no payload de resposta.	media-1
data.reviews[].media[].type	string	Campo data.reviews[].media[].type retornado no payload de resposta.	image
data.reviews[].media[].url	string	Campo data.reviews[].media[].url retornado no payload de resposta.	https://http2.mlstatic.com/review-media-1.jpg
data.reviews[].media[].variations[].size	string	Campo data.reviews[].media[].variations[].size retornado no payload de resposta.	small
data.reviews[].media[].variations[].url	string	Campo data.reviews[].media[].variations[].url retornado no payload de resposta.	https://http2.mlstatic.com/review-media-1-small.jpg
data.reviews[].rating	number	Campo data.reviews[].rating retornado no payload de resposta.	5
data.reviews[].reviewDate	string	Campo data.reviews[].reviewDate retornado no payload de resposta.	2026-02-05
data.reviews[].reviewDateIso	string	Campo data.reviews[].reviewDateIso retornado no payload de resposta.	2026-02-05
data.reviews[].reviewId	string	Campo data.reviews[].reviewId retornado no payload de resposta.	2728303718
data.reviews[].title	string	Campo data.reviews[].title retornado no payload de resposta.	Excelente produto
data.siteId	string	Campo data.siteId retornado no payload de resposta.	MLB
data.source	string	Campo data.source retornado no payload de resposta.	mercadolivre.com.br
data.totalReviews	number	Campo data.totalReviews retornado no payload de resposta.	321
data.type	string	Campo data.type retornado no payload de resposta.	review
data.url	string	Campo data.url retornado no payload de resposta.	https://www.mercadolivre.com.br/p/MLB4997536398
executionId	string (uuid)	Campo executionId retornado no payload de resposta.	33333333-2222-4222-8222-333333333333
requestId	string (uuid)	Campo requestId retornado no payload de resposta.	33333333-1111-4111-8111-333333333333

Erros comuns

Status	errorCode	Quando acontece
400	INVALID_PAYLOAD	JSON inválido ou violação das regras de validação do payload.
401	UNAUTHORIZED	Header Authorization ausente ou token/chave inválida.
402	INSUFFICIENT_CREDITS	Saldo de créditos insuficiente para a API solicitada.
403	FORBIDDEN	Usuário sem acesso ou API temporariamente desabilitada.
409	EXECUTION_CONFLICT	executionId conflita com uma execução em estado incompatível.
429	RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS	Limite de taxa ou limite de requisições em voo excedido.
500	WORKER_ERROR / INTERNAL_ERROR	Falha interna no worker ou no gateway.