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.

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.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'  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.


Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/$ORDER_ID

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/orders/2053577644

Resposta:


{
    "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.

ou registre-se para receber as últimas notícias sobre nossa API