About us

Mercado Libre has an open platform for sharing public and private resources with our community so that they can work as we do creating seller solutions. With our API Restful you can call via HTTPs using verbs GET, PUT, POST, DELETE and OPTIONS. Our API Restful is fully free of charge and easy to monetize, that is, if you create an application and we detect sellers using it, you can start your Certification Process and be part of our App Store. App Store is a catalog of applications available to sellers from different countries to find certified solutions that will facility their daily tasks.

Contents

→Public Resources
→Private Resources


Public Resources

Those that do not require credential to be used. They are used to get information from postings, our category tree, questions asked, among others.

Important:
In some instances, a resource can be public and private at the same time since it has some information open to all, and some other viewed with authentication only.

Call:

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

Example:

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

Response:

[
  {
    "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"
  }
]

Private Resources

In some cases an authentication flow is needed for user (seller) to authorize application to use private information. This set includes orders, shipments, messaging and verbs POST and PUT in all endpoints.


Call:

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

Example:

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

Example:

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

What are you waiting for? Start right now to create your application reading the following documentation about First steps.

or register to recieve the latest news about our API