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 09/11/2025

Consulta de Usuários

Se você seguir o guia de Passos rápidos para publicar um imóvel de teste, obterá um usuário de teste a partir da sua conta real, além de criar seu aplicativo para uso da API. Neste guia, aprofundamos um pouco mais sobre as opções disponíveis para a consulta de usuários.

Registrar-se como imobiliária (opcional)

Se você é uma imobiliária ou deseja testar o comportamento desse perfil de vendedor com seu usuário de teste, pode registrar seu usuário como tal para obter acesso aos nossos pacotes promocionais para imobiliárias.


Para fazer isso, acesse sua conta de usuário de teste e vá até a seção:


  • Ajuda / PQR
  • Ajuda subir sua conta
  • Configuração da minha conta
  • Registrar-me como empresa, concessionária e imobiliária
  • Como imobiliária.





Depois de realizar esses passos, você deve, por meio do canal de suporte, solicitar a ativação do seu usuário de teste através deste formulário, selecionando a opção ativar usuário.


Se você chegou a esta seção através dos “Passos rápidos para publicar um imóvel de teste” > “Configure seu Usuário de Teste como Imobiliária”, pode retornar a essa seção a partir daqui.


Consultar meus dados pessoais

Depois de realizar os passos detalhados no guia de configuração, especialmente a seção de autenticação, quando você obtiver o Access_token, poderá consultar as informações relacionadas ao seu usuário, seja ele o de teste ou o da sua conta real, executando a seguinte chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/me
Parâmetro Tipo Opcional Valores
ACCESS_TOKEN string Não Token obtido no guia de autenticação

Você receberá todas as informações do usuário relacionadas ao token usado, por exemplo:

{
  "id": 2320007493,
  "nickname": "TESTUSER942900259",
  "registration_date": "2025-03-11T19:06:13.272-04:00",
  "first_name": "Test",
  "last_name": "Test",
  "gender": "",
  "country_id": "CL",
  "email": "test_user_942900259@testuser.com",
  "identification": {
    "number": "11111111-1",
    "type": "RUT"
  },
  "address": {
    "address": "Apoquindo 4800",
    "city": "Las Condes",
    "state": "CL-RM",
    "zip_code": null
  },
  "phone": {
    "area_code": "",
    "extension": "",
    "number": "56978481768"
  },
  "alternative_phone": {
    "area_code": "",
    "extension": "",
    "number": ""
  },
  "user_type": "real_estate_agency",
  "tags": [
    "test_user",
    "real_estate_agency"
  ],
  "logo": null,
  "points": 0,
  "site_id": "MLC",
  "permalink": "http://perfil.mercadolibre.cl/TESTUSER942900259",
  "seller_experience": "NEWBIE",
  "bill_data": {
    "accept_credit_note": null
  },
  "seller_reputation": {
    "level_id": null,
    "power_seller_status": null,
    "transactions": {
      "canceled": 0,
      "completed": 0,
      "period": "historic",
      "ratings": {
        "negative": 0,
        "neutral": 0,
        "positive": 0
      },
      "total": 0
    },
    "metrics": {
      "sales": {
        "period": null,
        "completed": 0
      },
      "claims": {
        "period": "60 months",
        "rate": 0,
        "value": 0
      },
      "delayed_handling_time": {
        "period": "60 months",
        "rate": 0,
        "value": 0
      },
      "cancellations": {
        "period": "60 months",
        "rate": 0,
        "value": 0
      }
    }
  },
  "buyer_reputation": {
    "canceled_transactions": 0,
    "tags": null,
    "transactions": {
      "canceled": {
        "paid": null,
        "total": null
      },
      "completed": null,
      "not_yet_rated": {
        "paid": null,
        "total": null,
        "units": null
      },
      "period": "",
      "total": null,
      "unrated": {
        "paid": null,
        "total": null
      }
    }
  },
  "status": {
    "billing": {
      "allow": true,
      "codes": []
    },
    "buy": {
      "allow": true,
      "codes": [],
      "immediate_payment": {
        "reasons": [],
        "required": false
      }
    },
    "confirmed_email": true,
    "shopping_cart": {
      "buy": "allowed",
      "sell": "allowed"
    },
    "immediate_payment": false,
    "list": {
      "allow": true,
      "codes": [],
      "immediate_payment": {
        "reasons": [],
        "required": false
      }
    },
    "mercadoenvios": "not_accepted",
    "mercadopago_account_type": "personal",
    "mercadopago_tc_accepted": true,
    "required_action": "",
    "sell": {
      "allow": true,
      "codes": [],
      "immediate_payment": {
        "reasons": [],
        "required": false
      }
    },
    "site_status": "active",
    "user_type": null
  },
  "company": {
    "brand_name": null,
    "city_tax_id": "",
    "corporate_name": "",
    "identification": "",
    "state_tax_id": "",
    "cust_type_id": "CO",
    "soft_descriptor": null
  },
  "credit": {
    "consumed": 0,
    "credit_level_id": "MLC5",
    "rank": "newbie"
  },
  "context": {},
  "registration_identifiers": []
}

Campos da resposta

Parâmetro Tipo de Dado Descrição
idNumberIdentificador único do usuário
nicknameStringNome de usuário (apelido)
registration_dateStringData e hora do registro do usuário
first_nameStringNome do usuário
last_nameStringSobrenome do usuário
genderStringGênero do usuário
country_idStringCódigo do país onde o usuário se encontra (ex.: "CL", “AR”)
emailStringEndereço de e-mail do usuário
identificationObjectDetalhes de identificação do usuário
identification.numberStringNúmero de identificação
identification.typeStringTipo de identificação (ex.: "RUT", “CC”)
addressObjectDetalhes do endereço do usuário
address.addressStringEndereço do usuário
address.cityStringCidade do usuário
address.stateStringEstado do usuário
address.zip_codeStringCódigo postal do usuário
phoneObjectDetalhes do número de telefone do usuário
phone.area_codeStringCódigo de área do telefone do usuário
phone.extensionStringExtensão do telefone do usuário
phone.numberStringNúmero de telefone do usuário
alternative_phoneObjectDetalhes do número de telefone alternativo do usuário
alternative_phone.area_codeStringCódigo de área do telefone alternativo do usuário
alternative_phone.extensionStringExtensão do telefone alternativo do usuário
alternative_phone.numberStringNúmero de telefone alternativo do usuário
user_typeStringTipo de usuário (ex.: "real_estate_agency")
tagsArrayLista de etiquetas associadas ao usuário
logoArrayURL ou referência do logo do usuário (pode ser nulo)
pointsNumberPontuação do usuário
site_idStringIdentificador do site (ex.: "MLC")
permalinkArrayLink permanente (permalink) do usuário
seller_experienceStringNível de experiência como vendedor
bill_dataObjectDados de faturamento do usuário
bill_data.accept_credit_noteBooleanIndica se o usuário aceita notas de crédito
seller_reputationObjectDetalhes da reputação do usuário como vendedor
seller_reputation.level_idStringID do nível de vendedor
seller_reputation.power_seller_statusArrayStatus do usuário como “vendedor destacado”
seller_reputation.transactionsObjectDetalhes das transações do vendedor
seller_reputation.transactions.canceledNumberNúmero de transações canceladas
seller_reputation.transactions.completedNumberNúmero de transações concluídas
seller_reputation.transactions.periodStringPeríodo de referência das transações
seller_reputation.transactions.ratingsObjectDetalhes das avaliações recebidas
seller_reputation.transactions.ratings.negativeNumberNúmero de avaliações negativas
seller_reputation.transactions.ratings.neutralNumberNúmero de avaliações neutras
seller_reputation.transactions.ratings.positiveNumberNúmero de avaliações positivas
seller_reputation.transactions.totalNumberTotal de transações realizadas
seller_reputation.metricsObjectMétricas de desempenho do vendedor
seller_reputation.metrics.salesObjectMétricas de vendas
seller_reputation.metrics.sales.periodArrayPeríodo das vendas avaliadas
seller_reputation.metrics.sales.completedNumberNúmero de vendas concluídas
seller_reputation.metrics.claimsObjectMétricas de reclamações
seller_reputation.metrics.claims.periodStringPeríodo de análise de reclamações
seller_reputation.metrics.claims.rateNumberTaxa de reclamações
seller_reputation.metrics.claims.valueNumberValor total das reclamações
seller_reputation.metrics.delayed_handling_timeObjectMétricas de tempo de envio atrasado
seller_reputation.metrics.delayed_handling_time.periodStringPeríodo de análise de atrasos
seller_reputation.metrics.delayed_handling_time.rateNumberTaxa de pedidos atrasados
seller_reputation.metrics.delayed_handling_time.valueNumberValor percentual de atrasos
seller_reputation.metrics.cancellationsObjectMétricas de cancelamentos
seller_reputation.metrics.cancellations.periodStringPeríodo de cancelamentos
seller_reputation.metrics.cancellations.rateNumberTaxa de cancelamentos
seller_reputation.metrics.cancellations.valueNumberValor total dos cancelamentos
buyer_reputationObjectDetalhes da reputação do usuário como comprador
buyer_reputation.canceled_transactionsNumberNúmero de transações canceladas como comprador
buyer_reputation.tagsArrayEtiquetas associadas à reputação do comprador
buyer_reputation.transactionsObjectDetalhes das transações do comprador
buyer_reputation.transactions.canceledArrayTransações canceladas
buyer_reputation.transactions.canceled.paidBooleanIndica se as transações canceladas foram pagas
buyer_reputation.transactions.canceled.totalArrayTotal de transações canceladas
buyer_reputation.transactions.completedArrayNúmero de transações concluídas como comprador
buyer_reputation.transactions.not_yet_ratedArrayTransações ainda não avaliadas
buyer_reputation.transactions.not_yet_rated.paidBooleanIndica se as transações não avaliadas foram pagas

Consultar informações públicas de um usuário

Se você tiver o ID de um usuário que deseja consultar, pode usar o recurso /users para obter as informações públicas desse usuário, executando a seguinte chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID
Parámetro Tipo Opcional Valores
ACCESS_TOKEN string Não Token obtido na guia autenticação.
USER_ID String Não ID do usuário a consultar

Você receberá uma resposta como a seguinte:

{
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "first_name": "Test",
  "last_name": "Test",
  "country_id": "AR",
  "email": "test_user_50698062@testuser.com",
  "identification": {
    "type": "DNI",
    "number": "1111111"
  },
  "address": {
    "state": "AR-C",
    "city": "Palermo",
    "address": "Test Address 123",
    "zip_code": "1414"
  },
  "phone": {
    "area_code": "01",
    "number": "1111-1111",
    "extension": "",
    "verified": false
  },
  "alternative_phone": {
    "area_code": "",
    "number": "",
    "extension": ""
  },
  "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_experience": "ADVANCED",
  "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": {
    "canceled_transactions": 0,
    "transactions": {
      "period": "historic",
      "total": null,
      "completed": null,
      "canceled": {
        "total": null,
        "paid": null
      },
      "unrated": {
        "total": null,
        "paid": null
      },
      "not_yet_rated": {
        "total": null,
        "paid": null,
        "units": null
      }
    },
    "tags": []
  },
  "status": {
    "site_status": "active",
    "list": {
      "allow": true,
      "codes": [],
      "immediate_payment": {
        "required": false,
        "reasons": []
      }
    },
    "buy": {
      "allow": true,
      "codes": [],
      "immediate_payment": {
        "required": false,
        "reasons": []
      }
    },
    "sell": {
      "allow": true,
      "codes": [],
      "immediate_payment": {
        "required": false,
        "reasons": []
      }
    },
    "billing": {
      "allow": true,
      "codes": []
    },
    "mercadopago_tc_accepted": true,
    "mercadopago_account_type": "personal",
    "mercadoenvios": "not_accepted",
    "immediate_payment": false,
    "confirmed_email": false,
    "user_type": "eventual",
    "required_action": ""
  },
  "credit": {
    "consumed": 100,
    "credit_level_id": "MLA1"
  }
}

Usuário vendedor sell equal pay (S = P)

Se você preferir que todas as suas transações sejam realizadas apenas pelo Mercado Pago, deve especificar na configuração da sua conta que aceita somente esse método (S = P, sell equal pay). Ao fazer isso, a opção "Acordo com o vendedor" será desativada automaticamente. Para isso, execute a seguinte chamada PUT:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-type: application/json" -d '{ "reason": "by_user" }' https://api.mercadolibre.com/users/$USER_ID/immediate_payment

Você receberá uma resposta com status 200 OK e o ID do seu usuário modificado:

{
  "id": 2320007493
}

Se quiser desfazer essa ação e aceitar novamente outros métodos além do Mercado Pago, execute o seguinte comando:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/immediate_payment/by_user

Você receberá uma resposta semelhante à anterior.

Consultar usuários bloqueados para pedidos

Para verificar bloqueios vinculados a um comprador específico, você pode usar o recurso block-api/search/users, que fornece detalhes sobre o status do bloqueio. O serviço para bloqueio de pedidos é definido por:

  • Blocked_by_order: Para bloqueios relacionados a pedidos.

Para realizar a consulta, execute o seguinte comando:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/block-api/search/users/{user_id}?type=blocked_by_order

Parâmetros

Parâmetro Tipo Opcional Valores
ACCESS_TOKEN string Não Token obtido no guia de autenticação.
USER_ID String Não ID do usuário a ser consultado
type String Não blocked_by_order para consultar os bloqueios de pedidos do usuário

Se o usuário tiver algum tipo de bloqueio, receberá uma resposta como esta:

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

Se, pelo contrário, o usuário não tiver bloqueios, receberá uma resposta com o array users vazio:

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

Detalhes dos campos da resposta

Parâmetro Tipo de Dado Descrição
usersArrayLista de bloqueios do usuário.
users[].idNumberIdentificador único do usuário bloqueado.
users[].blocked_atStringData e hora em que o usuário foi bloqueado.
pagingObjetoInformações sobre a paginação dos resultados.
paging.offsetNumberNúmero de bloqueios omitidos antes de retornar os resultados.
paging.limitNumberQuantidade máxima de bloqueios a recuperar (padrão 10, máximo 1000).
paging.totalNumberTotal de bloqueios recuperados.

Leituras recomendadas


Atualizações de versão

Esta seção fornece informações sobre as atualizações da API, incluindo:


Histórico de alterações

Data Versão Descrição
08/11/2025 1.0 Publicação inicial