Consultas avançadas

Se sua intenção é que os vendedores usem o aplicativo que você desenvolveu para potencializar seus negócios, leve em conta que existem muitíssimas informações para consumir no mercado e que elas serão úteis para ajudar vendedores a criarem estratégias de venda e tomarem decisões certas em tempo hábil. Você também poderá desenvolver um sistema para comparar preços e atributos entre diversos tipos de anúncios.

Acompanhe nossos guias para saber como aproveitar todos os recursos!

Consultas avançadas

Ajude seus anunciantes a ficarem sempre um passo à frente em seus negócios. Primeiramente, você deve saber que não poderá obter dados privados de usuários que não tiverem concedido permissões para seu aplicativo. No entanto, existem dados públicos que você poderá obter sobre tais usuários, como quem publica nas mesmas categorias que você, a quantidade de anúncios publicados, quais são os preços e atributos que eles praticam em seus anúncios, em quais categorias eles publicam e quantos contatos e visitas eles recebem por dia.

Comparar preços e atributos

Com seu sistema, você pode sugerir aos vendedores qual é o melhor preço para vender seus produtos, mantendo sua competitividade ao analisar o preço do mesmo tipo de produto publicado no Mercado Livre. Para isso, é conveniente aprender a buscar produtos por categoria, consultar o campo de preço desses produtos e calcular a média.

Você também pode desenvolver um sistema para analisar preços e atributos dos produtos classificados, para que compradores possam comparar, localizar e encontrar exatamente aquilo que estão buscando.



Próximo:

Buscar anúncios de um vendedor.
Tirar medidas de visitas e contatos.

Qualifique entre 1 e 5

Gerenciamento de contatos

Toda vez que os usuários fazem uma busca nos produtos classificados, eles podem contatar o proprietário do produto por meio de um formulário exibido na publicação ou podem ver o telefone do proprietário. 
Existe uma diferença de funcionamento para usuários que fizeram login e convidados. Quando usuários convidados fazem uma pergunta sobre seu produto, o contato é dirigido diretamente à caixa de entrada de seu correio eletrônico e é exibido em nosso recurso de contatos, pois não está seguindo o fluxo habitual das perguntas. Quando um usuário que já tem conta em nosso site e já fez login faz uma pergunta, ele segue o fluxo habitual das perguntas e a API de perguntas pode ser usada.

Para ver como trabalhar com perguntas feitas por usuários conectados, consulte nosso guia de Gerenciamento de perguntas e respostas.

Este guia ajudará você a coletar dados sobre perguntas e visualizações de telefone em seus produtos classificados. É uma API somente leitura, muito útil para fazer métricas de seus produtos classificados. Você pode consultar dados sobre perguntas e fazer um registro de quantos cliques a opção “Ver telefone” teve. Você pode consultar por usuário, produto, datas e períodos.

Assuntos:

 

Descrição de parâmetros

TipoParâmetroDescrição
Integer{userId}ID de usuário.
Integer{itemId}ID do produto.
Date{dateFrom}Data, no formato ISO, que define o início da consulta.
Date{dateTo}Data, no formato ISO, que define o final da consulta.
Integer{limit}Opcional. Quantidade máxima de produtos a devolver.
Integer{offset}Opcional. Paginação.
Integer{last}Opcional. Denota quantas horas/dias a amostra abrangerá.
String{unit}Unidade de consulta, valores possíveis: [“dia”, “hora”].
Date{ending}Opcional. Data, em formato ISO, estabelecendo o tempo de finalização da amostra; por padrão, deve ser a data e a hora atuais.
String{order}Opcional. Classifica os resultados por data: [“desc”, “asc”] (por padrão, “asc”).

Total de perguntas

Você pode acessar o total de perguntas que um produto teve, ou o total de perguntas recebidas por um vendedor em todos os seus produtos, em um intervalo de tempo.

Por produto

GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}

Por usuário

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}

Exemplo:

curl -X GET https://api.mercadolibre.com/items/MLV421672596/contacts/questions?date_from=2014-08-01T00:00:00.000-03:00&date_to=2014-08-02T23:59:59.999

Resposta:

{
    "date_from": "2014-08-01T00:00:00.000-03:00",
    "date_to": "2014-08-02T23:59:59.999",
    "item_id": "MLV421672596",
    "total": 9
}

Perguntas por data

Este recurso permite acessar as perguntas sobre um determinado produto ou vendedor durante um intervalo de tempo especificado. Além disso, você obtém detalhes sobre contatos feitos em modo convidado (usuários que não fizeram login ou não são cadastrados), em intervalos de tempo, por hora ou por dia.

Por produto

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?last={Last}&unit={Unit}

Caso você precise concatenar produtos, faça o seguinte:

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?ids={id1,id2}&last={Last}&unit={Unit}&ending={Ending_date}

Por usuário

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions/time_window?last={Last}&unit={Unit}

Exemplo:

curl -X GET https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour

Resposta:

{
    "item_id": "MLA510272257",
    "total": 0,
    "date_from": "2014-08-06T12:00:00Z",
    "date_to": "2014-08-06T14:00:00Z",
    "last": 2,
    "unit": "hour",
    "results": [
        {
            "date": "2014-08-06T12:00:00Z",
            "total": 0
        },
        {
            "date": "2014-08-06T13:00:00Z",
            "total": 0
        }
    ]
}


Total de telefones de contato

Você pode acessar o total de cliques da opção “Ver telefone“ de um produto, ou para cada um dos produtos de um usuário, em intervalos de tempo.

Por produto

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}

Por usuário

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}

Exemplo:

curl -X GET https://api.mercadolibre.com/users/52366166/contacts/phone_views?date_from=2014-05-28T00:00:00.000-03:00&date_to=2014-05-29T23:59:59.999

Resposta:

{
    "date_from": "2014-05-28T00:00:00.000-03:00",
    "date_to": "2014-05-29T23:59:59.999",
    "total": 71,
    "user_id": "52366166"
}

Telefones de contato por data

Você pode acessar o total de cliques da opção “Ver telefone” de um produto, ou para cada um dos produtos de um usuário, durante um determinado intervalo de tempo. Além de fornecer o total de visitas, as informações são listadas e agrupadas por intervalos de tempo.

Por produto

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}

Caso você precise concatenar produtos, faça o seguinte:

curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids={Id1,Id2}&last={Last}&unit={Unit}&ending={Ending_date}

Por usuário

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}

Exemplo:

curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=MLA510272257,MLA489747739&last=2&unit=hour&ending=2014-05-28T00:00:00.000-03:00

Resposta:

[
    {
        "item_id": "MLA510272257",
        "total": 0,
        "date_from": "2014-05-28T02:00:00Z",
        "date_to": "2014-05-28T04:00:00Z",
        "last": 2,
        "unit": "hour",
        "results": [
            {
                "date": "2014-05-28T02:00:00Z",
                "total": 0
            },
            {
                "date": "2014-05-28T03:00:00Z",
                "total": 0
            }
        ]
    },
    {
        "item_id": "MLA489747739",
        "total": 0,
        "date_from": "2014-05-28T02:00:00Z",
        "date_to": "2014-05-28T04:00:00Z",
        "last": 2,
        "unit": "hour",
        "results": [
            {
                "date": "2014-05-28T02:00:00Z",
                "total": 0
            },
            {
                "date": "2014-05-28T03:00:00Z",
                "total": 0
            }
        ]
    }
]




Próximo:
Recebimento de notificações.

Qualifique entre 1 e 5

Sincronização de publicações

Assim que você tiver publicações ativas em nosso Marketplace, é provável que você tenha de fazer atualizações e alterações periodicamente para sincronizar o estoque com outras plataformas com as quais você trabalha, pausar publicações, melhorar descrições, atualizar preços etc.
Leia o guia a seguir e saiba como fazer isso:

Assuntos

Considerações

Nem todos os campos podem ser atualizados, e isso irá variar se o produto já tiver vendas ou não. Além disso, lembre-se de que para poder alterar um produto, ele deve estar ativo. Você pode alterar valores para:

  • Title
  • Available_quantity
  • Price
  • Video
  • Pictures
  • Description
  • Shipping

Se o produto tiver vendas, nenhum dos seguintes campos poderá ser alterado:

  • Title
  • Condition
  • Buying mode
  • Non Mercado Pago Payment Methods
  • Shipping dimensions
  • Warranty

Você também deve lembrar que:

  • A categoria não pode ser alterada através da API.
  • O tipo de publicação só pode ser alterado uma vez.
  • O título não pode ser alterado em um produto que já tenha vendas, a menos que você faça parte das lojas oficiais do Mercado Livre.

Atualização de seu produto

Vejamos um exemplo básico de atualização do título e do preço de um produto. Você só precisará do item_id do produto publicado e do access_token do vendedor.
Exemplo:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "title": "Your new title",
  "price": 1000
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Pronto. O título e o preço de seu produto foram atualizados, e você deverá receber um status de resposta com código 200 OK para confirmar que não houve inconvenientes.
Lembre de que pode demorar um pouco até que as informações atualizadas fiquem visíveis.

Descrições

Atualizar uma descrição é muito simples, e você pode fazer isso independentemente do produto ter ou não alguma oferta. No entanto, como há algumas considerações que você deve lembrar ao adicionar ou substituir descrições, leia o artigo consulte o nosso artigo sobre descrições para ter certeza de que entendeu.

Imagens

Você sempre pode adicionar ou substituir imagens dos produtos. Leia consulte o nosso tutorial Trabalhar com imagens para saber qual a melhor maneira de fazer isso.

Tipos de publicação

Caso você queira dar mais exposição a seu produto, você deve atualizar o tipo de publicação. Conheça os detalhes e as considerações, e aprenda a fazer uma atualização em nosso tutorial Tipos de publicações e upgrades.

Mudança de status das publicações

Qualquer produto publicado em nosso Marketplace pode ter diferentes status; a seguir, analise a descrição de cada um deles:

  • encerrado: finaliza sua publicação. Uma vez encerrada, a publicação não poderá ser ativada novamente, mas pode ser publicada novamente.
  • pausado: pausa sua publicação. Uma vez pausado, o produto não poderá ser visualizado pelos outros usuários do Mercado Livre, mas não será encerrado e poderá ser reativado depois.
  • ativo: reativa um produto previamente pausado.

Se você precisar fazer alterações no status do produto, deverá enviar um desses valores para o campo “status”. Lembre de que o valor diferencia entre letras maiúsculas e minúsculas e deve ser enviado em letras minúsculas.

Para pausar um produto ativo, veja o exemplo a seguir:
Exemplo:

 curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"paused"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Excelente! Seu produto já foi pausado. Agora você já pode tentar reativá-lo fazendo exatamente a mesma chamada, mas enviando “ativo” em vez de “pausado” como valor de status.

Se seu produto está encerrado, e você quer publicá-lo novamente, consulte artigo sobre como publicar novamente para fazer isso rapidamente.
Para obter mais informações sobre o status do produto, consulte o artigo sobre ciclo de vida das publicações.

Exclusão de publicações

Depois de excluir uma publicação, não há como reverter. Por isso, tenha cuidado ao fazer isso. Além disso, lembre-se de que não é necessário excluir os produtos encerrados porque eles serão automaticamente descartados depois de algum tempo.
Mas se você ainda precisar excluir um produto, por exemplo, produtos em estado payment_required, os quais não responderão ao status “encerrado”, faça o seguinte:
Exemplo:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"status": "closed"
}

{
"deleted":"true"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Pronto! Seu produto será excluído.

Atualização do estoque

Atualizar o estoque de um produto é muito fácil. Você só precisa atualizar o valor do campo “available_quantity”.
Exemplo:

 curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "available_quantity": 6
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Fácil. Você pode consultar sua publicação e visualizar o estoque atualizado.


Próximo:
Gerenciamento de contatos.

Qualifique entre 1 e 5

Gerenciamento das áreas de cobertura

Apesar de esse atributo ser opcional, sugerimos especificá-lo, pois poupará tempo para você e outros usuários, já que você não precisará mais responder perguntas sobre o assunto. Saiba como lidar com áreas de cobertura (Link).
As áreas de cobertura farão com que os usuários saibam se o serviço que você está oferecendo tem alcance nas áreas onde eles se encontram. Você deverá enviar cada uma das áreas com IDs pré-estabelecidos, que podem ser encontrados em nossa API.

Assuntos:

Áreas de cobertura por site

Para saber quais são os IDs das áreas de seu país, faça uma chamada combinada entre sites e adicione recursos das áreas de cobertura.

Exemplo:

 https://api.mercadolibre.com/sites/MLA/coverage_areas

Resposta:

 {
    "id": "TUxBUENBUGw3M2E1",
    "description": "Bs.As. Cap. Federal",
    "zone": "Capital Federal",
    "type": "state"
  },
  {
    "id": "TUxBUEdSQWU4ZDkz",
    "description": "Bs.As. G.B.A. Norte",
    "zone": "Gba Norte",
    "type": "state"
  },
  {
    "id": "TUxBUEdSQWVmNTVm",
    "description": "Bs.As. G.B.A. Oeste",
    "zone": "Gba Oeste",
    "type": "state"
  },
  {
    "id": "TUxBUEdSQXJlMDNm",
    "description": "Bs.As. G.B.A. Sur",
    "zone": "Gba Sur",
    "type": "state"
  },
  {
    "id": "TUxBUENPU2ExMmFkMw",
    "description": "Bs.As. Costa Atlántica",
    "zone": "Gba Costa Atlántica",
    "type": "state"
  },
  {
    "id": "TUxBUFpPTmFpbnRl",
    "description": "Bs.As. Zona Interior",
    "zone": "Buenos Aires",
    "type": "state"
  },
  {
    "id": "TUxBUENBVGFiY2Fm",
    "description": "Catamarca",
    "zone": "Catamarca",
    "type": "state"
  },
  {
    "id": "TUxBUENIQW8xMTNhOA",
    "description": "Chaco",
    "zone": "Chaco",
    "type": "state"
  },
  {
    "id": "TUxBUENIVXQxNDM1MQ",
    "description": "Chubut",
    "zone": "Chubut",
    "type": "state"
  },
  {
    "id": "TUxBUENPUmFkZGIw",
    "description": "Córdoba",
    "zone": "Córdoba",
    "type": "state"
  },
  {
    "id": "TUxBUENPUnM5MjI0",
    "description": "Corrientes",
    "zone": "Corrientes",
    "type": "state"
  },
  {
    "id": "TUxBUEVOVHMzNTdm",
    "description": "Entre Ríos",
    "zone": "Entre Ríos",
    "type": "state"
  },
  {
    "id": "TUxBUEZPUmE1OTk5",
    "description": "Formosa",
    "zone": "Formosa",
    "type": "state"
  },
  {
    "id": "TUxBUEpVSnk3YmUz",
    "description": "Jujuy",
    "zone": "Jujuy",
    "type": "state"
  },
  {
    "id": "TUxBUExBWmE1OWMy",
    "description": "La Pampa",
    "zone": "La Pampa",
    "type": "state"
  },
  {
    "id": "TUxBUExBWmEyNzY0",
    "description": "La Rioja",
    "zone": "La Rioja",
    "type": "state"
  },
  {
    "id": "TUxBUE1FTmE5OWQ4",
    "description": "Mendoza",
    "zone": "Mendoza",
    "type": "state"
  },
  {
    "id": "TUxBUE1JU3MzNjIx",
    "description": "Misiones",
    "zone": "Misiones",
    "type": "state"
  },
  {
    "id": "TUxBUE5FVW4xMzMzNQ",
    "description": "Neuquén",
    "zone": "Neuquén",
    "type": "state"
  },
  {
    "id": "TUxBUFLNT29iZmZm",
    "description": "Río Negro",
    "zone": "Río Negro",
    "type": "state"
  },
  {
    "id": "TUxBUFNBTGFjMTJi",
    "description": "Salta",
    "zone": "Salta",
    "type": "state"
  },
  {
    "id": "TUxBUFNBTm5lYjU4",
    "description": "San Juan",
    "zone": "San Juan",
    "type": "state"
  },
  {
    "id": "TUxBUFNBTnM0ZTcz",
    "description": "San Luis",
    "zone": "San Luis",
    "type": "state"
  },
  {
    "id": "TUxBUFNBTno3ZmY5",
    "description": "Santa Cruz",
    "zone": "Santa Cruz",
    "type": "state"
  },
  {
    "id": "TUxBUFNBTmU5Nzk2",
    "description": "Santa Fe",
    "zone": "Santa Fe",
    "type": "state"
  },
  {
    "id": "TUxBUFNBTm9lOTlk",
    "description": "Santiago del Estero",
    "zone": "Santiago Del Estero",
    "type": "state"
  },
  {
    "id": "TUxBUFRJRVoxM2M5YQ",
    "description": "Tierra del Fuego ",
    "zone": "Tierra Del Fuego",
    "type": "state"
  },
  {
    "id": "TUxBUE5FVW4xMzMzNQ",
    "description": "Tucumán",
    "zone": "Tucumán",
    "type": "state"
  },
  {
    "id": "AR",
    "description": "Argentina",
    "zone": "Todo el País",
    "type": "country"
  }

ID da área de cobertura

Acesse os detalhes de uma área específica.
Exemplo:

 https://api.mercadolibre.com/coverage_areas/TUxBUEpVSnk3YmUz

Resposta:

 {
  "id": "TUxBUEpVSnk3YmUz",
  "description": "Jujuy",
  "zone": "Jujuy",
  "type": "state"
}

Adição de áreas de cobertura

Para adicionar áreas de cobertura em uma publicação existente, faça uma solicitação PUT para a API de produtos com o JSON a seguir:

Exemplo:

 curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
coverage_areas: ["TUxBUExBWmEyNzY0","TUxBUEpVSnk3YmUz"]
}



Próximo:
Publicação de serviços.

Qualifique entre 1 e 5

Escolha o tipo de serviço

As categorias são um conjunto hierárquico de grupos nos quais os produtos de natureza semelhante são enumerados, denominados “árvore de categorias”. As categorias ajudam os compradores a encontrar o tipo de produto que desejam, já que o comprador somente deve buscar em uma ou poucas categorias para encontrar o que interessa. Os vendedores aproveitam as categorias para incrementar suas chances de venda graças aos compradores que acessam os produtos mais rapidamente.
Cada site tem seu próprio conjunto de categorias, isto é, a Argentina terá um conjunto de categorias único, diferente do conjunto das categorias do Brasil. https://api.mercadolibre.com/sites/MLB/categories
Antes de publicar um anúncio, você deve explorar a estrutura de categorias e escolher em qual delas quer publicar. Como ajuda, você pode baixar a hierarquia completa de categorias, com ID e nomes simples, de nossa API.

Assuntos

Categorias por site

O recurso Sites pode oferecer a estrutura de categorias de um país em particular, nesse caso, da Argentina.
Exemplo:

curl -X GET https://api.mercadolibre.com/sites/MLA/categories

Resposta:

"categories": [
{
"id": "MLA5725",
"name": "Accesorios para Vehiculos",
},
{
"id": "MLA1071",
"name": "Animales y Mascotas",
},
{
"id": "MLA1367",
"name": "Antigüedades",
},
{
"id": "MLA1743",
"name": "Autos, Motos y Otros",
},

Para categorias do segundo nível ou informações relacionadas com categorias específicas, você deve utilizar o recurso Categories e enviar o ID da categoria como parâmetro URL.
Exemplo:

curl -X GET https://api.mercadolibre.com/categories/MLA1071

Resposta:

{
  "id": "MLA1540",
  "name": "Servicios",
  "picture": "http://resources.mlstatic.com/category/images/3b5619b2-cc62-4775-8e64-05a1e5585bba.png",
  "permalink": "http://www.mercadolibre.com.ar/servicios/",
  "total_items_in_this_category": 33783,
  "path_from_root": [
    {
      "id": "MLA1540",
      "name": "Servicios"
    }
  ],
  "children_categories": [
    {
      "id": "MLA122264",
      "name": "Arte, Música y Cine",
      "total_items_in_this_category": 1134
    },
    {
      "id": "MLA10514",
      "name": "Belleza y Cuidado Personal",
      "total_items_in_this_category": 1029
    },
    {
      "id": "MLA43986",
      "name": "Cursos y Clases",
      "total_items_in_this_category": 1188
    },
    {
      "id": "MLA91058",
      "name": "Delivery",
      "total_items_in_this_category": 338
    },
    {
      "id": "MLA1550",
      "name": "Fiestas y Eventos",
      "total_items_in_this_category": 6840
    },
    {
      "id": "MLA122258",
      "name": "Hogar",
      "total_items_in_this_category": 4067
    },
    {
      "id": "MLA56666",
      "name": "Imprenta",
      "total_items_in_this_category": 717
    },
    {
      "id": "MLA9007",
      "name": "Mantenimiento de Vehículos",
      "total_items_in_this_category": 1980
    },
    {
      "id": "MLA111029",
      "name": "Medicina y Salud",
      "total_items_in_this_category": 641
    },
    {
      "id": "MLA113657",
      "name": "Oficios",
      "total_items_in_this_category": 1994
    },
    {
      "id": "MLA1898",
      "name": "Otros Servicios",
      "total_items_in_this_category": 2842
    },
    {
      "id": "MLA1541",
      "name": "Profesionales",
      "total_items_in_this_category": 2106
    },
    {
      "id": "MLA91088",
      "name": "Ropa y Moda",
      "total_items_in_this_category": 515
    },
    {
      "id": "MLA11813",
      "name": "Servicio Técnico",
      "total_items_in_this_category": 3916
    },
    {
      "id": "MLA11798",
      "name": "Servicios para Mascotas",
      "total_items_in_this_category": 653
    },
    {
      "id": "MLA91083",
      "name": "Servicios para Oficinas",
      "total_items_in_this_category": 262
    },
    {
      "id": "MLA9038",
      "name": "Transporte",
      "total_items_in_this_category": 2316
    },
    {
      "id": "MLA1229",
      "name": "Viajes y Turismo",
      "total_items_in_this_category": 1218
    }
  ],
  "attribute_types": "none",
  "settings": {
    "adult_content": false,
    "buying_allowed": true,
    "buying_modes": [
      "classified"
    ],
    "coverage_areas": "optional",
    "currencies": [
      "ARS",
      "USD"
    ],
    "fragile": false,
    "immediate_payment": "optional",
    "item_conditions": [
      "not_allowed"
    ],
    "items_reviews_allowed": true,
    "max_description_length": 50000,
    "max_pictures_per_item": 12,
    "max_sub_title_length": 70,
    "max_title_length": 60,
    "price": "optional",
    "restrictions": [
    ],
    "rounded_address": false,
    "seller_contact": "required",
    "shipping_modes": [
      "not_specified",
      "custom"
    ],
    "shipping_options": [
    ],
    "shipping_profile": "not_allowed",
    "show_contact_information": true,
    "simple_shipping": "not_allowed",
    "stock": "optional",
    "tags": [
    ],
    "vip_subdomain": "servicio",
    "mirror_category": null,
    "listing_allowed": false,
    "maximum_price": null,
    "minimum_price": null
  },
  "meta_categ_id": null,
  "attributable": false
}

Categorias JSON

Fazer uma chamada para uma categoria específica permitirá saber as informações e descrições específicas dela. A seguir, você encontrará a descrição de alguns desses atributos.

curl https://api.mercadolibre.com/categories/MLA58257
{
  "id": "MLA58257",
  "name": "Estudios de Grabación",
  "picture": null,
  "permalink": null,
  "total_items_in_this_category": 37,
  "path_from_root": [
    {
      "id": "MLA1540",
      "name": "Servicios"
    },
    {
      "id": "MLA122264",
      "name": "Arte, Música y Cine"
    },
    {
      "id": "MLA94730",
      "name": "Música"
    },
    {
      "id": "MLA58257",
      "name": "Estudios de Grabación"
    }
  ],
  "children_categories": [
  ],
  "attribute_types": "none",
  "settings": {
    "adult_content": false,
    "buying_allowed": true,
    "buying_modes": [
      "classified"
    ],
    "coverage_areas": "optional",
    "currencies": [
      "ARS",
      "USD"
    ],
    "fragile": false,
    "immediate_payment": "optional",
    "item_conditions": [
      "not_allowed"
    ],
    "items_reviews_allowed": true,
    "max_description_length": 50000,
    "max_pictures_per_item": 12,
    "max_sub_title_length": 70,
    "max_title_length": 60,
    "price": "optional",
    "restrictions": [
    ],
    "rounded_address": false,
    "seller_contact": "required",
    "shipping_modes": [
      "not_specified",
      "custom"
    ],
    "shipping_options": [
    ],
    "shipping_profile": "not_allowed",
    "show_contact_information": true,
    "simple_shipping": "not_allowed",
    "stock": "optional",
    "tags": [
    ],
    "vip_subdomain": "servicio",
    "mirror_category": null,
    "listing_allowed": true,
    "maximum_price": null,
    "minimum_price": null
  },
  "meta_categ_id": null,
  "attributable": false
}

Nome

Esse atributo mostra uma etiqueta simples. Você não pode usar essa etiqueta para buscar produtos. Caso você queira buscar usando ID de categorias, poderá usar o pedido a seguir:

 curl https://api.mercadolibre.com/sites/MLA/search?category=MLA5726

Acesse mais informações no produto busca de produtos por categoria.

Rota da raiz

Quando você está posicionado em uma categoria, pode saber qual é a rota da raiz para a categoria selecionada.
Veja como o Mercado Livre usa a rota para mostrar a categoria do produto:
image-category (1)

Encontrar a melhor categoria para seu produto

A categoria folha é a última categoria da árvore e a única em que você pode publicar produtos.
A escolha da categoria certa para seu produto determinará a rapidez com que ele será encontrado pelos compradores, melhorando suas chances de venda. Por isso, nós recomendamos utilizar a nossa ferramenta de predição de Categorias antes de publicar um produto.

Talvez algumas das categorias não tenham boas sugestões, por isso, você deverá fazer com que o usuário de seu sistema realize um mapeamento das categorias manualmente para encontrar seus produtos. Um processo mais simples poderia ser a utilização da API de Categorias e a navegação pela árvore de categorias, para detectar qual é a melhor opção. Você deve usar só aquelas categorias recuperadas da API que não tenham subcategorias relacionadas.

Outra opção poderia ser encontrar produtos similares no Mercado Livre para usar a categoria deles.


Próximo:
Gerenciamento das áreas de cobertura.

Qualifique entre 1 e 5

Consulta de usuário avançado

Agora que você já sabe como trabalhar com usuários do Mercado Livre, está na hora de entrarmos nas características especiais deles:

Assuntos

Qualifique entre 1 e 5

Guia para serviços

As publicações de serviços são classificados nos quais os dados de contato dos vendedores são públicos, facilitando aos compradores a comunicação direta com eles. O pagamento e a entrega são coordenados entre as contrapartes sem que exista uma oferta.

Você pode criar aplicativos para publicar serviços e tomar medidas dos contatos, realizar buscas por geolocalização, comparar preços e prestações, salvar favoritos, enviar lembretes, sugerir similares etc.

Acompanhe os guias que apresentamos a seguir para aprender a automatizar cada uma dessas tarefas.


Próximo:
Autorização.

Qualifique entre 1 e 5

Publicação de serviços

Agora que já analisamos os assuntos autenticação, usuários e categorias, acreditamos que você esteja pronto para realizar sua primeira publicação. Leia o tutorial e aprenda a fazer isso:

Assuntos:

Princípios básicos

De modo geral, serviços constitui o único tipo de publicação que permite aos usuários mostrarem suas informações de contato ao público; por isso, toda vez que os usuários buscam serviços para alugar ou comprar e se interessam por uma de suas, podem entrar em contato com você imediatamente. Portanto, nos produtos classificados nenhum tipo de transação é realizado; desse modo você não venderá nem alugará seu serviço diretamente de nosso site, mas vai mostrá-la a todos os usuários que estiverem buscando serviços na Web.

Resultados das publicações

Cada produto que você publicar aparecerá nos resultados das publicações de uma determinada busca. Por exemplo, quando um usuário estiver buscando a consulta “Casa em Mar del Plata”, ele obterá como resultado uma lista de todos os itens relacionados. Seu serviço pode estar incluído nessa lista.
Quando alguém clica em um produto, ele é exibido na página de detalhes do produto junto com todas as informações sobre ele que tenham sido fornecidas no momento da publicação. Para obter mais informações, continue lendo a respeito.

Página Detalhes do serviço

Esta é a página principal de nosso Mercado para cada produto.
Quando um usuário seleciona um produto do resultado, essa página exibe os seguintes detalhes:

  • Item_id
  • Title
  • Category
  • Pictures
  • Price
  • City
  • Sold quantity
  • Questions
  • Seller’s reputation
  • Detailed description

Campos do serviço

Vamos ver um serviço normal pela API. Isso é fácil, pois você só precisa conhecer o item_id associado a tal item e, como ele é público, pode ser obtido na página do item. Na Argentina, isso é encontrado na parte superior da página. É preciso acrescentar o site_id antes do número que está vendo e pronto. Agora você pode chamar o recurso Items para obter todas as informações de que precisa:

Chamada:

 curl - X GET https://api.mercadolibre.com/items/{Item_id}

Exemplo:

 curl - X GET https://api.mercadolibre.com/items/MLA603335359

Resposta:

 {
  "id": "MLA603335359",
  "site_id": "MLA",
  "title": "Semana.santa 190 Por Capacidad Deptos Complejo Angel Del Sol",
  "subtitle": null,
  "seller_id": 50152177,
  "category_id": "MLA50283",
  "official_store_id": null,
  "price": 190,
  "base_price": 190,
  "original_price": null,
  "currency_id": "ARS",
  "initial_quantity": 1,
  "available_quantity": 1,
  "sold_quantity": 0,
  "buying_mode": "classified",
  "listing_type_id": "gold_premium",
  "start_time": "2016-01-31T14:16:20.000Z",
  "stop_time": "2017-01-30T14:16:20.000Z",
  "condition": "used",
  "permalink": "http://inmueble.mercadolibre.com.ar/MLA-603335359-semanasanta-190-por-capacidad-deptos-complejo-angel-del-sol-_JM",
  "thumbnail": "http://mla-s1-p.mlstatic.com/23423-MLA20248368790_022015-I.jpg",
  "secure_thumbnail": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23423-MLA20248368790_022015-I.jpg",
  "pictures": [
    {
      "id": "23423-MLA20248368790_022015",
      "url": "http://mla-s1-p.mlstatic.com/23423-MLA20248368790_022015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23423-MLA20248368790_022015-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    },
    {
      "id": "23447-MLA20248368829_022015",
      "url": "http://mla-s2-p.mlstatic.com/23447-MLA20248368829_022015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23447-MLA20248368829_022015-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    },
    {
      "id": "23431-MLA20248368726_022015",
      "url": "http://mla-s2-p.mlstatic.com/23431-MLA20248368726_022015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23431-MLA20248368726_022015-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    },
    {
      "id": "23451-MLA20248368762_022015",
      "url": "http://mla-s2-p.mlstatic.com/23451-MLA20248368762_022015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23451-MLA20248368762_022015-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    },
    {
      "id": "23446-MLA20248368859_022015",
      "url": "http://mla-s1-p.mlstatic.com/23446-MLA20248368859_022015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23446-MLA20248368859_022015-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    },
    {
      "id": "23449-MLA20248368490_022015",
      "url": "http://mla-s2-p.mlstatic.com/23449-MLA20248368490_022015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23449-MLA20248368490_022015-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    },
    {
      "id": "23466-MLA20248368893_022015",
      "url": "http://mla-s1-p.mlstatic.com/23466-MLA20248368893_022015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23466-MLA20248368893_022015-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    },
    {
      "id": "23475-MLA20248368922_022015",
      "url": "http://mla-s2-p.mlstatic.com/23475-MLA20248368922_022015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23475-MLA20248368922_022015-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    },
    {
      "id": "23425-MLA20248370717_022015",
      "url": "http://mla-s1-p.mlstatic.com/23425-MLA20248370717_022015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23425-MLA20248370717_022015-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    },
    {
      "id": "23448-MLA20248370762_022015",
      "url": "http://mla-s1-p.mlstatic.com/23448-MLA20248370762_022015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23448-MLA20248370762_022015-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    },
    {
      "id": "23403-MLA20248370781_022015",
      "url": "http://mla-s2-p.mlstatic.com/23403-MLA20248370781_022015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23403-MLA20248370781_022015-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    },
    {
      "id": "23480-MLA20248371283_022015",
      "url": "http://mla-s2-p.mlstatic.com/23480-MLA20248371283_022015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23480-MLA20248371283_022015-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    }
  ],
  "video_id": null,
  "descriptions": [
    {
      "id": "MLA603335359-1022043551"
    }
  ],
  "accepts_Mercado Pago": false,
  "non_mercado_pago_payment_methods": [
  ],
  "shipping": {
    "mode": "not_specified",
    "local_pick_up": false,
    "free_shipping": false,
    "methods": [
    ],
    "dimensions": null,
    "tags": [
    ]
  },
  "international_delivery_mode": "none",
  "seller_address": {
    "id": 153363213,
    "comment": "ferreteria antartida",
    "address_line": "av3 y paseo127 111111",
    "zip_code": "7165",
    "city": {
      "id": "TUxBQ1ZJTGU4OGM3",
      "name": "Villa Gesell"
    },
    "state": {
      "id": "AR-B",
      "name": "Buenos Aires"
    },
    "country": {
      "id": "AR",
      "name": "Argentina"
    },
    "latitude": -37.25747514,
    "longitude": -56.97445905,
    "search_location": {
      "neighborhood": {
        "id": "",
        "name": ""
      },
      "city": {
        "id": "TUxBQ1ZJTGU4OGM3",
        "name": "Villa Gesell"
      },
      "state": {
        "id": "TUxBUENPU2ExMmFkMw",
        "name": "Bs.As. Costa Atlántica"
      }
    }
  },
  "seller_contact": {
    "contact": "",
    "other_info": "",
    "area_code": "",
    "phone": "",
    "area_code2": "",
    "phone2": "",
    "email": "",
    "webpage": ""
  },
  "location": {
    "address_line": "PASEO 141 BIS Y 4 4100",
    "zip_code": "",
    "neighborhood": {
      "id": "",
      "name": ""
    },
    "city": {
      "id": "TUxBQ1ZJTGU4OGM3",
      "name": "Villa Gesell"
    },
    "state": {
      "id": "TUxBUENPU2ExMmFkMw",
      "name": "Bs.as. Costa Atlántica"
    },
    "country": {
      "id": "AR",
      "name": "Argentina"
    },
    "latitude": -37.2598939,
    "longitude": -56.9714194,
    "open_hours": ""
  },
  "geolocation": {
    "latitude": -37.2598939,
    "longitude": -56.9714194
  },
  "coverage_areas": [
  ],
  "attributes": [
    {
      "id": "CAPPERSO",
      "name": "Capacidad de personas",
      "value_id": "CAPPERSO-5",
      "value_name": "5",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "CKECKIN",
      "name": "Check in",
      "value_id": "CKECKIN-11:00",
      "value_name": "11:00",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "CKECKOUT",
      "name": "Check out",
      "value_id": "CKECKOUT-09:00",
      "value_name": "09:00",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "FECHADESDE",
      "name": "Desde",
      "value_id": "",
      "value_name": "1 de nero",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "FECHAHASTA",
      "name": "Hasta",
      "value_id": "",
      "value_name": "TODO EL AÑO",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "MLA50283-CUADRCENT",
      "name": "A cuantas cuadras del centro",
      "value_id": "MLA50283-CUADRCENT-1",
      "value_name": "1",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "MLA50283-CUADRMAR",
      "name": "A cuantas cuadras del mar",
      "value_id": "MLA50283-CUADRMAR-4",
      "value_name": "4",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "MLA50283-NUMVAJI",
      "name": "Vajilla para # de personas",
      "value_id": "MLA50283-NUMVAJI-6",
      "value_name": "6",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "MLA50283-SEÑA",
      "name": "% de seña",
      "value_id": "MLA50283-SEÑA-MAS-DE-50%",
      "value_name": "Más de 50%",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "NUMEROCAMA",
      "name": "Número de camas",
      "value_id": "NUMEROCAMA-6",
      "value_name": "6",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "PERIOTEMPO",
      "name": "Estadía Mínima",
      "value_id": "PERIOTEMPO-15",
      "value_name": "15",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "TIPOHABITA",
      "name": "Tipo de habitación",
      "value_id": "TIPOHABITA-HABPRIVA",
      "value_name": "Habitación privada",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "BALTERR",
      "name": "Balcón",
      "value_id": "BALTERR-N",
      "value_name": "No",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "COCI",
      "name": "Cocina",
      "value_id": "COCI-Y",
      "value_name": "Si",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "COME",
      "name": "Comedor diario",
      "value_id": "COME-Y",
      "value_name": "Si",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "DEPSERV",
      "name": "Dependencia de servicio",
      "value_id": "DEPSERV-N",
      "value_name": "No",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "DORMSUIT",
      "name": "Dormitorio en suite",
      "value_id": "DORMSUIT-Y",
      "value_name": "Si",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "ESCRITORIO",
      "name": "Escritorio",
      "value_id": "ESCRITORIO-N",
      "value_name": "No",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "ESTAR",
      "name": "Estar",
      "value_id": "ESTAR-N",
      "value_name": "No",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "LAVA",
      "name": "Lavadero",
      "value_id": "LAVA-Y",
      "value_name": "Si",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "LIVCOM",
      "name": "Living comedor",
      "value_id": "LIVCOM-Y",
      "value_name": "Si",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "LIVI",
      "name": "Living",
      "value_id": "LIVI-N",
      "value_name": "No",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "PAT",
      "name": "Patio",
      "value_id": "PAT-Y",
      "value_name": "Si",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "PLAYROOM",
      "name": "Playroom",
      "value_id": "PLAYROOM-N",
      "value_name": "No",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "TERRA",
      "name": "Terraza",
      "value_id": "TERRA-N",
      "value_name": "No",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "TOIL",
      "name": "Toilette",
      "value_id": "TOIL-N",
      "value_name": "No",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "VEST",
      "name": "Vestidor",
      "value_id": "VEST-N",
      "value_name": "No",
      "attribute_group_id": "AMBIENTES",
      "attribute_group_name": "Ambientes"
    },
    {
      "id": "AIRCEN",
      "name": "Aire acondicionado",
      "value_id": "AIRCEN-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "AMOBL",
      "name": "Amoblado",
      "value_id": "AMOBL-Y",
      "value_name": "Si",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "APTOFAMILY",
      "name": "Apto para familias/niños",
      "value_id": "APTOFAMILY-Y",
      "value_name": "Si",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "APTOFUMA",
      "name": "Apto para fumadores",
      "value_id": "APTOFUMA-Y",
      "value_name": "Si",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "BAR",
      "name": "Bar",
      "value_id": "BAR-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "CAJASEG",
      "name": "Caja de seguridad",
      "value_id": "CAJASEG-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "CALCEN",
      "name": "Calefacción",
      "value_id": "CALCEN-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "CANCHAGOLF",
      "name": "Cancha de golf",
      "value_id": "CANCHAGOLF-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "CANCHAPADD",
      "name": "Cancha de paddle",
      "value_id": "CANCHAPADD-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "CANFUT",
      "name": "Cancha de fútbol",
      "value_id": "CANFUT-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "CONINT",
      "name": "Conexión a internet",
      "value_id": "CONINT-Y",
      "value_name": "Si",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "DESAYUNOINCLU",
      "name": "Desayuno incluido",
      "value_id": "DESAYUNOINCLU-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "ESTACIOINCLU",
      "name": "Estacionamiento",
      "value_id": "ESTACIOINCLU-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "HIDRO",
      "name": "Hidromasaje",
      "value_id": "HIDRO-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "JARD",
      "name": "Jardín",
      "value_id": "JARD-Y",
      "value_name": "Si",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "LAVASECA",
      "name": "Lavarropa/Secarropa",
      "value_id": "LAVASECA-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "MLA50283-CALE",
      "name": "Calefón",
      "value_id": "MLA50283-CALE-Y",
      "value_name": "Si",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "MLA50283-DEPOGA",
      "name": "Depósito en garantía $",
      "value_id": "",
      "value_name": "3000",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "MLA50283-DVD",
      "name": "DVD",
      "value_id": "MLA50283-DVD-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "MLA50283-GASNAT",
      "name": "Gas natural",
      "value_id": "MLA50283-GASNAT-Y",
      "value_name": "Si",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "MLA50283-ROPABL",
      "name": "Ropa blanca",
      "value_id": "MLA50283-ROPABL-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "MLA50283-TERMO",
      "name": "Termotanque",
      "value_id": "MLA50283-TERMO-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "MLA50283-VENTITE",
      "name": "Ventilador de techo",
      "value_id": "MLA50283-VENTITE-Y",
      "value_name": "Si",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "PARR",
      "name": "Parrilla",
      "value_id": "PARR-Y",
      "value_name": "Si",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "PERMIMASCO",
      "name": "Permite mascotas",
      "value_id": "PERMIMASCO-Y",
      "value_name": "Si",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "PHONETEPAN",
      "name": "Linea telefónica",
      "value_id": "PHONETEPAN-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "PILNAT",
      "name": "Pileta",
      "value_id": "PILNAT-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "QUINCHO",
      "name": "Quincho",
      "value_id": "QUINCHO-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "RESTAUR",
      "name": "Restaurante",
      "value_id": "RESTAUR-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "SAUNA",
      "name": "Sauna",
      "value_id": "SAUNA-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "SOLARI",
      "name": "Solarium",
      "value_id": "SOLARI-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "SOM",
      "name": "SUM",
      "value_id": "SOM-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "SPA",
      "name": "Spa",
      "value_id": "SPA-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "TVXCABLE",
      "name": "TV por cable",
      "value_id": "TVXCABLE-Y",
      "value_name": "Si",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "VIGI",
      "name": "Seguridad",
      "value_id": "VIGI-N",
      "value_name": "No",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "WIFI",
      "name": "Wifi",
      "value_id": "WIFI-Y",
      "value_name": "Si",
      "attribute_group_id": "COMODIDADES",
      "attribute_group_name": "Comodidades"
    },
    {
      "id": "MLA1459-HORPREF",
      "name": "Horario de contacto",
      "value_id": "",
      "value_name": "de 8 a 22",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1459-INMUEBLE",
      "name": "Inmueble",
      "value_id": "MLA1459-INMUEBLE-OTRO_INMUEBLE",
      "value_name": "Otros Inmuebles",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1459-OPERACION",
      "name": "Operación",
      "value_id": "MLA1459-OPERACION-ALQUILER_DE_TEMPORADA",
      "value_name": "Alquiler Temporario",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1892-ANTIG",
      "name": "Antigüedad",
      "value_id": "MLA1892-ANTIG-MAX_10_ANOS",
      "value_name": "Max 10 años",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1892-ESTADO",
      "name": "Estado",
      "value_id": "MLA1892-ESTADO-MUY_BUENO",
      "value_name": "Muy bueno",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1892-MTRS",
      "name": "Superficie cubierta (m²)",
      "value_id": "",
      "value_name": "35",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1892-MTRSTOTAL",
      "name": "Superficie total (m²)",
      "value_id": "",
      "value_name": "44",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1892-TIPOINMUEB",
      "name": "Tipo de inmueble",
      "value_id": "",
      "value_name": "petit hotel",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    }
  ],
  "warnings": [
  ],
  "listing_source": "",
  "variations": [
  ],
  "status": "active",
  "sub_status": [
  ],
  "tags": [
  ],
  "warranty": null,
  "catalog_product_id": null,
  "parent_item_id": null,
  "differential_pricing": null,
  "deal_ids": [
  ],
  "automatic_relist": false,
  "date_created": "2016-01-31T14:16:20.000Z",
  "last_updated": "2016-02-01T05:46:48.000Z"
}

Obtenção da resposta usando nossos SDKs.

http://developers.mercadolibre.com/list-your-item/ - listing-type-attribute

A resposta JSON contém muitas informações. A seguir, você encontrará a descrição de alguns desses campos.

Definição de atributos

É necessário saber que, ao criar um JSON para seu produto, alguns dos campos são obrigatórios, enquanto outros podem ser omitidos ou serão automaticamente adicionados pelo ML. Eles definirão o modo como o produto será exibido e sua posição nos resultados da busca.

Title

Embora você possa enviar um título que será exibido na página de detalhes do produto, nos itens classificados, os usuários que estiverem fazendo uma busca visualizarão um título na lista, o qual é gerado pelo Mercado Livre com base nos atributos que você configurou para tal produto.

Description

Uma descrição detalhada irá melhorar suas possibilidades de alugar ou vender seu serviço e fará com que você poupe tempo, já que não terá de responder a perguntas desnecessárias. Pode ser uma descrição somente com texto, ou você pode adicionar seu próprio HTML personalizado. Ao trabalhar com descrições, há algumas considerações a serem levadas em conta. Se você estiver interessado em saber mais sobre o assunto, consulte nosso guia Trabalhando com descrições.

Pictures

Imagens de boa qualidade podem fazer com que seu serviço seja mais atrativo e dão aos usuários uma ideia mais precisa de como ele é. Basicamente, você deve adicionar um conjunto de até seis imagens URL no JSON.

 {
 ....
 "pictures":[
  {"source":"http://yourServer/path/to/your/picture.jpg"},
  {"source":"http://yourServer/path/to/your/otherPicture.gif"},
  {"source":"http://yourServer/path/to/your/anotherPicture.png"}
 ]
 ...
}

Recomendamos não usar servidores lentos para hospedar suas imagens, pois pode gerar inconvenientes ao fazer a publicação.
Você também pode adicionar ou alterar as imagens de seu produto aqui posteriormente. Leia mais sobre isso para saber quais são os tipos de imagens permitidas e como trabalhar com elas.

Category

Os vendedores deverão definir uma categoria no site do Mercado Livre. Esse atributo é obrigatório e somente aceita IDs pré-estabelecidos. Para obter mais informações, leia o guia de categorias Para obter uma sugestão de categorias, acesse leia o artigo.

 {
 ....
  "category_id":"MLA12683",
 ...
}

Price

Este atributo é obrigatório. Ao definir um novo produto, ele deve ter um preço. Sugerimos que você busque produtos similares em nosso Marketplace para saber qual é o melhor preço e aumentar sua competitividade. Se você já tiver definido um preço, mas não está satisfeito com ele, poderá alterá-lo posteriormente. Saiba como modificar produtos.

Currency

Além do preço, você deverá definir uma moeda. Esse atributo também é obrigatório. A moeda deverá ser definida usando um ID pré-estabelecido. Você vai saber qual é o ID a enviar chamando para o recurso Moedas.

Seller Custom Field

Apesar de não ser obrigatório, o campo personalizável do vendedor, é muito útil porque não há valores pré-estabelecidos e você pode enviar tudo que quiser como uma cadeia de caracteres. A maior parte dos vendedores utiliza esse campo para colocar seus próprios SKUs para seus produtos para identificar o produto vendido no pedido.
Exemplo:

curl -X PUT -d '{"seller_custom_field": "21000093"}' https://api.mercadolibre.com/items/MLA599074368?access_token=¢ACCESS_TOKEN

Listing type

Trata-se de outro caso de atributo obrigatório que só aceita valores pré-definidos e é muito importante que você entenda isso.
Existem diferentes tipos de publicação disponíveis para cada site. Você deve fazer uma chamada mista através dos sites e dos recursos listing_types para saber quais são os listing_types aceitos. Siga nosso guia para saber qual o tipo de publicação mais conveniente para seu serviço.

Chamada:

 curl https://api.mercadolibre.com/sites/{Site_id}/listing_types

Exemplo:

 curl https://api.mercadolibre.com/sites/MLA/listing_types

Resposta:

 [
  {
    "site_id": "MLA",
    "id": "gold_pro",
    "name": "Oro Premium Full"
  },
  {
    "site_id": "MLA",
    "id": "gold_premium",
    "name": "Oro Premium"
  },
  {
    "site_id": "MLA",
    "id": "gold_special",
    "name": "Oro Profesional"
  },
  {
    "site_id": "MLA",
    "id": "gold",
    "name": "Oro"
  },
  {
    "site_id": "MLA",
    "id": "silver",
    "name": "Plata"
  },
  {
    "site_id": "MLA",
    "id": "bronze",
    "name": "Bronce"
  },
  {
    "site_id": "MLA",
    "id": "free",
    "name": "Gratuita"
  }
]

Publicação de um serviço

Agora você já está pronto para publicar seu primeiro item classificado. Lembre de que, para isso, você vai precisar de um access_token. Se tiver dúvidas sobre como obter seu token de acesso, consulte o tutorial Primeiros passos. Além isso, recomendamos validar o JSON que estiver enviando antes de realizar a solicitação POST.
Você pode criar um JSON para seu produto com base no exemplo abaixo, ou simplesmente enviá-lo, e você estará publicando um produto de amostra no site:

 curl -X POST -H "Content-Type: application/json" -d{
  title: "Property title",
  category_id: "MLA1474",
  price: 100000,
  currency_id: "ARS",
  available_quantity: 1,
  buying_mode: "classified",
  listing_type_id: "silver",
  condition: "not_specified",
  pictures: [
    {
      id: "MLA2096545948_102011"
    },
    {
      source:"http://media.point2.com/p2a/htmltext/f2a4/590f/3627/f49be256595a86c91457/original.jpg"
    }
  ],
  seller_contact: {
    contact: "Contact name",
    other_info: "Additional contact info",
    area_code: "011",
    phone: "4444-5555",
    area_code2: "",
    phone2: "",
    email: "contact-email@somedomain.com",
    webmail: ""
  },
  location: {
    address_line: "My property address 1234",
    zip_code: "01234567",
    neighborhood: {
      id: "TUxBQlBBUzgyNjBa"
    },
    latitude: -34.48755,
    longitude: -58.56987,
  },
  attributes: [
    {
      id: "MLA1472-ANTIG",
      value_id: "MLA1472-ANTIG-A_ESTRENAR"
    },
    {
      id: "MLA1472-DISPOSIC",
      value_id: "MLA1472-DISPOSIC-FRENTE"
    },
    {
      id: "MLA1472-AMBQTY",
      value_id: "MLA1472-AMBQTY-2"
    },
    {
      id: "MLA1472-BATHQTY",
      value_id: "MLA1472-BATHQTY-1"
    },
    {
      id: "MLA1472-DORMQTY",
      value_id: "MLA1472-DORMQTY-2"
    },
    {
      id: "MLA1472-EDIFIC",
      value_id: "MLA1472-EDIFIC-DEPARTAMENTO"
    },
    {
      id: "MLA1472-MTRS",
      value_name: "80"
    },
    {
      id: "MLA1472-MTRSTOTAL",
      value_name: "100"
    }
  ],
  description : "This is the real estate property description."
}

Observe que o exemplo acima só funciona no MLA (Argentina). Caso você esteja trabalhando em qualquer outro país, deverá substituir os valores de category_id, currency_id e talvez listing_type_id.

A API Produtos baixará automaticamente as imagens fornecidas no Mercado Livre Storage, criando uma publicação para seu produto. Você receberá a seguinte resposta JSON:

 {
  "id":"MLA430387888",
  "site_id":"MLA",
  "title":"Anteojos Ray Ban Wayfare",
  "sold_quantity":0,
  "permalink":"http://articulo.mercadolibre.com.ar/MLA-430387888-anteojos-ray-ban-wayfare-_JM",
  ...
}

Parabéns! Você publicou seu primeiro produto! Acesse a página Detalhes do produto por meio do permalink.

Para calcular os feeds de venda de um produto por diferentes parâmetros, acompanhar o guia da Calculadora de preços de publicações.
Nota: se você experimentar algum inconveniente ao tentar publicar, consulte os valores de referência da tabela de códigos de erro da API localizados no final deste guia.



Próximo:
Sincronização de publicações

Qualifique entre 1 e 5

Consulta de usuários

Caso você já tenha conseguido registrar seu aplicativo, tenha feito a autenticação e gerado um usuário de teste, você deverá aprender a trabalhar com usuários (vendedores e compradores):

O tutorial abaixo o ensinará a realizar as seguintes ações:

Consultar meus dados pessoais

Se você já tiver feito login no Mercado Livre e tiver um token, poderá fazer a seguinte chamada para saber quais são as informações relacionadas a seu usuário:

Exemplo:

 curl  - X GET https://api.mercadolibre.com/users/me?access_token=$ACCESS_TOKEN

Resposta:

 {
  "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": "real_estate_agency",
  "tags": [
    "real_estate_agency",
    "test_user",
    "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
  "shipping_modes": [
    "custom",
    "not_specified"
  ],
  "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": [
      ]
    },
    "Mercado Pago_tc_accepted": true,
    "Mercado Pago_account_type": "personal",
    "Mercado Envios": "not_accepted",
    "immediate_payment": false,
    "confirmed_email": false,
    "user_type": "eventual",
    "required_action": ""
  },
  "credit": {
    "consumed": 100,
    "credit_level_id": "MLA1"
  }
}

Consultar dados de terceiros

Se você quiser consultar dados de usuários, terceiros poderá identificar dois níveis de informações: dados públicos, aqueles que podem ser encontrados navegando pelo perfil no Mercado Livre de qualquer outro usuário, Ex.: http://perfil.mercadolibre.com.ar/TETE2870021 e dados privados, que não poderão ser visualizados, a menos que você tenha permissões de usuário e um token válido para trabalhar em nome dele.
Em ambos os casos, a primeira coisa que você deverá conhecer é o id do usuário.

Obter o Id de usuário

Se você não sabe o id, mas sabe o apelido e o site ao qual um usuário pertence, você poderá obtê-lo fazendo a seguinte busca:

Chamada:

 https://api.mercadolibre.com/sites/{Site_id}/search?nickname={Nickname}

Exemplo:

 https://api.mercadolibre.com/sites/MLA/search?nickname=TETE2870021

Resposta:

 {
  "site_id": "MLA",
  "seller": {
    "id": 202593498,
    "seller_reputation": {
      "power_seller_status": null
    },
    "real_estate_agency": false,
    "car_dealer": false,
    "tags": [
    ]
  },
  "paging": {
    "total": 2,
    "offset": 0,
    "limit": 50
  },
  "results": [
    {
      "id": "MLA598903377",
      "site_id": "MLA",
      "title": "Test Item - Nao Ofertar",
      "subtitle": null,
      "seller": {
        "id": 202593498,
        "power_seller_status": null,
        "car_dealer": false,
        "real_estate_agency": false,
        "tags": [
        ]
      },
      "price": 200,
      "currency_id": "ARS",
      "available_quantity": 1,
      "sold_quantity": 0,
      "buying_mode": "buy_it_now",
      "listing_type_id": "bronze",
      "stop_time": "2016-03-06T17:16:49.000Z",
      "condition": "new",
      "permalink": "http://articulo.mercadolibre.com.ar/MLA-598903377-test-item-nao-ofertar-_JM",
      "thumbnail": "http://mla-s2-p.mlstatic.com/546311-MLA20539702714_012016-I.jpg",
      "accepts_Mercado Pago": true,
      "installments": {
        "quantity": 6,
        "amount": 42.33,
        "currency_id": "ARS"
      },
      "address": {
        "state_id": "AR-C",
        "state_name": "Capital Federal",
        "city_id": "",
        "city_name": "Palermo"
      },
      "shipping": {
        "free_shipping": false,
        "mode": "not_specified"
      },
      "seller_address": {
        "id": 175597910,
        "comment": "",
        "address_line": "",
        "zip_code": "",
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "state": {
          "id": "AR-C",
          "name": "Capital Federal"
        },
        "city": {
          "id": "",
          "name": "Palermo"
        },
        "latitude": -34.571148,
        "longitude": -58.423298
      },
      "attributes": [
      ],
      "original_price": null,
      "category_id": "MLA374515",
      "official_store_id": null
    },
    {
      "id": "MLA599121050",
      "site_id": "MLA",
      "title": "Item De Test - No Ofertar",
      "subtitle": null,
      "seller": {
        "id": 202593498,
        "power_seller_status": null,
        "car_dealer": false,
        "real_estate_agency": false,
        "tags": [
        ]
      },
      "price": 1000,
      "currency_id": "ARS",
      "available_quantity": 1,
      "sold_quantity": 0,
      "buying_mode": "buy_it_now",
      "listing_type_id": "bronze",
      "stop_time": "2016-03-07T20:12:41.000Z",
      "condition": "new",
      "permalink": "http://articulo.mercadolibre.com.ar/MLA-599121050-item-de-test-no-ofertar-_JM",
      "thumbnail": "http://mla-s2-p.mlstatic.com/493311-MLA20538550251_012016-I.jpg",
      "accepts_Mercado Pago": true,
      "installments": {
        "quantity": 6,
        "amount": 211.65,
        "currency_id": "ARS"
      },
      "address": {
        "state_id": "AR-C",
        "state_name": "Capital Federal",
        "city_id": "",
        "city_name": "Palermo"
      },
      "shipping": {
        "free_shipping": false,
        "mode": "not_specified"
      },
      "seller_address": {
        "id": 175597910,
        "comment": "",
        "address_line": "",
        "zip_code": "",
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "state": {
          "id": "AR-C",
          "name": "Capital Federal"
        },
        "city": {
          "id": "",
          "name": "Palermo"
        },
        "latitude": -34.571148,
        "longitude": -58.423298
      },
      "attributes": [
      ],
      "original_price": null,
      "category_id": "MLA90105",
      "official_store_id": null
    }
  ],
  "secondary_results": [
  ],
  "related_results": [
  ],
  "sort": {
    "id": "relevance",
    "name": "More relevant"
  },
  "available_sorts": [
    {
      "id": "price_asc",
      "name": "Lower price"
    },
    {
      "id": "price_desc",
      "name": "Higher price"
    }
  ],
  "filters": [
  ],
  "available_filters": [
    {
      "id": "category",
      "name": "Categories",
      "type": "text",
      "values": [
        {
          "id": "MLA1648",
          "name": "Computación",
          "results": 1
        },
        {
          "id": "MLA1430",
          "name": "Ropa y Accesorios",
          "results": 1
        }
      ]
    },
    {
      "id": "state",
      "name": "Location",
      "type": "text",
      "values": [
        {
          "id": "TUxBUENBUGw3M2E1",
          "name": "Capital Federal",
          "results": 2
        }
      ]
    },
    {
      "id": "accepts_Mercado Pago",
      "name": "Mercado Pago filter",
      "type": "boolean",
      "values": [
        {
          "id": "yes",
          "name": "With Mercado Pago",
          "results": 2
        }
      ]
    },
    {
      "id": "installments",
      "name": "Pago",
      "type": "text",
      "values": [
        {
          "id": "yes",
          "name": "Installments",
          "results": 2
        },
        {
          "id": "no_interest",
          "name": "Sin interés",
          "results": 0
        }
      ]
    },
    {
      "id": "condition",
      "name": "Condition filter",
      "type": "text",
      "values": [
        {
          "id": "new",
          "name": "New",
          "results": 2
        }
      ]
    },
    {
      "id": "buying_mode",
      "name": "Buying mode filter",
      "type": "text",
      "values": [
        {
          "id": "buy_it_now",
          "name": "Buy it now",
          "results": 2
        }
      ]
    },
    {
      "id": "has_pictures",
      "name": "Items with images filter",
      "type": "boolean",
      "values": [
        {
          "id": "yes",
          "name": "With pictures",
          "results": 2
        }
      ]
    }
  ]
}

Consultar informações públicas

Desse modo, você já conhece o Id do usuário, portanto pode realizar a chamada ao recurso users da seguinte maneira, obtendo as informações públicas do usuário que quiser:

Chamada:

 curl GET -X  https://api.mercadolibre.com/users/{User_id}

Exemplo:

 GET -X  https://api.mercadolibre.com/users/202593498

Resposta:

 {
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "country_id": "AR",
  "address": {
    "state": "AR-C",
    "city": "Palermo"
  },
  "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_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": {
    "tags": [
    ]
  },
  "status": {
    "site_status": "active"
  }
}

Consultar informações privadas de um usuário que aceitou o uso de meu aplicativo

Para obter os dados privados de um usuário, você apenas deve adicionar o ACCESS_TOKEN do usuário ao final da chamada que fez anteriormente.

Chamada:

 curl GET -X  https://api.mercadolibre.com/users/{User_id}?access_token=¢ACCESS_TOKEN

Exemplo:

 curl GET -X  https://api.mercadolibre.com/users/202593498?access_token=¢ACCESS_TOKEN

Resposta:

 {
  "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",
  "shipping_modes": [
    "custom",
    "not_specified"
  ],
  "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": [
      ]
    },
    "Mercado Pago_tc_accepted": true,
    "Mercado Pago_account_type": "personal",
    "Mercado Envios": "not_accepted",
    "immediate_payment": false,
    "confirmed_email": false,
    "user_type": "eventual",
    "required_action": ""
  },
  "credit": {
    "consumed": 100,
    "credit_level_id": "MLA1"
  }
}

Como pode ver, dessa vez você obteve uma quantidade maior de dados do usuário: nome e sobrenome, e-mail, telefone, endereço etc. Solicitamos que não revele esses dados publicamente, pois isso pode prejudicar o usuário.

Atualizar dados de usuário

Você pode utilizar nossos recursos para atualizar suas informações de usuário depois do cadastramento. Isso é feito normalmente, porque nessa instância ninguém solicitará que você preencha seu endereço ou identificação pessoal, mas você deverá mantê-los completos, ou não poderá publicar produtos no Mercado Livre.
Para atualizar suas informações de usuário, veja o exemplo abaixo:

 curl -X PUT -H "Content-Type: application/json" -d
{
"identification_type": "DNI",
"identification_number": "33333333",
"address": "Triunvirato 5555",
"state":"AR-C",
"city":"Capital Federal",
"zip_dode": "1431",
"phone":{
        "area_code":"011",
        "number":"4444-4444",
        "extension":"001"
        },
"first_name":"Pedro",
"last_name": "Picapiedras",
"company":{
          "corporate_name":"Acme",
          "brand_name":"Acme Company"
          },
"Mercado Envios": "accepted"
}

https://api.mercadolibre.com/users/{User_id}?access_token= 

Parabéns! Você atualizou suas informações de usuário! Lembre-se de enviar somente os campos que quiser atualizar.

Códigos de erro comuns

206 – Partial content: muitas vezes, o recurso Users API retorna um código 206 – Partial content. Isso ocorrerá quando a solicitação de alguns dos dados falhar (por exemplo, reputação do usuário) informando que você receberá uma resposta incompleta.


Artigos relacionados :
Endereços do usuário.


Próximo:
Escolha o tipo de serviço.

Qualifique entre 1 e 5

Autenticação e Autorização

A plataforma do Mercado Livre permite trabalhar com recursos públicos e privados da API através de chamadas HTTP com os verbos GET, PUT, POST, DELETE e OPTIONS.
O acesso a recursos públicos, como sites e categories disponíveis, pode ser feito de forma anônima, mas os recursos privados e as ações próprias dos usuários, como anunciar um item, responder perguntas ou ver informações de vendas/compras, precisam de autorização mediante um aplicativo.
Por isso, no seguinte guia explicaremos o significado de autenticação e o fluxo de autorização que deve ser aplicado para ter um access_token (senha de acesso a recursos privados por cada usuário que o aplicativo autorizar -válida por 6 horas).
Por exemplo:
Sem access_token (Recurso público)

https://api.mercadolibre.com/users/226384143/

{
  "id": 226384143,
  "nickname": "TETE9928972",
  "registration_date": "2016-08-25T11:36:00.000-04:00",
  "country_id": "AR",
  "address": {
    "state": "AR-C",
    "city": "Palermo"
  },
  "user_type": "normal",
  "tags": [
    "normal",
    "test_user",
    "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE9928972",
  "seller_reputation": {
    "level_id": null,
    "power_seller_status": null,
    "transactions": {
      "period": "historic",
      "total": 1,
      "completed": 1,
      "canceled": 0,
      "ratings": {
        "positive": 0,
        "negative": 0,
        "neutral": 1
      }
    }
  },
  "buyer_reputation": {
    "tags": [
    ]
  },
  "status": {
    "site_status": "active"
  }
}


Com access_token (Recurso privado)

 
 https://api.mercadolibre.com/users/226384143?access_token=$ACCESS_TOKEN

{
  "id": 226384143,
  "nickname": "TETE9928972",
  "registration_date": "2016-08-25T11:36:00.000-04:00",
  "first_name": "Test",
  "last_name": "Test",
  "country_id": "AR",
  "email": "test_user_38730994@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/TETE9928972",
  "shipping_modes": [
    "custom",
    "not_specified"
  ],
  "seller_experience": "ADVANCED",
  "bill_data": {
    "accept_credit_note": null
  },
  "seller_reputation": {
    "level_id": null,
    "power_seller_status": null,
    "transactions": {
      "period": "historic",
      "total": 1,
      "completed": 1,
      "canceled": 0,
      "ratings": {
        "positive": 0,
        "negative": 0,
        "neutral": 1
      }
    }
  },
  "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": "simple_registration",
    "required_action": ""
  },
  "credit": {
    "consumed": 101.1,
    "credit_level_id": "MLA1"
  }
}

Conteúdos:

Autenticação

Autenticação é o ato ou processo para o estabelecimento ou confirmação de algo ou alguém como real.
A autenticação de uma pessoa consiste na verificação de sua identidade em função de um ou vários fatores, garantindo que os dados enviados sejam corretos.

Alguns métodos de autenticação são:

  • Biomédicos, digitais, retina do olho, etc.
  • Cartões inteligentes contendo informações dos certificados de um usuário.
  • Métodos clássicos baseados em senha.
  • Por exemplo, para acessar o Mercado Livre a autenticação é feita através do login (usuário e senha).

login

Autorização

Autorização é o processo pelo qual é permitido que alguém ou algo acesse recursos privados.
Dentro da autorização deverão ser definidos os recursos e operações que podem ser realizados, pois não é o mesmo outorgar permissões de somente leitura, leitura ou escrita.

Como conseguir a autorização? Através do Protocolo OAuth 2.0, um dos mais utilizados em plataformas abertas (Twitter, Facebook, etc.) e método seguro para trabalhar com recursos privados.

OAuth oferece:

  • Confidencialidade, o usuário não deverá revelar sua senha em momento nenhum.
  • Integridade, só aplicativos que tiverem a permissão poderão ver dados privados.
  • Disponibilidade, os dados sempre estarão disponíveis no momento em que forem necessários.

Dentro deste protocolo há 4 modos de funcionamento possíveis denominados Grant Types:

– The Authorization Code Grant Type (Server Side)
– The Implicit Grant Type (Client Side)
– The Password Credentials Grant Type
– The Client Credentials Grant Type

Embora cada um destes seja utilizado para diferentes finalidades, dependendo do serviço que esteja sendo construído, a seguir só explicaremos os dois primeiros, pois eles permitem trabalhar com nossos recursos e gerar ferramentas para todos os usuários do Mercado Livre.

Client-side

O fluxo de autorização Client side é o adequado para os aplicativos que executam código do lado do cliente, por exemplo, aplicativos desenvolvidos em linguagem javascript/ajax, Angular ou aplicativos mobile.
Para conhecer mais detalhes sobre este fluxo, recomendamos ver o tutorial “Autorização Client-Side”.

Server-side

O fluxo de autorização Server side é o mais adequado para os aplicativos que executam código do lado do servidor, por exemplo, aplicativos desenvolvidos em linguagem Java, Grails, Go, etc.
Notas: Esta opção será útil para aplicativos que executam cron jobs para atualizar estoque de produtos ou operar sem que um usuário esteja interagindo diretamente com o aplicativo.
Para conhecer mais detalhes sobre este fluxo, recomendamos ver o tutorial “Autorização Server-Side”.

Tenha seu access_token!

Introduza o ID do aplicativo criado:

*Favor, coloque um ID valido do aplicativo
User informationJSON Response

-

Uso dos nossos SDK

Mediante o uso dos nossos SDKs, o processo de autorização será mais simples, pois poupará a codificação de todo o protocolo OAuth de zero.
Nossa comunidade já está utilizando!
Oferecemos SDK para:

Se você descobrir uma melhoria ou tiver uma sugestão, pode compartilhá-la com a comunidade, gerando um Pull Request dentro do nosso repositório GitHub.

Considerações

Validade e expiração de tokens
Quando você obtém um access_token, este terá validade imediatamente e poderá ser utilizado para realizar solicitações para a API durante um período limitado de 6 horas.
Alguns eventos podem invalidar um access_token antes do tempo de expiração. Por exemplo: alteração de senha pelo usuário, atualização do App Secret por um aplicativo e, obviamente, a revogação de permissões do seu aplicativo pelo usuário.

Referências de código de erro

Error_codeMensagem de erroPossível solução
invalid_client

client_id ou client_secret inválido.

O client_id e/ou client_secret fornecido não é válido.Verifique as informações de seu aplicativo e os parâmetros client_id e client_secret.
invalid_grant

Para criar um token de acesso, o usuário deverá ter uma sessão ativa ou seu aplicativo deverá solicitar autorização para o escopo offline_access.

A concessão de autorização fornecida não é válida, expirou, foi revogada ou não corresponde à URL de redirecionamento usada na solicitação de autorização.Verifique se o parâmetro redirect_uri é igual ao configurado em seu aplicativo (Gerenciador de Aplicações); caso isso não resolva o problema, faça envie nova solicitação para obter um novo código.
invalid_grant

Erro na validação da concessão. Pode ser que o código de autorização ou o token de atualização tenha expirado ou já tenha sido usado.

Expirou ou já foi usado.Envie uma nova solicitação para obter um novo código ou refresh_token.
invalid_grant

client_id não corresponde ao original.

O ID do client não coincide.Não foi encontrado o parâmetro client_id; para obter seu client_id, consulte seu aplicativo (Gerenciador de Aplicações).
invalid_grant

redirect_url não corresponde à original.

URL de redirecionamento não corresponde à original.Parâmetro redirect_url diferente do configurado em seu aplicativo; para obter redirect_url, consulte o aplicativo (Gerenciador de Aplicações)
invalid_scope

Scope inválido.

O escopo solicitado não é válido, é desconhecido ou é mal formado.Os valores permitidos para o escopo do parâmetro são: “offline_access”, “write”, “read”.
invalid_request

Quantidade incorreta de parâmetros com valores duplicados.

A solicitação não inclui um parâmetro obrigatório, inclui um parâmetro ou valor de parâmetro não aceito ou está mal formada.Verifique se os parâmetros enviados são válidos e não são duplicados.
unsupported_grant_type

Tipo de concessão não aceito: ${0}.

O servidor de autorização não aceita o tipo de concessão.Os valores permitidos para grant_type são “authorization_code” ou “refresh_token”.
forbidden

A chamada não autoriza o acceso ao recurso.

A chamada não autoriza o accesoSe utiliza o token de outro usuário.


Artigos relacionados :
Server side.
Client side.


Próximo:
Consulta de usuários.

Qualifique entre 1 e 5

Receba notificações

Alguns eventos são produzidos apenas do lado do Mercado Livre e a única forma de conhecê-los é através de notificações.
Com as notificações você terá um feed em tempo real das mudanças produzidas nos diferentes recursos da nossa API.
Por exemplo, se você anunciou um item e mais tarde decidiu pausá-lo, se alguém formulou alguma pergunta, se compraram um item ou até se pagaram e/ou solicitaram o envio.
Uma maneira eficiente sem ter que consultar permanentemente nossa API!

Assuntos:

Inscreva-se para receber notificações

Se quiser começar a receber notificações, você deverá acessar seu gerenciador de aplicativos, onde você criou seu aplicativo pela primeira vez, editar os detalhes especificando quais são os topics que você receberá.
Aclaração: Caso você ainda não tenha criado seu aplicativo, acesse seção Criar a sua aplicação.

Topics

– URL de retorno das notificações: Configure a URL pública do domínio onde você quer receber notificações sobre os diversos tópicos. Por exemplo: “http://myshoes-app.com/callbacks”.

– Topics: Selecione dentre os diferentes tópicos para receber notificações.
Aclaração: Tenha em conta que os topics orders, created_orders e payments não são utilizados para imóveis, serviços e automóveis.

Topics Disponíveis

  • items – Você receberá notificações sobre qualquer mudança em um item que tiver publicado.
  • orders – Você receberá notificações sobre qualquer alteração realizada em alguma de suas vendas confirmadas.
  • created_orders – Você receberá notificações de suas vendas recentemente criadas quando entram pelo fluxo do Mercado Pago obrigatório.
    Você só vai obter dados do produto e quantidade de unidades, pois a compra ainda não foi confirmada. Não deve realizar qualquer ação até não passar para “paid”.
    Serve apenas para reserva de estoque, pois se o comprador finalmente pagar mas o item não tiver estoque, o pagamento será automaticamente devolvido e a venda cancelada.
  • Aclaração: Quando a ordem for paga, as notificações começarão a ser enviadas também a partir de “orders”, portanto, sugerimos escolher apenas um dos topics para evitar eventos duplicados.

  • questions – Você receberá notificações de perguntas e respontas feitas.
  • payments – Você receberá notificações quando um pagamento for criado em uma ordem ou o status dela mudar.
  • pictures – Você somente receberá notificações das imagens que, por causa de algum erro, não estiverem disponíveis para download.
  • Nota: Ao mesmo tempo, será enviado um email automático para o vendedor, reunindo as imagens com problemas.

Considerações

  • As mensagens serão enviadas e novas tentativas de envio serão feitas durante um intervalo de 12 horas. Depois desse período, se não forem aceitas pelo aplicativo, elas serão excluídas.
  • Enviaremos um POST a sua URL, portanto, seu aplicativo deverá confirmar o recebimento com um código de status HTTP 200, caso contrário, a mensagem será considerada não entregue e haverá uma nova tentativa de envio.
  • Seu aplicativo deverá enviar uma resposta em 20 segundos, caso contrário, o tempo limite será atingido a notificação será considerada como não entregue e haverá uma nova tentativa de envio.

Quais eventos disparam notificações?

items

  • Alterações em quaisquer atributos.
  • Alterações no status: a publicação deve ser verificada por um operador e o status é alterado para “under_review” ou é pausado, e o status muda para “pausado”.

orders

  • Redução de estoque: alguém compra um de seus produtos, e o estoque tem uma baixa. Um novo pedido é criado.
  • Pagamento: o comprador adiciona um pagamento ao pedido.
  • Envio: novas informações sobre o envio são associadas ao pedido ou o status do envio muda para: pendente, em processamento, ativo, entregue, não entregue.
  • Feedback: o comprador qualifica você como vendedor ou você envia feedback ao comprador. Um feed sobre o pedido é recebido.
  • Aclaração: orders é composto por blocos de outras apis, porém, nem todos os dados são exibidos por serem desnecessários. Esses blocos independentes podem sofrer mudanças, gerando eventos e posteriores notificações sobre a ordem, embora, às vezes, as mudanças relacionadas ao json anterior não sejam visualizadas.

creaters_orders

  • A notificação de creaters_orders chegará quando uma ordem que entrou pelo fluxo de Mercado Pago obrigatório for criada. Serve somente para reserva de estoque.
  • Outras notificações quando a ordem estiver “paid”, são as mesmas que as do topic “orders”. Caso você tenha selecionado os dois, chegarão notificações de ambos os topics.

questions

  • Você recebe uma nova pergunta.
  • Você responde a uma pergunta.
  • Você exclui uma pergunta que considera inadequada.

payments

  • Se gera um pagamento.
  • O estado do pagamento muda.

pictures

  • Quando alguma imagem não estiver disponível para download por causa de algum erro.

Acesso aos detalhes

Depois de receber uma notificação sobre um tópico, você deverá fazer uma solicitação GET ao recurso para acessar os detalhes e, depois, se tiver salvado o JSON anterior, deverá comparar os dois.

items

Notification response:

{
  "resource": "/items/MLB139876",
  "user_id": 1234,
  "topic": "items",
  "received": "2011-10-19T16:38:34.425Z",
  "sent" : "2011-10-19T16:40:34.425Z",
}

Com essas informações, você poderá realizar um GET para o recurso de items:

curl -X GET https://api.mercadolibre.com/items/{Item_id}?access_token=ACCESS_TOKEN


orders e created_orders

Notification response:

{
    "resource": "/orders/139876",
    "user_id": 1234,
    "topic": "orders",
    "received": "2011-10-19T16:38:34.425Z",
    "sent" : "2011-10-19T16:40:34.425Z",
}

Com essas informações, você poderá realizar um GET para o recurso de orders e created_orders:

curl -X GET https://api.mercadolibre.com/orders/{Order_id}?access_token=ACCESS_TOKEN


questions

Notification response:

{
  "resource": "/questions/139876",
  "user_id": 1234,
  "topic": "questions",
  "received": "2011-10-19T16:38:34.425Z",
  "sent" : "2011-10-19T16:40:34.425Z",
}

Com essas informações, você poderá realizar um GET para o recurso questions:

curl -X GET https://api.mercadolibre.com/questions/{Question_id}?access_token=ACCESS_TOKEN


payments

Notification response:

{
  "resource": "/collections/1780558484",
  "user_id": 149218964,
  "topic": "payments",
  "application_id": 2470,
  "attempts": 1,
  "sent": "2016 - 01 - 15 T18: 12: 31.313 Z ",
  "received": "2016 - 01 - 15 T18: 12: 31.299 Z "
}

Com essas informações, você poderá realizar um GET para o recurso collections:

curl -X GET https://api.mercadolibre.com/collections/{Payment_id}?access_token=ACCESS_TOKEN


pictures

Notification response:

{
  "messages": [
    {
      "_id": "123aaa456bbb789ccc",
      "application_id": "1234",
      "user_id": "123456789",
      "resource": "/pictures/12345-MLA1234567-20160729"/errors,
      "topic": "pictures",
      "sent": "2016-07-24T11:00:00.836Z",
      "received": "2016-07-24T11:00:00.836Z",
      "attempts": "2",
      "created_at": "2016-07-24T11:00:00.836Z"
    }
  ]
}

Com essas informações, você poderá realizar um GET para o recurso picture:

curl -X GET https://api.mercadolibre.com/pictures/{picture_id}/errors?access_token=ACCESS_TOKEN

Você terá que identificar por que a imagem não foi corretamente processada. Ver “Considerações e melhores práticas para trabalhar com imagéns”.

API do histórico dos feeds

Um registro de seu histórico de notificações é salvo, e você pode acessá-lo a qualquer momento chamando nosso recurso feeds.
Exemplo:

curl -X GET https://api.mercadolibre.com/myfeeds?app_id={App_id}

Resposta:

{
  "messages": [
  {
    "_id": "123aaa456bbb789ccc",
    "application_id": "1234",
    "user_id": "123456789",
    "resource": "/orders/12345678",
    "topic": "orders",
    "sent": "2014-10-24T11:00:00.836Z",
    "received": "2014-10-24T11:00:00.836Z",
    "attempts": "2",
    "http_code": "400",
    "created_at": "2014-10-24T11:00:00.836Z"
  }
}
}


Próximo:
Consultas avançadas.

Qualifique entre 1 e 5