Favoritos

O recurso Bookmarks é autoexplicativo. É um modo de manter os produtos de seu interesse associados a um usuário.
Você pode gerenciar os favoritos por meio do recurso Bookmarks API, adicionando ou eliminando referências, que são sincronizadas com aplicativos móveis.

Assuntos

Acesso a seus favoritos

Use a seguinte URL para recuperar seus favoritos:
Example:

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

Resposta:

[
  ....
  {
    "bookmarked_date": "2012-07-20T10:22:04.736-04:00",
    "item_id": "MLA428108770",
  },
  {
    "bookmarked_date": "2012-07-17T16:46:46.079-04:00",
    "item_id": "MLA428424006",
  },
  {
    "bookmarked_date": "2012-07-13T16:41:43.937-04:00",
    "item_id": "MLA428112474",
  },
  ....
]

Adição de um produto aos favoritos

Para adicionar um produto aos favoritos, faça o seguinte:

curl -X POST -H "Content-Type: application/json" -d
'{
 "item_id":"MLA5529"
 }'

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

Exclusão de um favorito

Os favoritos podem ser excluídos a qualquer momento, basta excluir a referência.

curl -X DELETE -H "Content-Type: application/json" -d

https://api.mercadolibre.com/users/me/bookmarks/MLA5529?access_token=$ACCESS_TOKEN

Resposta:

{
  "item_id":"MLA426609874",
  "bookmarked_date":"2012-08-21T10:43:32.978-04:00"
}



Próximo:
Saldo da conta.

Qualifique entre 1 e 5

Shipping Status e Substatus

Para obter uma descrição de todos os shipping status e seus substatus possíveis, você pode fazer uma chamada ao nosso recurso de shipment_statuses.

Exemplo:

curl -X GET https://api.mercadolibre.com/shipment_statuses

Resposta:

{
    "id": "to_be_agreed",
    "name": "To be agreed",
    "substatuses": [
    ]
  },
  {
    "id": "pending",
    "name": "Pending",
    "substatuses": [
      {
        "id": "cost_exceeded",
        "name": "Cost exceeded"
      }
    ]
  },
  {
    "id": "handling",
    "name": "Handling",
    "substatuses": [
      {
        "id": "regenerating",
        "name": "Regenerating"
      },
      {
        "id": "waiting_for_label_generation",
        "name": "Waiting for label generation"
      }
    ]
  },
  {
    "id": "ready_to_ship",
    "name": "Ready to ship",
    "substatuses": [
      {
        "id": "ready_to_print",
        "name": "Ready to print"
      },
      {
        "id": "invoice_pending",
        "name": "Invoice pending"
      },
      {
        "id": "printed",
        "name": "Printed"
      },
      {
        "id": "in_pickup_list",
        "name": "In pikcup list"
      },
      {
        "id": "ready_for_pkl_creation",
        "name": "Ready for pkl creation"
      },
      {
        "id": "ready_for_pickup",
        "name": "Ready for pickup"
      },
      {
        "id": "picked_up",
        "name": "Picked up"
      },
      {
        "id": "stale",
        "name": "Stale Ready To Ship"
      },
      {
        "id": "in_hub",
        "name": "In hub"
      },
      {
        "id": "measures_ready",
        "name": "Measures and weight ready"
      },
      {
        "id": "waiting_for_carrier_authorization",
        "name": "Waiting for carrier authorization"
      },
      {
        "id": "authorized_by_carrier",
        "name": "Authorized by carrier"
      },
      {
        "id": "in_plp",
        "name": "In PLP"
      }
    ]
  },
  {
    "id": "shipped",
    "name": "Shipped",
    "substatuses": [
      {
        "id": "delayed",
        "name": "Delayed"
      },
      {
        "id": "waiting_for_withdrawal",
        "name": "Waiting for withdrawal"
      },
      {
        "id": "contact_with_carrier_required",
        "name": "Contact with carrier required"
      },
      {
        "id": "receiver_absent",
        "name": "Receiver absent"
      },
      {
        "id": "reclaimed",
        "name": "Reclaimed"
      },
      {
        "id": "not_localized",
        "name": "Not localized"
      },
      {
        "id": "forwarded_to_third",
        "name": "Forwarded to third party"
      },
      {
        "id": "soon_deliver",
        "name": "Soon deliver"
      },
      {
        "id": "refused_delivery",
        "name": "Delivery refused"
      },
      {
        "id": "bad_address",
        "name": "Bad address"
      },
      {
        "id": "negative_feedback",
        "name": "Stale shipped with negative feedback by buyer"
      },
      {
        "id": "need_review",
        "name": "Need to review carrier status to understand what happened"
      },
      {
        "id": "stale",
        "name": "Stale shipped"
      }
    ]
  },
  {
    "id": "delivered",
    "name": "Delivered",
    "substatuses": [
      {
        "id": "damaged",
        "name": "damaged"
      },
      {
        "id": "fulfilled_feedback",
        "name": "Fulfilled by buyer feedback"
      },
      {
        "id": "no_action_taken",
        "name": "No action taken by buyer"
      },
      {
        "id": "double_refund",
        "name": "Double Refund"
      }
    ]
  },
  {
    "id": "not_delivered",
    "name": "Not delivered",
    "substatuses": [
      {
        "id": "returning_to_sender",
        "name": "Returning to sender"
      },
      {
        "id": "retained",
        "name": "Retained"
      },
      {
        "id": "stolen",
        "name": "Stolen"
      },
      {
        "id": "returned",
        "name": "Returned"
      },
      {
        "id": "receiver_absent",
        "name": "Receiver absent"
      },
      {
        "id": "confiscated",
        "name": "confiscated"
      },
      {
        "id": "to_review",
        "name": "Closed shipment"
      },
      {
        "id": "destroyed",
        "name": "Destroyed"
      },
      {
        "id": "waiting_for_withdrawal",
        "name": "Waiting for withdrawal"
      },
      {
        "id": "negative_feedback",
        "name": "Stale shipped forced to not delivered due to negative feedback by buyer"
      },
      {
        "id": "claimed_me",
        "name": "Stale shipped with claim that was forced to not delivered"
      },
      {
        "id": "not_localized",
        "name": "Not localized"
      },
      {
        "id": "double_refund",
        "name": "Double Refund"
      }
    ]
  },
  {
    "id": "not_verified",
    "name": "Not verified",
    "substatuses": [
    ]
  },
  {
    "id": "cancelled",
    "name": "Cancelled",
    "substatuses": [
    ]
  },
  {
    "id": "closed",
    "name": "Closed",
    "substatuses": [
    ]
  },
  {
    "id": "error",
    "name": "Error",
    "substatuses": [
    ]
  },
  {
    "id": "active",
    "name": "Active",
    "substatuses": [
    ]
  },
  {
    "id": "not_specified",
    "name": "Not specified",
    "substatuses": [
    ]
  },
  {
    "id": "stale_ready_to_ship",
    "name": "Stale ready to ship",
    "substatuses": [
    ]
  },
  {
    "id": "stale_shipped",
    "name": "Stale shipped",
    "substatuses": [
    ]
  }

Qualifique entre 1 e 5

Calcular o custo do frete e o handling time

Em nosso Marketplace, os vendedores terão uma calculadora de fretes na página de descrição de produtos. Através dela, os compradores saberão o custo do frete e o handling time.
Você pode utilizar nossos recursos para calculá-los com base nas informações disponíveis.

Assuntos:

Descrição de atributos

A seguir, uma rápida descrição de cada um dos recursos que você encontrará em seu recurso calculator.

destination
Detalhes do endereço do destinatário:
Atributos
zip_code
CEP de destino.
city
Informações da cidade de destino.
Atributos
id
ID da cidade de destino.
name
Nome da cidade de destino.
state
Informações sobre o estado de destino.
Atributos
id
ID do estado de destino.
name
Nome do estado de destino.
country
Informações sobre o país de destino.
Atributos
id
ID do país de destino.
name
Nome do país de destino.
extended_attributes
Informações adicionais do endereço de destino.
Atributos
address
Linha do endereço de destino.
owner_name
Titular do endereço de destino.
zip_code_type
Informações sobre o tipo de CEP de destino.
Atributos
type
ID do tipo de CEP de destino.
description
Nome do tipo de CEP de destino.
city_type
ID do tipo de cidade de destino.
city_name
Nome da cidade de destino.
version
Versão interna desses dados na API de CEPs.
options
Coleção de custos de envio para cada um dos métodos disponibilizados.
Atributos
id
ID da regra de frete aplicada.
name
Nome do modo de envio.
currency_id
ID da moeda utilizada para mostrar os custos de envio.
list_cost
Custo real do frete; sem a aplicação do frete grátis.
cost

Custo final do frete; pode ser aplicado o frete grátis.
tracks_shipments_status
Indica como pode ser feito o rastreamento desse modo.
Atributos
verified
Pode ser feito o rastreamento internamente.
not_verified
As informações do rastreamento deverão ser fornecidas pelo vendedor.
no
Não é possível realizar rastreamento.
display
ID do modo de envio para processamento inicial.
Atributos
always
Deve ser mostrado o modo de envio.
optional
O modo pode não ser mostrado porque existe outro mais rápido e acessível.
speed
Informações sobre a velocidade da entrega.
Atributos
shipping
Média de horas do envio.
handling
Média de horas para que o vendedor realize o despacho.

Cálculo conforme local, CEP e dimensões do produto

Exemplo:

 curl -X GET https://api.mercadolibre.com/sites/MLB/shipping_options?zip_code_from=01310909&zip_code_to=01310909&dimensions=16x16x16,1500

Resposta:

 {
  "destination": {
    "zip_code": "01310909",
    "city": {
      "id": "BR-SP-44",
      "name": "São Paulo"
    },
    "state": {
      "id": "BR-SP",
      "name": "São Paulo"
    },
    "country": {
      "id": "BR",
      "name": "Brasil"
    },
    "extended_attributes": {
      "address": "Avenida Paulista, 688",
      "owner_name": "Edifício Santa Filippa",
      "zip_code_type": {
        "type": "LO",
        "description": "Logradouro"
      },
      "city_type": "CI",
      "city_name": "São Paulo",
      "neighborhood": "Bela Vista",
      "status": "active"
    }
  },
  "options": [
    {
      "id": 27554373,
      "name": "Normal",
      "shipping_method_id": 100009,
      "currency_id": "BRL",
      "list_cost": 9.66,
      "cost": 9.66,
      "tracks_shipments_status": "not_verified",
      "display": "recommended",
      "speed": {
        "shipping": 96,
        "handling": 48
      },
      "estimated_delivery": {
        "date": "2016-02-26T00:00:00.000-02:00",
        "pay_before": null,
        "time_from": null,
        "time_to": null
      },
      "estimated_delivery_time": {
        "type": "known_frame",
        "date": "2016-02-24T00:00:00.000-02:00",
        "shipping": 48,
        "handling": 48,
        "unit": "hour",
        "offset": {
          "date": "2016-02-26T00:00:00.000-02:00",
          "shipping": 48
        },
        "time_frame": {
          "from": null,
          "to": null
        },
        "pay_before": null
      },
      "discount": {
        "rate": 0,
        "type": "none",
        "promoted_amount": 0
      }
    },
    {
      "id": 27551043,
      "name": "Expresso",
      "shipping_method_id": 182,
      "currency_id": "BRL",
      "list_cost": 9.83,
      "cost": 9.83,
      "tracks_shipments_status": "not_verified",
      "display": "always",
      "speed": {
        "shipping": 48,
        "handling": 48
      },
      "estimated_delivery": {
        "date": "2016-02-24T00:00:00.000-02:00",
        "pay_before": null,
        "time_from": null,
        "time_to": null
      },
      "estimated_delivery_time": {
        "type": "known_frame",
        "date": "2016-02-23T00:00:00.000-02:00",
        "shipping": 24,
        "handling": 48,
        "unit": "hour",
        "offset": {
          "date": "2016-02-24T00:00:00.000-02:00",
          "shipping": 24
        },
        "time_frame": {
          "from": null,
          "to": null
        },
        "pay_before": null
      },
      "discount": {
        "rate": 0,
        "type": "none",
        "promoted_amount": 0
      }
    }
  ]
}

Cálculo conforme usuário e CEP

Exemplo:

 curl -X GET https://api.mercadolibre.com/users/190990642/shipping_options?zip_code=01310909&dimensions=16x16x16,1500

Resposta:

{
  "destination": {
    "zip_code": "01310909",
    "city": {
      "id": "BR-SP-44",
      "name": "São Paulo"
    },
    "state": {
      "id": "BR-SP",
      "name": "São Paulo"
    },
    "country": {
      "id": "BR",
      "name": "Brasil"
    },
    "extended_attributes": {
      "address": "Avenida Paulista, 688",
      "owner_name": "Edifício Santa Filippa",
      "zip_code_type": {
        "type": "LO",
        "description": "Logradouro"
      },
      "city_type": "CI",
      "city_name": "São Paulo",
      "neighborhood": "Bela Vista",
      "status": "active"
    }
  },
  "options": [
    {
      "id": 27555383,
      "name": "Normal",
      "shipping_method_id": 100009,
      "currency_id": "BRL",
      "list_cost": 11.86,
      "cost": 11.86,
      "tracks_shipments_status": "not_verified",
      "display": "recommended",
      "speed": {
        "shipping": 96,
        "handling": 48
      },
      "estimated_delivery": {
        "date": "2016-03-01T00:00:00.000-02:00",
        "pay_before": null,
        "time_from": null,
        "time_to": null
      },
      "estimated_delivery_time": {
        "type": "known_frame",
        "date": "2016-02-26T00:00:00.000-02:00",
        "shipping": 48,
        "handling": 48,
        "unit": "hour",
        "offset": {
          "date": "2016-03-01T00:00:00.000-02:00",
          "shipping": 48
        },
        "time_frame": {
          "from": null,
          "to": null
        },
        "pay_before": null
      },
      "discount": {
        "rate": 0,
        "type": "none",
        "promoted_amount": 0
      }
    },
    {
      "id": 27843879,
      "name": "Expresso",
      "shipping_method_id": 182,
      "currency_id": "BRL",
      "list_cost": 16.48,
      "cost": 16.48,
      "tracks_shipments_status": "not_verified",
      "display": "always",
      "speed": {
        "shipping": 48,
        "handling": 48
      },
      "estimated_delivery": {
        "date": "2016-02-26T00:00:00.000-02:00",
        "pay_before": null,
        "time_from": null,
        "time_to": null
      },
      "estimated_delivery_time": {
        "type": "known_frame",
        "date": "2016-02-25T00:00:00.000-02:00",
        "shipping": 24,
        "handling": 48,
        "unit": "hour",
        "offset": {
          "date": "2016-02-26T00:00:00.000-02:00",
          "shipping": 24
        },
        "time_frame": {
          "from": null,
          "to": null
        },
        "pay_before": null
      },
      "discount": {
        "rate": 0,
        "type": "none",
        "promoted_amount": 0
      }
    }
  ]
}

Cálculo conforme cidade e dimensões no MCO (Colômbia)

Você pode calcular o custo do frete para um local determinado. O MCO é diferente de outros sites porque o cálculo é realizado conforme os parâmetros city_from, city_to e as dimensões. Como você pode observar no exemplo abaixo, esse recurso permite multiget. Você deve vincular os códigos de cidade isoladamente:

Exemplo:

 curl -X GET https://api.mercadolibre.com/sites/MCO/shipping_options?city_from=Q08tRENCb2dvdA&city_to=TUNPQ0NBUjcwNTYz,TUNPQ01FRGRjNjc4&dimensions=10x10x10,1000

Resposta:

 {
  "TUNPQ01FRGRjNjc4": {
    "destination": {
      "zip_code": null,
      "city": {
        "id": "TUNPQ01FRGRjNjc4",
        "name": "Medellín"
      },
      "state": {
        "id": "CO-ANT",
        "name": "Antioquia"
      },
      "country": {
        "id": "CO",
        "name": "Colombia"
      }
    },
    "options": [
      {
        "id": 523836053,
        "name": "Servientrega Normal",
        "shipping_method_id": 501745,
        "currency_id": "COP",
        "list_cost": 7500,
        "cost": 7500,
        "tracks_shipments_status": "not_verified",
        "display": "recommended",
        "speed": {
          "shipping": 24,
          "handling": 72
        },
        "estimated_delivery": {
          "date": "2016-02-26T00:00:00.000-05:00",
          "pay_before": null,
          "time_from": null,
          "time_to": null
        },
        "estimated_delivery_time": {
          "type": "known",
          "date": "2016-02-26T00:00:00.000-05:00",
          "shipping": 24,
          "handling": 72,
          "unit": "hour",
          "offset": {
            "date": null,
            "shipping": null
          },
          "time_frame": {
            "from": null,
            "to": null
          },
          "pay_before": null
        },
        "discount": {
          "rate": 0,
          "type": "none",
          "promoted_amount": 0
        }
      }
    ]
  },
  "TUNPQ0NBUjcwNTYz": {
    "destination": {
      "zip_code": null,
      "city": {
        "id": "TUNPQ0NBUjcwNTYz",
        "name": "Cartagena De Indias"
      },
      "state": {
        "id": "CO-BOL",
        "name": "Bolivar"
      },
      "country": {
        "id": "CO",
        "name": "Colombia"
      }
    },
    "options": [
      {
        "id": 523835977,
        "name": "Servientrega Normal",
        "shipping_method_id": 501745,
        "currency_id": "COP",
        "list_cost": 7500,
        "cost": 7500,
        "tracks_shipments_status": "not_verified",
        "display": "recommended",
        "speed": {
          "shipping": 48,
          "handling": 72
        },
        "estimated_delivery": {
          "date": "2016-02-29T00:00:00.000-05:00",
          "pay_before": null,
          "time_from": null,
          "time_to": null
        },
        "estimated_delivery_time": {
          "type": "known",
          "date": "2016-02-29T00:00:00.000-05:00",
          "shipping": 48,
          "handling": 72,
          "unit": "hour",
          "offset": {
            "date": null,
            "shipping": null
          },
          "time_frame": {
            "from": null,
            "to": null
          },
          "pay_before": null
        },
        "discount": {
          "rate": 0,
          "type": "none",
          "promoted_amount": 0
        }
      }
    ]
  }
}

Cálculo conforme usuário, cidade e dimensões no MCO (Colômbia)

Se quiser, você pode calcular o custo do frete para um usuário específico e uma cidade e dimensões determinadas. Como você pode observar no exemplo abaixo, esse recurso permite multiget. Você deve vincular os códigos da cidade isoladamente.

Exemplo:

 GET https://api.mercadolibre.com/users/454271894/shipping_options?city_to=Q08tRENCb2dvdA,TUNPQ01FRGRjNjc4&dimensions=15x15x15,650 

Resposta:

 {
    "destination": {
        "zip_code": null,
        "city": {
            "id": "Q08tRENCb2dvdA",
            "name": "Bogotá"
        },
        "state": {
            "id": "CO-DC",
            "name": "Bogota D.C."
        },
        "country": {
            "id": "CO",
            "name": "Colombia"
        }
    },
    "options": [
        {
            "id": 11110,
            "name": "Servientrega Estandar",
            "shipping_method_id": 501745,
            "currency_id": "COP",
            "list_cost": 7.5,
            "cost": 7.5,
            "tracks_shipments_status": "verified",
            "display": "recommended",
            "speed": {
                "shipping": 48,
                "handling": null
            },
            "estimated_delivery": {
                "date": null,
                "pay_before": null,
                "time_from": null,
                "time_to": null
            },
            "discount": {
                "rate": 0
            }
        }
    ],
    "settings": {
        "allow_add_cost": null
    }
}

Cálculo conforme produto e cidade no MCO (Colômbia)

Cálculo do custo do frete para um produto enviando somente os parâmetros Item_id e City_to.

Exemplo:

 GET https://api.mercadolibre.com/items/MCO415774919/shipping_options?city_to=Q08tRENCb2dvdA 

Resposta:

 {
  "destination": {
    "zip_code": null,
    "city": {
      "id": "Q08tRENCb2dvdA",
      "name": "Bogotá"
    },
    "state": {
      "id": "CO-DC",
      "name": "Bogota D.C."
    },
    "country": {
      "id": "CO",
      "name": "Colombia"
    }
  },
  "options": [
    {
      "id": 523835933,
      "name": "Servientrega Normal",
      "shipping_method_id": 501745,
      "currency_id": "COP",
      "list_cost": 5000,
      "cost": 0,
      "tracks_shipments_status": "verified",
      "display": "recommended",
      "speed": {
        "shipping": 24,
        "handling": 72
      },
      "estimated_delivery": {
        "date": "2015-06-22T00:00:00.000-05:00",
        "pay_before": null,
        "time_from": null,
        "time_to": null
      },
      "discount": {
        "rate": 0,
        "type": "none",
        "promoted_amount": 0
      }
    }
  ]
}

Qualifique entre 1 e 5

Calculadora de preços de publicações

A API Listing Prices é um recurso somente leitura que oferece muitas maneiras de saber quais são as taxas para publicar um produto no Mercado Livre, para que o vendedor saiba exatamente qual será seu custo ao publicar em um determinado listing_type de um site, categoria, moeda e quantidade determinados.

Assuntos

Descrição de atributos

AtributoDescrição
listing_type_idID do tipo de publicação
listing_type_nameNome do tipo de publicação
listing_exposureNível de exposição da publicação
requires_pictureMostra se o tipo de publicação exige pelo menos uma imagem.
currency_idID da moeda das taxas
listing_fee_amountMontante de taxas da publicação
selling_fee_amountMontante de taxas da venda

Filtragem por preço

Recupera os diferentes tipos de publicações e cada uma das taxas associadas em moeda local, quando o preço do produto é 5.000.

Exemplo:

 curl -X GET https://api.mercadolibre.com/sites/:site_id/listing_prices?price=5000

Resposta:

 {
    "listing_type_id": "gold_pro",
    "listing_type_name": "Oro Premium Full",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 1150,
    "free_relist": false,
    "stop_time": "2016-04-22T10:31:44.135-04:00"
  },
  {
    "listing_type_id": "gold_premium",
    "listing_type_name": "Oro Premium",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 250,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:31:44.119-04:00"
  },
  {
    "listing_type_id": "gold_special",
    "listing_type_name": "Oro Profesional",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 525,
    "free_relist": false,
    "stop_time": "2016-04-22T10:31:44.121-04:00"
  },
  {
    "listing_type_id": "gold",
    "listing_type_name": "Oro",
    "listing_exposure": "high",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 150,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:31:44.133-04:00"
  },
  {
    "listing_type_id": "silver",
    "listing_type_name": "Plata",
    "listing_exposure": "mid",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 50,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:31:44.127-04:00"
  },
  {
    "listing_type_id": "bronze",
    "listing_type_name": "Bronce",
    "listing_exposure": "low",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 550,
    "free_relist": false,
    "stop_time": "2016-04-22T10:31:44.130-04:00"
  },
  {
    "listing_type_id": "free",
    "listing_type_name": "Gratuita",
    "listing_exposure": "lowest",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:31:44.116-04:00"
  }

Por preço e listing_type

Recupera os diferentes tipos de publicações associadas ao tipo de publicação Gold em moeda local quando o preço do produto é 5.000.

Exemplo:

 curl -X GET https://api.mercadolibre.com/sites/:site_id/listing_prices?price=5000&listing_type_id=gold

Resposta:

 {
    "listing_type_id": "gold",
    "listing_type_name": "Oro",
    "listing_exposure": "high",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 150,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:32:39.264-04:00"
  }

Filtrar por tipo de publicação e quantidade

Recupera os diferentes tipos de publicações e cada taxa associada em moeda local quando o preço do produto é 5.000 e a quantidade é 5.

Exemplo:

 curl -X GET https://api.mercadolibre.com/sites/:site_id/listing_prices?price=5000&quantity=5

Resposta:

 {
    "listing_type_id": "gold_pro",
    "listing_type_name": "Oro Premium Full",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 1150,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:22.631-04:00"
  },
  {
    "listing_type_id": "gold_premium",
    "listing_type_name": "Oro Premium",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 800,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:22.614-04:00"
  },
  {
    "listing_type_id": "gold_special",
    "listing_type_name": "Oro Profesional",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 525,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:22.617-04:00"
  },
  {
    "listing_type_id": "gold",
    "listing_type_name": "Oro",
    "listing_exposure": "high",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 480,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:22.628-04:00"
  },
  {
    "listing_type_id": "silver",
    "listing_type_name": "Plata",
    "listing_exposure": "mid",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 160,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:22.622-04:00"
  },
  {
    "listing_type_id": "bronze",
    "listing_type_name": "Bronce",
    "listing_exposure": "low",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 550,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:22.624-04:00"
  },
  {
    "listing_type_id": "free",
    "listing_type_name": "Gratuita",
    "listing_exposure": "lowest",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:22.611-04:00"
  }

Filtrar por preço e categoria

Recupera os diferentes tipos de publicações e cada uma das taxas associadas em moeda local, quando o preço do produto é 5.000 e a categoria é MLA1744.

Exemplo:

 curl -X GET https://api.mercadolibre.com/sites/:site_id/listing_prices?price=5000&category_id=MLA1744

Resposta:

 {
    "listing_type_id": "gold_premium",
    "listing_type_name": "Oro Premium",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 357,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:58.127-04:00"
  },
  {
    "listing_type_id": "gold",
    "listing_type_name": "Oro",
    "listing_exposure": "high",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 267,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:58.135-04:00"
  },
  {
    "listing_type_id": "silver",
    "listing_type_name": "Plata",
    "listing_exposure": "mid",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 147,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:58.130-04:00"
  },
  {
    "listing_type_id": "free",
    "listing_type_name": "Gratuita",
    "listing_exposure": "lowest",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-03-23T10:33:58.132-04:00"
  }

Por preço e moeda

Recupera os diferentes tipos de publicações e cada uma das taxas associadas em moeda local, quando o preço do produto é US$ 5.000.

Exemplo:

 curl -X GET https://api.mercadolibre.com/sites/:site_id/listing_prices?price=5000¤cy_id=USD

Resposta:

 {
    "listing_type_id": "gold_pro",
    "listing_type_name": "Oro Premium Full",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 1150,
    "free_relist": false,
    "stop_time": "2016-04-22T10:34:27.793-04:00"
  },
  {
    "listing_type_id": "gold_premium",
    "listing_type_name": "Oro Premium",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 250,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:34:27.779-04:00"
  },
  {
    "listing_type_id": "gold_special",
    "listing_type_name": "Oro Profesional",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 525,
    "free_relist": false,
    "stop_time": "2016-04-22T10:34:27.782-04:00"
  },
  {
    "listing_type_id": "gold",
    "listing_type_name": "Oro",
    "listing_exposure": "high",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 150,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:34:27.791-04:00"
  },
  {
    "listing_type_id": "silver",
    "listing_type_name": "Plata",
    "listing_exposure": "mid",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 50,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:34:27.786-04:00"
  },
  {
    "listing_type_id": "bronze",
    "listing_type_name": "Bronce",
    "listing_exposure": "low",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 550,
    "free_relist": false,
    "stop_time": "2016-04-22T10:34:27.788-04:00"
  },
  {
    "listing_type_id": "free",
    "listing_type_name": "Gratuita",
    "listing_exposure": "lowest",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:34:27.776-04:00"
  }

Filtrar por tipo de publicação e categoria

Recupera a comissão associada ao tipo de publicação Gold quando o ID da categoria é MLA1743.

Exemplo:

 curl -X GET https://api.mercadolibre.com/sites/:site_id/listing_prices/gold?category_id=MLA1743

Resposta:

 {
  "listing_type_id": "gold",
  "listing_type_name": "Oro",
  "listing_exposure": "high",
  "requires_picture": true,
  "currency_id": "ARS",
  "listing_fee_amount": 267,
  "sale_fee_amount": 0,
  "free_relist": false,
  "stop_time": "2016-04-22T10:35:02.225-04:00"
}

Por categoria

Recupera os diferentes tipos de publicações e cada uma das taxas associadas em moeda local quando a categoria é MLA1743.

Exemplo:

 curl -X GET https://api.mercadolibre.com/sites/:site_id/listing_prices?category_id=MLA1743

Resposta:

 {
    "listing_type_id": "gold_premium",
    "listing_type_name": "Oro Premium",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 357,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:35:31.996-04:00"
  },
  {
    "listing_type_id": "gold",
    "listing_type_name": "Oro",
    "listing_exposure": "high",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 267,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:35:32.006-04:00"
  },
  {
    "listing_type_id": "silver",
    "listing_type_name": "Plata",
    "listing_exposure": "mid",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 147,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:35:31.999-04:00"
  },
  {
    "listing_type_id": "free",
    "listing_type_name": "Gratuita",
    "listing_exposure": "lowest",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-03-23T10:35:32.003-04:00"
  }



Próximo:
Descrição de produtos.

Qualifique entre 1 e 5

API de sugestão de categorias

O recurso de sugestão de categorias foi criado para ajudar vendedores e desenvolvedores a sugerir em que categoria um determinado produto deve ser publicado. Atualmente, esse recurso é disponibilizado na Argentina, no Brasil, na Colômbia, no Chile e no México.

Parâmetros

ParâmetroDescrição
titleTítulo do produto a ser sugerido. Deve ser um título completo no idioma do site. Esse parâmetro é obrigatório.
category_fromEsse parâmetro aceita uma categoria de nível 1 e é utilizado para limitar a sugestão à subárvore que abrange da category_from como raiz. Esse parâmetro é opcional.
priceO preço do produto a ser sugerido. O objetivo desse parâmetro é apresentar mais informações para melhorar a sugestão. Esse parâmetro é opcional.
seller_idID do vendedor do produto a ser sugerido. O objetivo desse parâmetro é apresentar mais informações para melhorar a sugestão. Esse parâmetro é opcional.

Sugestão por GET

É possível usar o método GET para realizar a sugestão de um produto por vez.

 `curl https://api.mercadolibre.com/sites/MLB/category_predictor/predict?title=Ipod%20Touch%20Apple%2016gb%205%20Gera%C3%A7%C3%A3o`

Sugestão por POST

É possível usar o método POST para realizar a sugestão de múltiplos (até 1.000) produtos por vez. Recomenda-se a utilização desse método quando for preciso sugerir múltiplos produtos.

 `curl -X POST -H "Content-Type: application/json" -d '[{"title":"Ipod Touch Apple 16gb 5 Geração", "category_from":"MLB1743"}]' "https://api.mercadolibre.com/sites/MLB/category_predictor/predict"`

Campos de resposta

ParâmetroDescrição
idId da categoria sugerida para o produto.
nameNome da categoria sugerida.
prediction_probabilityConfiabilidade da sugestão. Esse valor oscila entre [0, 1]: os valores mais próximos de zero indicam pouca confiabilidade, enquanto os mais próximos de 1, indicam alta confiabilidade.
path_from_rootLista contendo as categorias que vão da raiz até a folha (categoria sugerida). Cada categoria é representada pelos atributos ID e NAME.
variationsEsse campo só é exibido quando a categoria sugerida aceita alterações.
shipping_modesTipos de envio aceitos pela categoria sugerida.



Próximo:
Dump de categorias.

Qualifique entre 1 e 5

Endereços do usuário

O documento abaixo tem como objetivo apresentar a Api Address, com um detalhamento dos campos obtidos na resposta correspondente à consulta, junto com as possíveis respostas para eles.

Assuntos:

 

Obter endereços do usuário

Para fazer uma chamada a essa API, você precisará de um token de acesso.
Exemplo:

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

Resposta:

{
  "id": 145834937,
  "user_id": "160252486",
  "contact": null,
  "phone": null,
  "address_line": "Guatemala 5100",
  "floor": null,
  "apartment": null,
  "street_number": "5100",
  "street_name": "Guatemala",
  "zip_code": "1000",
  "city": -{
      "id": "TUxBQlBBTDI1MTVa",
      "name": "Palermo",
  },
  "state": -{
      "id": "AR-C",
      "name": "Capital Federal",
      
  },
  "country": -{
      "id": "AR",
      "name": "Argentina",
  },
  "neighborhood": -{
      "id": null,
      "name": null,
  },
  "municipality": -{
      "id": null,
      "name": null,
  },
  "search_location": -{
      "state": -{
          "id": "TUxBUENBUGw3M2E1",
          "name": "Capital Federal",
      },
      "city": -{
          "id": "TUxBQ0NBUGZlZG1sYQ",
          "name": "Capital Federal",
      },
      "neighborhood": -{
          "id": "TUxBQlBBTDI1MTVa",
          "name": "Palermo",
      },
  },
  "types": -[
        "default_selling_address",
      "shipping",
  ],
  "comment": "",
  "geolocation_type": "RANGE_INTERPOLATED",
  "latitude": -34.5834729,
  "longitude": -58.4281022,
  "status": "active",
  "date_created": "2014-06-05T12:26:54.000-04:00",
  "normalized": true,
  "open_hours": -{
      "on_holidays": -{
          "hours": [
          ],
          "status": "closed",
      },
  },
}

Especificação dos campos na resposta

Error Codes Reference

CampoSub-CampoDescrição
idID do endereço solicitado
user_idID do usuário
contactNome do proprietário das informações (usuário)
phoneTelefone do usuário
address_lineEndereço completo do usuário (rua e, número)
floorAndar do edifício, caso seja um apartamento.
apartmentIdentificação do apartamento (número ou letra)
street_numberNúmero da rua do endereço citado em “address_line”
street_nameNome da rua do endereço citado em “address_line”
zip_codeCEP
cityCidade na qual se encontra o endereço
idIdentificador exclusivo da cidade (API principal do local)
nameNome da cidade
stateEstado/Província em que se encontra a cidade.
idIdentificador exclusivo do estado/província (API principal do local)
nameNome do estado/província
countryPaís em que se encontra o endereço
idIdentificador exclusivo do país (API principal do local)
nameNome do país
neighborhoodBairro associado ao endereço
idIdentificador único do bairro
nameNome do bairro
municipalityMunicípio associado ao endereço
idIdentificador exclusivo do município
nameNome do município
search_locationInformações do endereço que será usado nas listagens de busca.
stateEstado/Província em que se encontra a cidade, no classificado. O id é associado à API de locais do classificado.
cityCidade na qual se encontra o endereço, segundo o classificado. O id é associado à API de locais do classificado.
neighbourhoodBairro onde se encontra o endereço, segundo o classificado. O id é associado à API de locais do classificado.
typesEspecifique o tipo do domicílio. Valores possíveis:

  • default_selling_address: endereço da venda
  • default_buying_address: endereço da compra
  • envio: endereço de onde serão feitos os envios
  • cobrança: endereço de cobrança do Mercado Livre.

Tipos pode ter um, nenhum ou vários dos atributos anteriores.

commentComentários sobre as informações do endereço.
geolocation_typeIntervalo aproximado do endereço em questão. Conformeos parâmetros de latitude e longitude outorgados pelo Google Maps.
latitudeLatitude outorgada pelo Google Maps.
longitudeLongitude outorgada pelo Google Maps.
statusEstado do endereço. Valores possíveis: active ou inactive.
date_createdData e hora na qual teve entrada.
normalizedIndica se os dados armazenados estão corretos. Caso não estejam corretos, será false. Valores possíveis: true, false.
open_hoursHorário de atendimento, caso o endereço pertença a uma loja.
on_holidaysHorário de atendimento especial durante as férias. Tem o subatributo hours.



Próximo:
Favoritos.

Qualifique entre 1 e 5

Tendências

A API Tendências é um repositório das palavras-chave mais populares do Mercado Livre.
Cada site tem um frontend onde você pode consultar as principais buscas por país e por categoria.
Por exemplo, a URL para a Argentina é tendencias.mercadolibre.com.ar.
Você pode acessar os sites hispânicos restantes apenas substituindo o domínio geográfico.
A URL para o Brasil é tendencias.mercadolivre.com.br.

Assuntos

Descrição de recursos

keywordpalavra pesquisada pelos usuários.
urllink para os resultados de busca.

Principais tendências por país

Como esta API admite somente métodos GET e recupera informações públicas, você não precisará de um $ACCESS_TOKEN. Digite {site_id} antes dos parâmetros /trends/search para buscar palavras-chave populares em um determinado país.

 curl -X GET https://api.mercadolibre.com/sites/{site_id}/trends/search

Principais tendências por país e por categoria

Adicione {category_id} para buscar palavras-chave populares em uma determinada categoria. Lembre-se de que as categorias pertencem aos sites.

 curl -X GET https://api.mercadolibre.com/sites/{site_id}/trends/search?category={category_id}

Limitação dos resultados

Para obter uma determinada quantidade de resultados, você deverá especificar {limit} a quantidade de resultados que quiser obter. O valor máximo é 100.

 curl -X GET https://api.mercadolibre.com/sites/{site_id}/trends/search?category={category_id}&limit={limit}

Conteúdo adulto

O conteúdo para adultos se encontra oculto por padrão. Caso você também queira obter as palavras-chave para adultos, envie parameteradult_content=yes.

 curl -X GET https://api.mercadolibre.com/sites/{site_id}/trends/search?category={category_id}&limit={limit}&adult_content=yes

Qualifique entre 1 e 5

Crie e administre seu projeto

Para aprimorar sua experiência de integração com o Mercado Livre, lançamos o recurso Projects API.

Ao criar um novo projeto nesse recurso, você poderá vinculá-lo a seus aplicativos, desde que a autoria do aplicativo não seja do titular do projeto. Isso permite verificar e saber mais sobre sua integração.

Um novo painel será habilitado no qual você poderá verificar o desempenho dos diversos aplicativos de seu projeto.

Todo desenvolvedor certificado deverá, obrigatoriamente, criar um novo projeto e o link para seus aplicativos.

Assuntos

O que devo fazer?

É simples. Em primeiro lugar, você cria um novo projeto e, posteriormente, todos os seus aplicativos serão vinculados a ele.
É por isso que você só deve criar um projeto como integrador, colocando os aplicativos nesse projeto.
Por exemplo, você deve fazer conforme segue:
Um projeto chamado MyCompanyHubIntegration [integração do hub de minha empresa] contendo todos as aplicativos ligados a ele.
Outro projeto denominado MyCompanyCustomerName [Nome de cliente de minha empresa], e assim por diante.

Criação de um projeto

 POST: https://api.mercadolibre.com/projects?access_token=YOUR_ACCESS_TOKEN
 JSON: {'name': 'Project Name', 'site_id': 'MLA'}

Expected response: 201

Adição de um aplicativo ao projeto

 POST: https://api.mercadolibre.com/projects/PROJECT_ID/applications?access_token=ACCESS_TOKEN_APP_OWNER
 JSON: {'application_id': APPLICATION_ID}

Expected response: 201

Acesso a todos os aplicativos de seu projeto

 GET: https://api.mercadolibre.com/projects/PROJECT_ID?access_token=ACCESS_TOKEN_PROJECT_OWNER

Exclusão de um aplicativo do projeto

 DELETE: https://api.mercadolibre.com/projects/PROJECT_ID/applications?access_token=ACCESS_TOKEN_APP_OWNER
 JSON: {'application_id': APPLICATION_ID}

Expected response: 200

Alteração do nome de um projeto

 PUT: https://api.mercadolibre.com/projects/PROJECT_ID?access_token=YOUR_ACCESS_TOKEN 
 JSON: {'name': 'changed name'}

Exclusão de um projeto

 DELETE: https://api.mercadolibre.com/projects/PROJECT_ID?access_token=YOUR_ACCESS_TOKEN

Qualifique entre 1 e 5

Rastreamento da reputação do usuário

Todos os usuários do Mercado Livre têm um nível de reputação e pontos de reputação que são calculados com base na quantidade de transações que realizaram com outros usuários do Mercado Livre, o resultado de cada uma delas e o feedback dos outros usuários. Não existe nenhum recurso de reputação pública com o qual você possa trabalhar para visualizar a reputação de um usuário, mas, como essas informações estão armazenadas na API do usuário, elas poderão ser verificadas por seu sistema periodicamente para serem salvas em seu banco de dados com o objetivo de fazer seu rastreamento durante certo período.

Faça uma chamada à API de usuários da seguinte forma:

 curl -X GET https://api.mercadolibre.com/users/{User_id}?attributes=seller_reputation

Resposta:

 {
  "seller_reputation": {
    "level_id": "5_green",
    "power_seller_status": "platinum",
    "transactions": {
      "period": "historic",
      "total": 2361,
      "completed": 1602,
      "canceled": 759,
      "ratings": {
        "positive": 0.99,
        "negative": 0,
        "neutral": 0.01
      }
    }
  }
}

Pronto. Agora você já tem um detalhamento da reputação do usuário em uma data determinada. Comece a armazená-la em seu sistema para ter um registro da evolução da reputação do usuário.

Qualifique entre 1 e 5

Busca de produtos por vendedor

Utilizando o nosso recurso público /sites/{site_id}/search? você pode obter os resultados de itens ativos diretamente das listas do Mercado Livre.

Utilizando o nosso recurso privado /users/{cust_id}/items/search?access_token= você pode obter uma lista dos itens postados por determinado user a partir de sua conta.

Conteúdos:

Obtenha itens das Listas por Vendedor

Esta pesquisa atende às regras das listas do site. Os resultados sempre serão itens ativos.
Notas:

  • Obtenha diretamente a URL da lista do Mercado Livre, substituindo /search? por /searchUrl?
  • As pesquisas com offset acima de 50.000 são limitadas.

Por apelido

Se você não conhece o seller_id de um usuário, mas sabe o apelido dele, pode tentar fazer a seguinte busca:

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

Por seller_id

Se você já conhece o seller_id, faça o seguinte:

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

Nota: Embora com a API sites/(site_id) você possa visualizar a descrição dos itens, esta não retorna a totalidade dos anúncios de um seller.

Se você quiser ver a lista completa sem a descrição, deverá fazer chamada:

https://api.mercadolibre.com/users/{seller_id}/items/search?access_token=$ACCESS_TOKEN

Por seller_id de vendedor em uma categoria específica

Lembre-se de que as buscas anteriores não recuperarão as publicações classificadas do vendedor, só seus produtos. Você pode usar o exemplo a seguir para buscar dentro de uma categoria determinada. Essa chamada aceita categorias classificadas para também consultar tais publicações.

curl https://api.mercadolibre.com/sites/MLB/search?seller_id=36060987&category=MLB1743

Agora que você já conhece o ID de cada produto de um vendedor, poderá fazer uma chamada ao recurso dos produtos para saber mais sobre eles.
Para melhorar a chamada que está fazendo, recomendamos utilizar multiget e os recursos de seleção para acessar até 50 produtos com uma só chamada e somente nos campos de seu interesse.

Chamada:

https://api.mercadolibre.com/items?ids={Item_id1},{Item_id2}&attributes={attribute1,attribute2,attribute3}

Exemplo:

https://api.mercadolibre.com/items?ids=MLA599260060,MLA594239600&attributes=id,title,seller_id,price,available_quantity,status

Resposta:

{
	"available_quantity": 24,
	"id": "MLA594239600",
	"price": 1999,
	"seller_id": 143125485,
	"status": "active",
	"title": "Celular Libre Samsung Galaxy Ace 4 Neo Blanco"
  },
  {
	"available_quantity": 5,
	"id": "MLA599260060",
	"price": 7999,
	"seller_id": 167520920,
	"status": "active",
	"title": "Aire Acondicionado Split Rca Frio Calor 3400w"
  }

Filtre o Organize os resultados de pesquisa nas listas

Dentro de /sites/{site_id}/search? estão os campos “available_sorts” e “available_filters”.

Como filtrar?
Por exemplo, para filtrar itens com frete grátis, você encontrará entre os “available_filters” disponíveis o ID “shipping” e dentro dele o value com ID “free”.

https://api.mercadolibre.com/sites/MLA/search?seller_id={cust_id}&shipping=free


Como realizar uma ordem?
Neste caso, você deve adicionar “sort” com o ID disponível da ordem que quiser aplicar, por exemplo: “price_asc”

https://api.mercadolibre.com/sites/MLA/search?seller_id={cust_id}&sort=price_asc

Nota: Por default, a pesquisa nas listas se apresenta com uma ordem de relevância predeterminada.

Obtenha itens da conta de um vendedor

Esta pesquisa é diretamente realizada na conta do vendedor, portanto, o recurso é privado e não requer access_token.

Nota: Lembre que, utilizando esta chamada, você vai obter uma lista de itens. Para obter mais informações sobre cada um deles, sugerimos utilizar um multiget, como foi anteriormente explicado.

Por seller_id

Se você já conhecer o seller_id, só deve fazer o seguinte:

curl https://api.mercadolibre.com/users/{seller_id}/items/search?access_token=$ACCESS_TOKEN

Por SKU

Se o item contém um SKU no campo “seller_custom_field”, você pode pesquisar da seguinte forma:

curl https://api.mercadolibre.com/users/{Cust_id}/items/search?sku={seller_custom_field}&access_token=$ACCESS_TOKEN

Por status

curl https://api.mercadolibre.com/users/{Cust_id}/items/search?status=active&access_token=$ACCESS_TOKEN

Filtre o Organize os resultados dos itens do vendedor

Dentro de /users/{cust_id}/items/search? estão os campos “available_orders” e “available_filters”

Como realizar uma ordem?
Neste caso, você deve adicionar “orders” com o ID disponível da ordem que quiser aplicar, por exemplo: “start_time_desc”

https://api.mercadolibre.com/users/226384143/items/search?orders=start_time_desc&access_token=$ACCESS_TOKEN

Nota: Por default, uma ordem orden stop_time_asc já vem aplicada.

Como filtrar?
Por exemplo, para filtrar itens com listing_type “gold_pro”, você encontrará entre os ”available_filters” disponíveis o ID “listing_type_id” e dentro dele o value com ID “gold_pro”.

https://api.mercadolibre.com/users/{Cust_id}/items/search?isting_type_id=gold_pro&access_token=$ACCESS_TOKEN


Mais exemplos de pesquisas em: Itens e pesquisas.

Qualifique entre 1 e 5

Trabalho com imagens

Ao publicar um produto, as imagens são opcionais, mas certamente elas fazem uma grande diferença em relação à qualidade, e aumentarão suas chances de venda atraindo mais visitantes para seus produtos. Ao publicar um produto novo, você poderá adicionar imagens. Este tutorial mostra como fazer upload das imagens de nossos servidores para adicioná-las a seus produtos.

Assuntos

Considerações e práticas recomendadas

As imagens RGB são muito mais recomendáveis do que as CMYK.
Há um número máximo de imagens por produto dependendo das categorias.
Você pode fazer upload de até 10 MB nos seguintes formatos:

  • JPG
  • JPEG
  • PNG
  • GIF não animadas

Zoom
Caso você tenha imagens com uma largura maior que 800 pixeis, um widget de zoom é ativado para que, quando os compradores passarem o mouse sobre a imagem, eles possam visualizá-la em primeiro plano. Isso é altamente recomendado para roupas e imóveis.

Como fazer upload de uma imagem

Agora é a hora de fazer upload de seu primeiro arquivo de imagem para que ele seja salvo em nossos servidores. É muito fácil. Basta colocar o caminho exato onde a imagem foi salva:

curl -F file=@/home/user/picture.jpg

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

Como resposta, você receberá um JSON com a descrição dos detalhes da imagem.
Lembre-se de salvar o ID da imagem. Os demais campos representam os diversos tamanhos das imagens.

{
   "id":"MLA430387888_032012",
   "quality":"",
   "variations":[...]
}

Vinculação de uma imagem a seu produto

Com o picture_id que obteve antes, você pode vincular a imagem a seu produto, conforme mostrado abaixo:

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d
'{"id":"MLA430387888_032012"}'

https://api.mercadolibre.com/items/MLA421101451/pictures?access_token=$ACCESS_TOKEN

Pronto! Agora vá para a página de descrição de seu produto (usando o campo permalink) e veja como sua imagem é exibida.

Substituição de imagens

Se for necessário substituir as imagens atuais de seu produto, você deverá realizar uma solicitação PUT incluindo o ID do produto e a URL da imagem, junto com seu access_token, conforme o exemplo abaixo:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
'{
  "pictures":[
    {"source":"http://www.apertura.com/export/sites/revistaap/img/Tecnologia/Logo_ML_NUEVO.jpg_33442984.jpg"},
    {"source":"http://appsuser.net/www/wp-content/uploads/2012/10/logo-mercadolibre.jpg"}
  ]
}' https://api.mercadolibre.com/items/{item_id}?access_token=$ACCESS_TOKEN

Para você levar em conta!

  • Se você quiser substituir uma imagem, deverá criar um novo source (dar outro nome à imagem); caso contrário, ao reutilizar o mesmo nome com conteúdo diferente, a imagem não será atualizada.
  • Se você tiver um grupo de imagens e quiser realizar as ações a seguir:
    Adicionar uma imagem: deverá enviar as IDs das imagens carregadas que quiser conservar mais os source (URL) das novas imagens. Além disso, você pode alterar a ordem enviando o body do PUT com a forma em que quiser visualizá-las.

    curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
    '{
    "pictures": [{"source": "http://SOURCE_IMAGEN_NUEVA.jpg"},
    			{"id": "111111 - IMAGEN_EXISTENTE_111111"},
    			{"id": "111111 - IMAGEN_EXISTENTE_111111"},
    			{"id": "111111 - IMAGEN_EXISTENTE_111111"}
    ],
    
    "variations": [{
    "id": "16787985187",
    "picture_ids": [
    		"http://SOURCE_IMAGEN_NUEVA.jpg", 
            "111111 - IMAGEN_EXISTENTE_111111", 
            "111111 - IMAGEN_EXISTENTE_111111", 
            "111111 - IMAGEN_EXISTENTE_111111"]},
    {
    "id": "16787985190",
    "picture_ids": [
    		"http://SOURCE_IMAGEN_NUEVA.jpg", 
            "111111 - IMAGEN_EXISTENTE_111111", 
            "111111 - IMAGEN_EXISTENTE_111111", 
            "111111 - IMAGEN_EXISTENTE_111111"]},
    
    {
    "id": "16787985193",
    "picture_ids": [
    		"http://SOURCE_IMAGEN_NUEVA.jpg", 
            "111111 - IMAGEN_EXISTENTE_111111", 
            "111111 - IMAGEN_EXISTENTE_111111", 
            "111111 - IMAGEN_EXISTENTE_111111"]}]
    }' http://api.mercadolibre.com/items/ITEM_ID?access_token=ACCESS_TOKEN

    Remover imagem: deverá enviar somente as IDs das imagens carregadas que você quiser conservar.



Excelente! Agora, a nova imagem de seu produto será exibida. Você já sabe como adicionar e substituir imagens. E lembre-se: boas imagens atrairão mais compradores!



Próximo:
Validador de publicações.

Qualifique entre 1 e 5

Descrição de artigos

A descrição de um produto contém informações personalizadas sobre o que você pretende vender e serve para complementar o que já é mostrado por padrão.

Que informações deve conter a descrição?

Deverão ser adicionadas as características técnicas e os aspectos que permitam diferenciar seu produto da concorrência.

Conteúdos

Carregar a descrição em um item

Através da API, você poderá trabalhar com descrições que contêm HTML e também com texto simples. Para conhecer o formato que pode utilizar, você deverá levar em conta o país onde opera o usuário ou se for uma publicação de Classificados.

Como realizar uma publicação com os dois formatos?

curl -X POST -H "Content-Type: application/json" -d
'{
    "title": "Item de test - No Ofertar",
    "category_id": "MLA47392",
    "price": 10,
    "currency_id": "ARS",
    "available_quantity": 1,
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "condition": "new",
    "description":{
                    "text":"Descripción con HTML",
                    "plain_text":"Descripción con Texto Plano  \n"},
    "video_id": "YOUTUBE_ID_HERE",
    "tags": [
        "immediate_payment"
    ],
    "warranty": "12 months by Ray Ban",
    "pictures": [
        {
            "source": "https://upload.wikimedia.org/wikipedia/commons/f/fd/Ray_Ban_Original_Wayfarer.jpg"
        },
        {
            "source": "https://en.wikipedia.org/wiki/File:Teashades.gif"
        }
    ]
}'
https://api.mercadolibre.com/items?access_token=$access_token

Benefícios de utilizar texto sem formato

  • As descrições serão descarregadas 5 vezes mais rápido.
  • Serão visualizadas em todos os dispositivos (móveis, tablets, computadores).
  • Terão um melhor resultado nas pesquisas.
  • Pesquisa por Boost, as publicações aparecerão mais acima se for carregada a ficha técnica do produto.
  • Além disso, você poderá carregar até 10 imagens do produto e/ou um link com um vídeo do Youtube.

A seguir apresentamos um exemplo sobre a melhor prática para criar a descrição:
Produto: “Raquete Babolat Pure Control 3”

Observações:

  • Leve em conta que tanto os métodos de pagamento quanto os meios de envio desejados, poderão ser adicionados na VIP.
  • Se você quiser exibir todas as variantes do item em uma publicação, mantendo o estoque diferencial por cada uma delas, recomendamos utilizar as características personalizadas.
  • Lembre-se que se você publicar em MLA com html e texto, a segunda opção será a prioridade.

Adicionar ou substituir uma descrição existente

Se você não forneceu uma descrição ao publicar um produto, poderá adicioná-la mais tarde. O mesmo acontece se você desejar modificar a existente.
Exemplo:

curl -X PUT -H "Content-Type: application/json" -d
'{
 "text":"Los mejores <b>Rayban Wayfarer</b>. Test",
"plain_text":"Los mejores Rayban Wayfarer. Test."
}'
https://api.mercadolibre.com/items/{ITEM_ID}/description?access_token=$ACCESS_TOKEN

Importante: Leve em conta que se você tiver publicado ambos os formatos e fizer um PUT apenas com um deles (por exemplo, apenas envia o body “plain_text”) o outro desaparecerá. Você deverá enviar ambos se quiser mantê-los, do contrário consideraremos que deseja eliminar o outro.

Você percebe como é fácil? A descrição pode ser adicionada ou substituída quando você quiser, mesmo quando o artigo já tenha ofertas; por isso, mãos à obra, crie uma descrição para seus artigos.

Qualifique entre 1 e 5

Validador de publicações

Como sabemos, para realizar uma publicação, às vezes é preciso fazer mais de uma tentativa, portanto, estamos oferecendo a possibilidade de consultar se a publicação ficou exatamente como você queria antes de publicá-la. A API Produtos oferece um serviço de validação para controlar todos os detalhes de sua publicação antes que ela seja publicada. Use-o para praticar até conseguir!

Assuntos

Exemplos de validação

Agora vamos ver um exemplo de como ele funciona. Vamos supor que você enviou esse JSON:

Exemplo:

 {
"seller_id":,
"id",
"price":"p",
"seller_contact":null,
"pictures": [[1,2,3]] 
}
Para esta url: https://api.mercadolibre.com/items/validate?access_token=$ACCESS_TOKEN
Como resultado, você receberá uma descrição exata das melhorias que deverá implantar em seu JSON para que a publicação de seu anúncio seja bem-sucedida:
{
"message":"body.invalid_field_types",
"error":"[invalid property type: [price] expected Number but was String value: p,
invalid property type: [seller_contact] expected Map but was Null value: null,
invalid property type: [pictures[0]] expected Map but was JSONArray value: [1, 2, 3],
invalid property type: [seller_id] expected Number but was String value: id]",
   "status":400,
   "cause":[

   ]
}

Validação de seu produto

 curl -X POST -H "Content-Type: application/json" -d'{
  "title":"Teacup",
  "category_id":"MLA1902",
  "price":10,
  "currency_id":"ARS",
  "available_quantity":1,
  "buying_mode":"buy_it_now",
  "listing_type_id":"bronze",
  "condition":"new",
  "description": "Item:, Teacup Model: 1. Size: 5cm. Color: White. New in Box",
  "video_id": "YOUTUBE_ID_HERE",
  "pictures":[
    {"source":"http://upload.wikimedia.org/wikipedia/commons/e/e9/Tea_Cup.jpg"}
  ]
}' https://api.mercadolibre.com/items/validate?access_token=$ACCESS_TOKEN

Validação de um produto com variações

 curl -X POST -H "Content-Type: application/json" -d '{  
   "title":"Short",
   "category_id":"MLA126455",
   "price":10,
   "currency_id":"ARS",
   "buying_mode":"buy_it_now",
   "listing_type_id":"bronze",
   "condition":"new",
   "description": "Short with variations", 
   "variations":[
      {
      "attribute_combinations":[
        {
          "id":"93000",
          "value_id":"101993"
        },
        {
          "id":"83000",
          "value_id":"91993"
        }
      ],
      "available_quantity":1,
      "price":10,
      "picture_ids":[
          "http://bttpadel.es/image/cache/data/ARTICULOS/PROVEEDORES/BTTPADEL/BERMUDA%20ROJA-240x240.jpg"
      ]
      },
      {
      "attribute_combinations":[
        {
          "id":"93000",
          "value_id":"101995"
        },
                {
          "id":"83000",
          "value_id":"92013"
        }
      ],
      "available_quantity":1,
      "price":10,
      "picture_ids":[
          "http://www.forumsport.com/img/productos/299x299/381606.jpg"
      ]
      }
   ]
}' https://api.mercadolibre.com/items/validate?access_token=$ACCESS_TOKEN

Validação de seu produto imóvel

 curl -X POST -H "Content-Type: application/json" -d' { 
  "site_id": "MLA",
  "title": "Propiedad en Alquiler, Item de Testeo, Por favor, no ofertar",
  "category_id": "MLA52745",
  "price": 5000,
  "currency_id": "ARS",
  "available_quantity": 1,
  "buying_mode": "classified",
  "listing_type_id": "silver",
  "condition": "not_specified",
  "pictures": [
    {
      "source":"http://farm3.staticflickr.com/2417/2176897085_946b7b66b8_b.jpg"
    },
    {
      "source":"http://farm2.staticflickr.com/1056/628680053_3b7c315548_b.jpg"
    }
  ],
  "seller_contact": {
    "contact": "Pepe",
    "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": "1111",
    "neighborhood": {
      "id": "TUxBQlBBUzgyNjBa"
    },
    "latitude": -34.48755,
    "longitude": -58.56987,
  },  
  "attributes": [
    {
      "id": "MLA50547-AMBQTY",
      "value_id": "MLA50547-AMBQTY-1"
    },
    {
      "id": "MLA50547-ANTIG",
      "value_id": "MLA50547-ANTIG-A_ESTRENAR"
    },
    {
      "id": "MLA50547-MTRS",
      "value_name": "500"
    },
    {
      "id": "MLA50547-SUPTOTMX",
      "value_name": "2000"
    },
    {
      "id": "MLA50547-BATHQTY",
      "value_id": "MLA50547-BATHQTY-1"
    },
    {
      "id": "MLA50547-DORMQTYB",
      "value_id": "MLA50547-DORMQTYB-3"
    },
    {
      "id": "MLA50547-EDIFIC",
      "value_id": "MLA50547-EDIFIC-CHALET"
    }
  ],
   "description" : "This is the real estate property description."
}' https://api.mercadolibre.com/items/validate?access_token=$ACCESS_TOKEN

Referência de códigos de erro

Caso a publicação seja rejeitada, você receberá uma mensagem “HTTP/1.1 204 No Content” da API de Produtos.
Aclaração: Para ver a mensagem “HTTP/1.1 204 No Content” na tela, adicione o parâmetro -i ao comando curl.

Considerações

Apesar de o processo de validação não ser obrigatório, ele pode ser útil no momento de testar seu aplicativo: Lembre-se de que não existe sandbox nem ambiente de pré-produção, por isso, todos os produtos publicados durante a fase de teste ficarão visíveis para todos os usuários que estiverem navegando em nosso Marketplace. Consulte o tutorial Testes para saber sobre as particularidades e práticas recomendadas no momento de iniciar o processo.

Qualifique entre 1 e 5

Gerencie seu aplicativo

Assuntos:

Acesso a seus aplicativos

Para acessar uma lista de seus aplicativos, faça uma busca de recursos de aplicativos com seu user_id.

Exemplo:

 curl -X GET https://api.mercadolibre.com/applications/search?owner_id={Owner_id}?access_token=$ACCESS_TOKEN

Exemplo:

 {
    "id": 2342346600929988,
    "site_id": "MLB",
    "name": "ML TEST",
    "description": "ML TEST APP",
    "thumbnail": null,
    "owner_id": 18731523,
    "catalog_product_id": null,
    "item_id": null,
    "price": null,
    "currency_id": null,
    "need_authorization": true,
    "short_name": "polipartes",
    "url": "http://apps.mercadolivre.com.br/polipartes",
    "callback_url": "http://www.vtexml.com.br/",
    "sandbox_mode": true,
    "is_public": true,
    "project_id": null,
    "active": true,
    "max_requests_per_hour": 18000,
    "scopes": [
      "write",
      "read",
      "offline_access"
    ],
    "domains": [
    ]
  }

Acesso aos detalhes dos aplicativos

Para acessar todos os detalhes de um de seus aplicativos, basta incluir o app_id na chamada à API.

Exemplo:

 curl -X GET https://api.mercadolibre.com/applications/213123928883922

Resposta:

 {
  "id": 213123928883922,
  "site_id": "MLB",
  "name": "ML Test",
  "description": "ML Test APP",
  "thumbnail": null,
  "owner_id": 18731523,
  "catalog_product_id": null,
  "item_id": null,
  "price": null,
  "currency_id": null,
  "need_authorization": true,
  "short_name": "polipartes",
  "url": "http://apps.mercadolivre.com.br/polipartes",
  "callback_url": "http://www.vtexml.com.br/",
  "sandbox_mode": true,
  "is_public": true,
  "project_id": null,
  "active": true,
  "max_requests_per_hour": 18000,
  "scopes": [],
  "domains": [
  ]
}

Acesso aos aplicativos autorizados pelo usuário

Para acessar todos os aplicativos autorizados por um usuário, basta enviar uma solicitação GET com o user_id e o token de acesso.

 GET https://api.mercadolibre.com/users/{user_id}/applications?access_token={...}

A resposta será um conjunto de aplicativos no seguinte formato:

 [
  - {
    "user_id": "26317316",
    "app_id": "13795",
    "date_created": "2012-12-20T15:38:27.000-04:00",
    "scopes": - [
      "read",
      "write",
    ],
   },
]

Descrição de campos

  • user_id – identificador do usuário.
  • app_id – Identificador do aplicativo.
  • date_created – data em que a autorização foi criada.
  • scopes – permissões concedidas ao aplicativo: leitura, gravação e offline_access.

Revogação da autorização do usuário

Para eliminar qualquer aplicativo, é preciso especificar seu ID, o ID do usuário e o token de acesso. Basta enviar uma solicitação DELETE utilizando a consulta abaixo:

 DELETE https://api.mercadolibre.com/users/{user_id}/applications/{app_id}?access_token={...}

A resposta deve ser:

 {
  "user_id":"{user_id}",
  "app_id":"{app_id}",
  "msg":"Autorización eliminada"
}

Qualifique entre 1 e 5

Variações Customizadas

Assuntos

O que são variações customizadas?

Quando usuários não encontrarem uma variação a qual necessitam, eles serão capazes de criar uma “variação customizada” que melhor se encaixa ou descreve seus produtos.
Por exemplo, um vendedor de capinhas de celular precisa adicionar o atributo “design” para uma variação. Ao fazê-lo, ele será capaz de criar um anúncio com as diferentes variações de design.
customvariations

Como usar variações customizadas

Ao usar variações customizadas, você deverá se certificar que a categoria que você deseja incluir um anúncio tem atributos. Além disso, os atributos e valores existentes na categoria deverão ser diferentes do que você está pretendendo adicionar. Leve em conta que só é possível adicionar um tipo de variação customizada por produto.

Publicando anúncios utilizando variações customizadas

Primeiro você precisa verificar no recurso Category da nossa API se a categoria que você escolheu aceita o tipo de viariação que você pretende adicionar:
Chamada:

 curl -X GET https://api.mercadolibre.com/categories/{Category_id}

Exemplo:

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

Resposta:

 {
  "id": "MLA70400",
  "name": "Silicona",
  "picture": null,
  "permalink": null,
  "total_items_in_this_category": 1693,
  "path_from_root": [
    {
      "id": "MLA1051",
      "name": "Celulares y Teléfonos"
    },
    {
      "id": "MLA3502",
      "name": "Accesorios para Celulares"
    },
    {
      "id": "MLA5337",
      "name": "Holders y Fundas"
    },
    {
      "id": "MLA39387",
      "name": "iPhone"
    },
    {
      "id": "MLA70400",
      "name": "Silicona"
    }
  ],
  "children_categories": [
  ],
  "attribute_types": "none",
  "settings": {
    "adult_content": false,
    "buying_allowed": true,
    "buying_modes": [
      "auction",
      "buy_it_now"
    ],
    "coverage_areas": "not_allowed",
    "currencies": [
      "ARS"
    ],
    "fragile": false,
    "immediate_payment": "optional",
    "item_conditions": [
      "used",
      "new",
      "not_specified"
    ],
    "items_reviews_allowed": false,
    "max_description_length": 50000,
    "max_pictures_per_item": 12,
    "max_sub_title_length": 70,
    "max_title_length": 60,
    "price": "required",
    "restrictions": [
    ],
    "rounded_address": false,
    "seller_contact": "not_allowed",
    "shipping_modes": [
      "me1",
      "me2",
      "not_specified",
      "custom"
    ],
    "shipping_options": [
      "custom",
      "carrier"
    ],
    "shipping_profile": "optional",
    "show_contact_information": false,
    "simple_shipping": "optional",
    "stock": "required",
    "tags": [
    ],
    "vip_subdomain": "articulo",
    "mirror_category": null,
    "listing_allowed": true,
    "maximum_price": null,
    "minimum_price": null
  },
  "meta_categ_id": 22340,
  "attributable": false
}

O próximo passo é realizar uma chamada para o recurso de atributos para verificar se a categoria tem atributos fixos.

 curl -X GET https://api.mercadolibre.com/categories/{Category_id}/attributes

Exemplo:

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

Neste caso, a categoria não possui atributos, portanto a variação será adicionada sem restrições. Você pode codificar seu JSON como no exemplo que segue:
Exemplo:

 curl -XPOST -H "Content-type: application/json" -d '{
    "site_id": "MLA",
    "title": "Item de Test - No Ofertar",
    "category_id": "MLA70400",
    "price": 1000,
    "currency_id": "ARS",
    "available_quantity": 9,
    "buying_mode": "buy_it_now",
    "listing_type_id": "bronze",
    "condition": "new",
    "video_id": null,
    "description": "item de test",
    "variations": [
        {
            "price": 1000,
            "available_quantity": 3,
            "picture_ids": [
                "21150-MLA20204290696_112014"
            ],
            "attribute_combinations": [
                {
                    "name": "Diseño",
                    "value_name": "Bulldog"
                }
            ]
        },
        {
            "price": 1000,
            "available_quantity": 3,
            "picture_ids": [
                "21124-MLA20204291671_112014"
            ],
            "attribute_combinations": [
                {
                    "name": "Diseño",
                    "value_name": "Búho"
                }
            ]
        }
    ]
}' https://api.mercadolibre.com/items?access_token={$ACCESS_TOKEN}

Resposta:

 {  
   "id":"MLA601053403",
   "site_id":"MLA",
   "title":"Item De Test - No Ofertar",
   "subtitle":null,
   "seller_id":202593498,
   "category_id":"MLA70400",
   "official_store_id":null,
   "price":1000,
   "base_price":1000,
   "original_price":null,
   "currency_id":"ARS",
   "initial_quantity":6,
   "available_quantity":6,
   "sold_quantity":0,
   "buying_mode":"buy_it_now",
   "listing_type_id":"bronze",
   "start_time":"2016-01-18T18:01:14.422Z",
   "stop_time":"2016-03-18T18:01:14.422Z",
   "end_time":"2016-03-18T18:01:14.422Z",
   "condition":"new",
   "permalink":"http://articulo.mercadolibre.com.ar/MLA-601053403-item-de-test-no-ofertar-_JM",
   "thumbnail":"http://mla-s1-p.mlstatic.com/21150-MLA20204290696_112014-I.jpg",
   "secure_thumbnail":"https://a248.e.akamai.net/mla-s1-p.mlstatic.com/21150-MLA20204290696_112014-I.jpg",
   "pictures":[  
      {  
         "id":"21150-MLA20204290696_112014",
         "url":"http://mla-s1-p.mlstatic.com/21150-MLA20204290696_112014-O.jpg",
         "secure_url":"https://a248.e.akamai.net/mla-s1-p.mlstatic.com/21150-MLA20204290696_112014-O.jpg",
         "size":"281x500",
         "max_size":"336x596",
         "quality":""
      },
      {  
         "id":"21124-MLA20204291671_112014",
         "url":"http://mla-s1-p.mlstatic.com/21124-MLA20204291671_112014-O.jpg",
         "secure_url":"https://a248.e.akamai.net/mla-s1-p.mlstatic.com/21124-MLA20204291671_112014-O.jpg",
         "size":"500x500",
         "max_size":"700x700",
         "quality":""
      }
   ],
   "video_id":null,
   "descriptions":[  
      {  
         "id":"MLA601053403-1011616345"
      }
   ],
   "accepts_mercadopago":true,
   "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":175597910,
      "comment":"",
      "address_line":"Test Address 123",
      "zip_code":"1414",
      "city":{  
         "id":"",
         "name":"Palermo"
      },
      "state":{  
         "id":"AR-C",
         "name":"Capital Federal"
      },
      "country":{  
         "id":"AR",
         "name":"Argentina"
      },
      "latitude":-34.5711496,
      "longitude":-58.4232966,
      "search_location":{  
         "neighborhood":{  
            "id":"",
            "name":""
         },
         "city":{  
            "id":"TUxBQ0NBUGZlZG1sYQ",
            "name":"Capital Federal"
         },
         "state":{  
            "id":"TUxBUENBUGw3M2E1",
            "name":"Capital Federal"
         }
      }
   },
   "seller_contact":null,
   "location":{  

   },
   "geolocation":{  
      "latitude":-34.5711496,
      "longitude":-58.4232966
   },
   "coverage_areas":[  

   ],
   "attributes":[  

   ],
   "warnings":[  

   ],
   "listing_source":"",
   "variations":[  
      {  
         "id":10541993184,
         "attribute_combinations":[  
            {  
               "id":null,
               "name":"Diseño",
               "value_id":null,
               "value_name":"Bulldog"
            }
         ],
         "price":1000,
         "available_quantity":3,
         "sold_quantity":0,
         "picture_ids":[  
            "21150-MLA20204290696_112014"
         ],
         "seller_custom_field":null,
         "attributes":[  

         ]
      },
      {  
         "id":10541993186,
         "attribute_combinations":[  
            {  
               "id":null,
               "name":"Diseño",
               "value_id":null,
               "value_name":"Búho"
            }
         ],
         "price":1000,
         "available_quantity":3,
         "sold_quantity":0,
         "picture_ids":[  
            "21124-MLA20204291671_112014"
         ],
         "seller_custom_field":null,
         "attributes":[  

         ]
      }
   ],
   "status":"not_yet_active",
   "sub_status":[  

   ],
   "tags":[  

   ],
   "warranty":null,
   "catalog_product_id":null,
   "seller_custom_field":null,
   "parent_item_id":null,
   "differential_pricing":null,
   "deal_ids":[  

   ],
   "automatic_relist":false,
   "date_created":"2016-01-18T18:01:14.574Z",
   "last_updated":"2016-01-18T18:01:14.574Z"
}

Perfeito! Você acabou de adicionar um anúncio com variação customizada. Clique no permalink para verificar como está o seu anúncio com a nova variação.

Como atualizar variações customizadas

Você já aprendeu a publicar com variações personalizadas e, provavelmente, você terá de atualizá-las ao atualizar estoque, preços, adicionar variações ou modificar os valores de atributos já publicados.
Para realizar mudanças em um produto com variações em uma variação em particular, você terá que obter o variation_id, consultando variações de um produto como segue:

Chamada:

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

Exemplo:

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

Resposta:

 {
    "id": 10541993184,
    "attribute_combinations": [
      {
        "id": null,
        "name": "Diseño",
        "value_id": null,
        "value_name": "Bulldog"
      }
    ],
    "price": 1000,
    "available_quantity": 3,
    "sold_quantity": 0,
    "picture_ids": [
      "21150-MLA20204290696_112014"
    ],
    "seller_custom_field": null
  },
  {
    "id": 10541993186,
    "attribute_combinations": [
      {
        "id": null,
        "name": "Diseño",
        "value_id": null,
        "value_name": "Búho"
      }
    ],
    "price": 1000,
    "available_quantity": 3,
    "sold_quantity": 0,
    "picture_ids": [
      "21124-MLA20204291671_112014"
    ],
    "seller_custom_field": null
  }

Uma vez que você conhece os IDs de cada variação, você pode pesquisar uma específica adicionando o variation_id no fim do GET:
Chamada:

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

Exemplo:

 curl -X GET https://api.mercadolibre.com/items/MLA601053403/variations/10541993184

Resposta:

 {
  "id": 10541993184,
  "attribute_combinations": [
    {
      "id": null,
      "name": "Diseño",
      "value_id": null,
      "value_name": "Bulldog"
    }
  ],
  "price": 1000,
  "available_quantity": 3,
  "sold_quantity": 0,
  "picture_ids": [
    "21150-MLA20204290696_112014"
  ],
  "seller_custom_field": null,
  "attributes": [
  ]
}

Diferentes tipos de alterações podem ser executadas em uma publicação com variações customizadas. As orientações abaixo mostram como trabalhar em cada caso individualmente.
Se você precisa adicionar uma imagem a uma variação existente, a URL da imagem terá de ser adicionada ao Array pictures do produto também. Além disso, uma vez que a atualização será realizada no recurso ITEMS, é necessário adicionar os IDs para cada variação existente no JSON. Caso contrário, a API irá interpretar que você não quer manter os outros e deletá-los.

Exemplo:

 curl -XPUT -H "Content-type: application/json" -d '{
  "pictures":[  
    { "id":"21124-MLA20204291671_112014" },
    { "id":"21150-MLA20204290696_112014" },
    { "source": "http://mla-s1-p.mlstatic.com/funda-marc-jacobs-3d-iphone-5-5s-5c-bulldog-cebra-buho-732301-MLA20299187840_052015-F.jpg" }
  ],
  "variations":[  
    { "id":10541993184},
    { "id":10541993186,
       "picture_ids":[  
          "21124-MLA20204291671_112014",
          "http://mla-s1-p.mlstatic.com/funda-marc-jacobs-3d-iphone-5-5s-5c-bulldog-cebra-buho-732301-MLA20299187840_052015-F.jpg"
       ]
    }
  ]
}' https://api.mercadolibre.com/items/MLA601053403?access_token=$ACCESS_TOKEN

Se você nao deseja manter as imagens que já estão publicadas, não as adicione no JSON e elas serão automaticamente excluídas.
Vamos imaginar que você tem um novo modelo para um dos seus produtos. Você pode adicionar uma nova variação na mesma publicação.
Exemplo:

 curl -X POST -d '{
  "attribute_combinations": [{
    "name": "Diseño",
    "value_name": "Cebra"
  }],
  "price": 1000,
  "available_quantity": 3,
  "picture_ids": ["209411-MLA20552996931_012016"]
}' https://api.mercadolibre.com/items/MLA601053403/variations?access_token=$ACCESS_TOKEN

OK. Agora, a lista tem três variações de modelo: Bulldog, Coruja e Zebra.
Se você quiser modificar um campo que seja uma variação “não-atributo”, você tem que fazer algo parecido. Neste caso, você terá que substituir o valor do campo “seller_custom_field”, que foi previamente definido como nulo, com uma string com o SKU do produto:
Exemplo:

 curl -X PUT -d '{"seller_custom_field": "123456789000"}' https://api.mercadolibre.com/items/MLA601053403/variations/10541993184?access_token=$ACCESS_TOKEN

Se você deseja modificar outros aspectos do anúncio que não sejam variações, siga o tutorial Sincronizando Publicações:
Relistando variações customizadas
Se sua publicação está encerrada mas você tem algumas variações ainda em estoque, você pode relistar essas variações modificando a quantidade disponível e o preço de cada uma.

Exemplo:

 curl -X POST -H "Content-Type: application/json" -d'{
    "listing_type_id": "bronze",
    "variations": [
        {
            "id": 10541993184,
            "price": 1000,
            "quantity": 2
        },
        {
            "id": 10541993186,
            "price": 1000,
            "quantity": 2
        },
                {
            "id": 10542199553,
            "price": 1000,
            "quantity": 1
        }
    ] }' https://api.mercadolibre.com/items/MLA601053403/relist?access_token=$ACCESS_TOKEN

Como você pode ver, quando uma publicação é relistada, uma nova publicação será criada, além disso será criado um novo “item_id” e um novo “variation_id”.

Como relistar variações customizadas

Caso seu anuncia já tenha finalizado mas ainda tem stock em algumas de suas variações pode relistar encaminhando as variações que deseja conservar, a quantidade disponível e o preço de cada uma delas.
Exemplo:

curl -X POST -H "Content-Type: application/json" -d'{
    "listing_type_id": "bronze",
    "variations": [
        {
            "id": 10541993184,
            "price": 1000,
            "quantity": 2
        },
        {
            "id": 10541993186,
            "price": 1000,
            "quantity": 2
        },
                {
            "id": 10542199553,
            "price": 1000,
            "quantity": 1
        }
    ] }' https://api.mercadolibre.com/items/MLA601053403/relist?access_token=¢ACCESS_TOKEN

Como pode ver na resposta, quando um produto é relistado se gera um novo anuncio pelo que renovaremos o “item_id” assim como o “Id” de suas variações.

Notas:

  • Se você deseja modificar o preço de um item que tenha variações deverá fazê-lo dentro de cada uma delas.
  • O item sempre ficará com só um preço para todas suas variações.

Como deletar variacões customizadas

Agora que você sabe como pegar o ID de cada variação, deletar uma ou mais variações de uma publicação será uma tarefa simples.

Exemplo:

 curl -X DELETE 'https://api.mercadolibre.com/items/MLA601053403/variations/10542199553?access_token=$ACCESS_TOKEN'

Muito bem! Agora você já aprendeu como deletar variações de uma publicação.

Qualifique entre 1 e 5

Resultados de paginação

Você pode definir o tamanho da página da lista de resultados. Há dois parâmetros: Limit e Offset. Ambos os parâmetros vão definir o tamanho do bloco dos resultados. Este artigo é baseado no exemplo de busca, mas você pode utilizar paginação em cada recurso apresentado nas informações de resposta sobre “paging”, conforme mostrado a seguir:

 .....
  "paging": {
    "total": 285,
    "offset": 0,
    "limit": 50,
  }
  .....

range-slider

Assuntos

Valores padrão

Os valores padrão são offset=0 e limit=50.
curl https://api.mercadolibre.com/sites/MLA/search?q=ipod nano
Na seção de paginação da resposta JSON você pode visualizar a quantidade total de produtos que correspondem à busca e o valor de offset junto com o limit padrão aplicado.

 .....
  "paging": {
    "total": 285,
    "offset": 0,
    "limit": 50,
  }
  .....

Limit

Para reduzir o tamanho da página, você pode alterar o parâmetro limit. Por exemplo, caso esteja interessado em recuperar somente os três primeiros produtos:

 curl https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&limit=3

Essa ação recupera um dado JSON com um conjunto de três produtos, conforme mostrado a seguir:

 {
  "site_id": "MLA",
  "query": "ipod nano",
  "paging": {
    "total": 284,
    "offset": 0,
    "limit": 3,
  },
  "results": [
    {...},
    {...},
    {...},
  ],
  "sort": {...},
  "available_sorts": [...],
  "filters": [...],
  "available_filters": [...],
}

Offset

Ao usar o atributo offset, você pode mover o limit inferior do bloco de resultados. Por exemplo, se estiver interessado em recuperar os 50 produtos que seguem à resposta padrão:

 curl https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&offset=50
{
  "site_id": "MLA",
  "query": "ipod nano",
  "paging": {
    "total": 285,
    "offset": 50,
    "limit": 50,
  },
  "results": [...],
  "sort": {...},
  "available_sorts": [...],
  "filters": [...],
  "available_filters": [...],
}

Essa resposta recupera 50 produtos a partir dos primeiros cinquenta.

Definição de uma faixa de resultados

Ambos os parâmetros podem ser combinados. Você pode recuperar produtos do terceiro ao sexto no resultado de busca original:

 curl https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&offset=3&limit=3

Essa ação recupera um dado JSON com um conjunto de cinco produtos, conforme mostrado a seguir:

 {
  "site_id": "MLA",
  "query": "ipod nano",
  "paging": {
    "total": 285,
    "offset": 3,
    "limit": 3,
  },
  "results": [
    {...},
    {...},
    {...},
  ],
  "sort": {...},
  "available_sorts": [...],
  "filters": [...],
  "available_filters": [...],
}

Qualifique entre 1 e 5

Saldo da conta

Assuntos:

 

Checar saldo da conta

Quando você tem dinheiro em sua conta, pode consultar o saldo usando o recurso Conta do Mercado Pago.

Exemplo:

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

Na resposta, você encontrará diversos valores separados por estado e disponibilidade.
O parâmetro “unavailable_balance_by_reason” mostra os valores ​​indisponíveis e indica o motivo da indisponibilidade.
Você também pode visualizar os valores disponíveis para transferência, saque e pagamento (crédito no Mercado Pago) no parâmetro “available_balance_by_transaction_type.”

Motivos para valores não disponíveis

Cada ítem que você publica irá aparecer nos resultados da lista de uma determinada pesquisa por produto. Por exemplo, quando um usuário buscar pela palavra “ipod”, como resultado ele vai ter uma lista de todos os itens relacionados. Seu anúncio pode estar nessa lista.
Quando alguém clica em um ítem, a página de detalhes do ítem é exibida, mostrando todas as informações sobre o ítem que foi fornecida no momento da publicação, continue lendo para saber mais sobre isto.

  • disputa – valor bloqueado enquanto o pedido se encontra em disputa
  • fraude – valor bloqueado devido a suspeita de fraude.
  • ml_debt – valor destinado apenas ao custo do Mercado Livre.
  • time_period – valor bloqueado pelo tempo padrão de processamento do Mercado Pago.
  • restrição – valor bloqueado por outros motivos.

Essas são as informações de que você precisa. Para obter mais informações sobre como trabalhar com o Mercado Pago, acesse site dos Desenvolvedores do MercadoPago.



Próximo:
API de sugestão de categorias.


Contribuições de nossa comunidade

Qualifique entre 1 e 5

Busca de produtos por categoria

A operação de busca retorna produtos pertencentes a uma categoria de produtos do Mercado Livre.
Para obter mais detalhes sobre as categorias e sua hierarquia, consulte o guia API de Categorias.

Assuntos

Solicitação

Ao utilizar uma categoria de produtos do Mercado Livre, você pode recuperar uma lista de produtos correspondentes a ela. Se estiver interessado em definir uma resposta de tamanho do bloco, leia o artigo sobre paginação de busca.

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

Resposta

A busca responde com um conjunto de resultados de produtos que estão dentro da categoria. Você encontrará a maior parte dos atributos do produto no resultado.

 {
  "site_id": "MLA",
  "paging": {
    "total": 109720,
    "offset": 0,
    "limit": 50
  },
  "results": [
    {
      "classified_marc_attribute_code": "-MARC",
      "classified_mode": "classified",
      "accepts_Mercado Pago": true,
      "address": null,
      "attributes": [
      ],
      "available_quantity": 10,

Utilize o método HTTP OPTIONS para obter uma resposta codificada em JSON que descreverá a API com todos os métodos e conexões permitidos entre ele e outra parte da API. É um formato padrão para obter documentação da API.

Qualifique entre 1 e 5