Quem somos?

No Mercado Livre temos uma plataforma aberta que nos permite compartilhar com a comunidade recursos públicos e privados para que possam trabalhar da mesma maneira que nós, criando soluções para vendedores.

Com a nossa API, você poderá fazer chamadas através do protocolo HTTPs utilizando os métodos GET, PUT, POST, DELETE e OPTIONS.

Nossa API Restful é totalmente gratuita e fácil de monetizar. Isto significa que se você cria uma aplicação e identificamos que há vendedores que a estão utilizando, você poderá iniciar o processo de certificação e fazer parte do App Store.

O App Store é um catálogo de aplicações disponível para que vendedores de diferentes países possam encontrar soluções certificadas que facilitam suas tarefas diárias.

 

Conteúdos

→Recursos públicos
→Recursos privados
   

Recursos públicos

São aqueles que não precisam de autenticação para ser consumidos. São utilizados para obter a informação de um anúncio, de nossa árvore de categorias, das perguntas realizadas, entre outros.

Son aquellos que no requieren una credencial para ser consumidos. Son utilizados para obtener la información de una publicación, de nuestro árbol de categorías, de las preguntas que se realizan, entre otros.

Nota:
Existem situações onde o recurso pode ser público e privado ao mesmo tempo, já que existe tanto informação aberta para todos quanto reservada só para aqueles que têm autenticação.

Exemplo:

  GET  https://api.mercadolibre.com/sites

Resposta

[
  {
    "id": "MLU",
    "name": "Uruguay"
  },
  {
    "id": "MSV",
    "name": "El Salvador"
  },
  {
    "id": "MLV",
    "name": "Venezuela"
  },
  {
    "id": "MPA",
    "name": "Panamá"
  },
  {
    "id": "MGT",
    "name": "Guatemala"
  },
  {
    "id": "MRD",
    "name": "Dominicana"
  },
  {
    "id": "MBO",
    "name": "Bolivia"
  },
  {
    "id": "MCO",
    "name": "Colombia"
  },
  {
    "id": "MLB",
    "name": "Brasil"
  },
  {
    "id": "MEC",
    "name": "Ecuador"
  },
  {
    "id": "MHN",
    "name": "Honduras"
  },
  {
    "id": "MPE",
    "name": "Perú"
  },
  {
    "id": "MLA",
    "name": "Argentina"
  },
  {
    "id": "MLC",
    "name": "Chile"
  },
  {
    "id": "MCU",
    "name": "Cuba"
  },
  {
    "id": "MLM",
    "name": "Mexico"
  },
  {
    "id": "MCR",
    "name": "Costa Rica"
  },
  {
    "id": "MPY",
    "name": "Paraguay"
  },
  {
    "id": "MPT",
    "name": "Portugal"
  },
  {
    "id": "MNI",
    "name": "Nicaragua"
  }
]

Recursos privados

Existem situações nas que que você deverá realizar um fluxo de autenticação para que o usuário (vendedor) autorize a aplicação, para que possa consultar a sua informação privada. Neste conjunto encontram-se as ordens, os envios, as mensagens e os métodos POST e PUT de todos os endpoints.

Exemplo:

 GET https://api.mercadolibre.com/orders/2053577644?access_token=$ACCESS_TOKEN
{
    "id": 2053577644,
    "date_created": "2019-06-13T09:20:02.000-04:00",
    "date_closed": "2019-06-13T09:20:08.000-04:00",
    "last_updated": "2019-06-13T09:20:08.000-04:00",
    "manufacturing_ending_date": null,
    "feedback": {
        "sale": null,
        "purchase": null
    },
    "mediations": [],
    "comments": null,
    "pack_id": 2000000101334825,
    "pickup_id": null,
    "order_request": {
        "return": null,
        "change": null
    },
    "fulfilled": null,
    "total_amount": 9.99,
    "paid_amount": 9.99,
    "coupon": {
        "id": null,
        "amount": 0
    },
    "expiration_date": "2019-07-11T09:20:08.000-04:00",
    "order_items": [
        
            "item": {
                "id": "MLB1226730704",
                "title": "Produto Teste - Não Ofertar",
                "category_id": "MLB11742",
                "variation_id": null,
                "seller_custom_field": null,
                "variation_attributes": [],
                "warranty": "12 months",
                "condition": "new",
                "seller_sku": null
            },
            "quantity": 1,
            "unit_price": 9.99,
            "full_unit_price": 9.99,
            "currency_id": "BRL",
            "manufacturing_days": null
        
    ],
    "currency_id": "BRL",
    "payments": [
        
            "id": 4863317779,
            "order_id": 2053577644,
            "payer_id": 419067349,
            "collector": {
                "id": 419059118
            },
            "card_id": null,
            "site_id": "MLB",
            "reason": "Produto Teste - Não Ofertar",
            "payment_method_id": "account_money",
            "currency_id": "BRL",
            "installments": 1,
            "issuer_id": null,
            "atm_transfer_reference": {
                "company_id": null,
                "transaction_id": null
            },
            "coupon_id": null,
            "activation_uri": null,
            "operation_type": "regular_payment",
            "payment_type": "account_money",
            "available_actions": [
                "refund"
            ],
            "status": "approved",
            "status_code": null,
            "status_detail": "accredited",
            "transaction_amount": 9.99,
            "taxes_amount": 0,
            "shipping_cost": 0,
            "coupon_amount": 0,
            "overpaid_amount": 0,
            "total_paid_amount": 9.99,
            "installment_amount": null,
            "deferred_period": null,
            "date_approved": "2019-06-13T09:20:07.000-04:00",
            "authorization_code": null,
            "transaction_order_id": null,
            "date_created": "2019-06-13T09:20:07.000-04:00",
            "date_last_modified": "2019-06-13T09:20:07.000-04:00"
        
    ],
    "shipping": {
        "id": 27987243797
    },
    "status": "paid",
    "status_detail": null,
    "tags": [
        "test_order",
        "pack_order",
        "paid"
    ],
    "buyer": {
        "id": 419067349,
        "nickname": "TT763866",
        "email": "ttest.6hqmq6+2-ogiydkmzvg43tmobx@mail.mercadolivre.com",
        "phone": {
            "area_code": "01",
            "extension": "",
            "number": "1111-1111",
            "verified": false
        },
        "alternative_phone": {
            "area_code": "",
            "extension": "",
            "number": ""
        },
        "first_name": "Test",
        "last_name": "Test",
        "billing_info": {
            "doc_type": "CPF",
            "doc_number": "78525276200"
        
    },
    "seller": {
        "id": 419059118,
        "nickname": "TETE8288849",
        "email": "ttest.hpz2z6q+2-ogiydkmzvg43tmobs@mail.mercadolivre.com",
        "phone": {
            "area_code": "01",
            "extension": "",
            "number": "1111-1111",
            "verified": false
        },
        "alternative_phone": {
            "area_code": "",
            "extension": "",
            "number": ""
        },
        "first_name": "Test",
        "last_name": "Test"
    },
    "taxes": {
        "amount": null,
        "currency_id": null
    
}

Ficou com vontade de trabalhar com nossa API? Comece agora com o nosso guia de Primeiros pasos.

Faça parte da nossa comunidade