Receive notifications

Some events occur on MercadoLibre’s side and notifications are the only way to become aware of them.
Receiving notifications enables you to have a real-time feed of the changes that occur on the different resources of our API.
For example, if you listed an item that was then paused, if someone asked a question, if they bought an item, or even if they paid it and/or requested shipment.
An efficient way with no need to continuously query our API!

Contents:

Subscribe to notifications

If you want to start receiving notifications you need to go to our application manager, where you first created your app, and edit the details and specify the topics you will listen to.
Note: If you haven’t created your App yet, go to the Creating your app section.

Topics

– Callback URL de Notificaciones: Configure the public URL of your domain where you want to receive notifications for the different topics. E.g.: “http://myshoes-app.com/callbacks”.

– Topics: Select among different topics to receive their notifications.
Explanatory note: Topics orders, created_orders and payments are not user for real state, vehicles and services.

Available Topics

  • items – To get notified of any changes on an item you have published.
  • orders – To get notified of any changes to any of our confirmed sales.
  • created_orders – To get notified of your recently created sales when they are entered through the mandatory Mercado Pago flow.
    You will only get product data and number of units, since the purchase has not been confirmed yet. You should not take any action until it changes to “paid.”
    This is only to reserve stock, because if the buyer pays but the item is out of stock, the payment is automatically returned and the sale is canceled.
  • Explanatory note: Once the order is paid, notifications are sent just like in “orders;” thus, we suggest choosing only one of the topics to avoid duplicated events.

  • questions – To get notified of all questions asked or answered.
  • payments – To get notified when a payment is created on an order, or when its status changes.
  • pictures – To get notified only of images which cannot be displayed due to errors.
  • Note: Meanwhile, an automatic e-mail grouping the faulty images will be sent to the seller.

Considerations

  • Messages will be sent out and retried for a period of 12 hours. After that period, if not accepted by the app, they will be discarded.
  • Since we will send a POST to your URL, your application must acknowledge the reception with an HTTP status code 200, otherwise the message will be considered undelivered and it will be retried.
  • Your application must send a response within 20 seconds, otherwise it will timeout and be considered undelivered and will retry.

What events trigger notifications?

items

  • Changes on any of the attributes.
  • Changes on the status: The listing has to be reviewed by an operator and the status is changed to “under_review” or it is paused and the status is changed to “paused”.

orders

  • Stock decrement: Somebody purchases one of your items and the stock is decremented. A new order is created.
  • Pago: The buyer adds a payment order.
  • Shipping: There is new shipping information associated with the order or the shipping status which changes to: pending, ready to print, in transit, delivered, not delivered.
  • Feedback: The buyer rates you as a seller or you send feedback to the buyer. A feed is received on the order.
  • Explanatory note: while “orders” is made up of blocks of other APIs, not every data is displayed, as not all of them are required. These separate blocks may have changes, which triggers events and subsequent notifications related to the order, though sometimes there is no evident change from the previous JSON.

created_orders

  • A created_orders notification will be received when an order entered through the mandatory Mercado Pago flow is created. This is only to reserve stock.
  • Once the order is “paid,” all notifications are the same as those in the “orders” topic. If both topics are selected, you will receive notifications from both of them.

questions

  • You receive a new question.
  • You answer a question.
  • You delete a question that you considered inappropriate.

payments

  • A payment is generated.
  • Payment status changes.

pictures

  • When an image failed to be displayed due to errors.

Get the details

After receiving a notification of one topic, you’ll need to make a GET to the resource to get the details and then, if you stored the previous Json, compare both.

items

Notification response:

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

This information will help you make a GET to the items resource:

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


orders and created_orders

Notification response:

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

This information will help you make a GET to the orders resource:

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


questions

Notification response:

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

This information will help you make a GET to the questions resource:

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


payments

Notification response:

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

This information will help you make a GET to the collections resource:

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


pictures

Notification response:

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

This information will help you make a GET to the picture resource:

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

You should identify why the image failed to be correctly processed. See “considerations and best practices working with pictures”.

Feed History API

We keep a track of your notifications history and you can get it anytime by calling our feeds resource.
Example:

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

Response:

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



Next topic: Searches and advanced features.

Please rate this

Manage contacts & visits

Introduction

When users browse classified items, they are able to contact the item’s owner through a form displayed on the listing or they can see the owner’s phone.
There’s a difference between how it works with logged users and guest users. When guest users make a question on your item, the contact goes directly to your email inbox and it’s gonna be displayed on our contacts resource since it doesn’t follow the regular questions flow. When a user that has an account on our site and it’s logged in make a question, it follows the regular questions flow and you can use the Questions API.

To learn how to work with logged users questions, please follow our Manage questions and answers guide. Otherwise, keep reading.

Classified contacts guide

This guide will help you to collect data about questions and phone views on your classified items. Is a read only API, very useful to take metrics of your classified items. You can query data about questions, and keep a record of how many times the ‘See phone’ option was clicked on. You can query by user, item, dates and time windows.

Contents:

Parameters description

TypeParameterDescription
Integer{userId}User id.
Integer{itemId}Item id.
Date{dateFrom}Date, ISO format, that defines the start of the query.
Date{dateTo}Date, ISO format, that defines the end of the query.
Integer{limit}Optional. Max amount of items to return.
Integer{offset}Optional. Pagination.
Integer{last}Optional. Denotes how many hours/days back the sample will cover.
String{unit}Query unit, possible values: [ “day” , “hour”].
Date{ending}Optional. Date, ISO format, which states the time of completion of the sample, by default it’s the current date and time.
String{order}Optional. It’s sorts the results by date: [“desc”, “asc”] (by default it’s “asc”).

Total questions

You can get the total questions an specific item had, or the total questions a seller had in all of his items between a date range.

By item

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

By user

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

Example:

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

Response:

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

Questions dated

This resource let you get the questions on an specific item or by seller for a certain time window. Besides, you get details about contacts made on guest mode (unlogged or unregistered users) in between time intervals, by hour or by day.

By item

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

If you need to concatenate items, do the following:

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

By user

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

Example:

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

Response:

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

Contact phone totals

You can get the total times the ‘See phone’ option was clicked on an item or for every item of an user between date ranges.

By item

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

By user

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

Example:

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

Response:

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

Contact phone dated

You can get the total times the ‘See phone’ option was clicked on an item or for every item of an user for a certain time window. Besides providing the total visits, the information is detailed and grouped by time intervals.

By item

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

If you need to concatenate items:

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

By user

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

Example:

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

Response:

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



Next topic: Subscribe to our feeds.

Please rate this

Update your listings

Once you have active listings on our marketplace, you’ll probably need to update and modify those listings from time to time. Follow this guide to know how to achieve this actions.

Contents:

Considerations

Not every field can be updated and this will vary whether the item had sales or not, and also remember your item must be active in order to be modified. You can modify the values for:

  • Title
  • Price
  • Pictures
  • Description*

*It’s not possible modify, just add a post.


Also remember that:

  • Category can’t be modified via API.
  • Listing type can be modified only once.

Update your item

Let’s see a basic example of updating an item title and price. The only thing you need is the item_id of the listed product and of course, the seller’s access_token.

Example:

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



Nice, your item title and price has been updated and you should receive a code 200 OK response status to know everything went well.
Keep in mind that it can take some time until you see the item’s information refreshed.

Description

It’s very easy to update a description, and is something you can do whether the item has bids or not, but since there are some considerations you need to keep when adding or replacing descriptions, check our descriptions article to make sure you get it right.

Pictures

You can always add or replace item pictures, refer to our working with pictures tutorial to know the best way to get through it.

Listing types

When you want more exposition on your item you need to make a listing type upgrade.Know the details and considerations and learn how to achieve an upgrade on our Listing types and Upgrades tutorial.

Changing listing status

Any item listed on our marketplace can hold different status, check the following description of each one:

  • closed: Finalizes your publication. Once closed, it cannot be reactivated again, but you can relist it.
  • paused: Pauses your publication. Once paused, it will not be visible to other MercadoLibre’s users, but it will not be closed and it can be reactivated later on.
  • active: Reactivates a previously paused item.

If you need to make any changes on the item status, you need to send any of these values for the “status” field, note the value is case sensitive and must be sent in lowercase.

Follow the example to pause an active item:
Example:

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


Excellent! Your item has been paused. Now you can try to activate it again by making the exact same call sending “active” instead of “paused” as the status value.

If your item is currently closed and your intention is to relist it, check our relist article to achieve it right away.
Please check out the listing life-cycle article to know more about item status.

Delete listing

Deleting a listing has no way back, so be careful when you call this action. Also note that there’s no need to delete closed items since they’ll be discarded automatically after some time.
If you still need to delete an item, for example items in status: payment_required that won’t respond to ‘closed’ status, do as it follows:
Example:

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

That’s it! Your item should be removed.



Next topic: Manage contacts and visits.

Please rate this

Authentication and Authorization

Mercado Libre platform allows you to work with our API public and private resources, via HTTP calls using GET, PUT, POST, DELETE and OPTIONS.
Public resources, such as available sites and categories, can be anonymously accessed, while private resources and user-own actions, such as listing an item, giving feedback or viewing purchase/sale information, require application-based authorization.
This guide explains the meaning of authentication and the authorization flow to be followed to obtain an access_token (access key to private resources for each user granting authorization to the application – valid for 6 hours).
For example:
Without access_token (Public Resource)

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

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


With access_token (Private Resource)

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

{
  "id": 226384143,
  "nickname": "TETE9928972",
  "registration_date": "2016-08-25T11:36:00.000-04:00",
  "first_name": "Test",
  "last_name": "Test",
  "country_id": "AR",
  "email": "test_user_38730994@testuser.com",
  "identification": {
    "type": "DNI",
    "number": "1111111"
  },
  "address": {
    "state": "AR-C",
    "city": "Palermo",
    "address": "Test Address 123",
    "zip_code": "1414"
  },
  "phone": {
    "area_code": "01",
    "number": "1111-1111",
    "extension": "",
    "verified": false
  },
  "alternative_phone": {
    "area_code": "",
    "number": "",
    "extension": ""
  },
  "user_type": "normal",
  "tags": [
    "normal",
    "test_user",
    "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE9928972",
  "shipping_modes": [
    "custom",
    "not_specified"
  ],
  "seller_experience": "ADVANCED",
  "bill_data": {
    "accept_credit_note": null
  },
  "seller_reputation": {
    "level_id": null,
    "power_seller_status": null,
    "transactions": {
      "period": "historic",
      "total": 1,
      "completed": 1,
      "canceled": 0,
      "ratings": {
        "positive": 0,
        "negative": 0,
        "neutral": 1
      }
    }
  },
  "buyer_reputation": {
    "canceled_transactions": 0,
    "transactions": {
      "period": "historic",
      "total": null,
      "completed": null,
      "canceled": {
        "total": null,
        "paid": null
      },
      "unrated": {
        "total": null,
        "paid": null
      },
      "not_yet_rated": {
        "total": null,
        "paid": null,
        "units": null
      }
    },
    "tags": [
    ]
  },
  "status": {
    "site_status": "active",
    "list": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "buy": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "sell": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "billing": {
      "allow": true,
      "codes": [
      ]
    },
    "mercadopago_tc_accepted": true,
    "mercadopago_account_type": "personal",
    "mercadoenvios": "not_accepted",
    "immediate_payment": false,
    "confirmed_email": false,
    "user_type": "simple_registration",
    "required_action": ""
  },
  "credit": {
    "consumed": 101.1,
    "credit_level_id": "MLA1"
  }
}

Contents:

Authentication

Authentication is the act or process of determining or confirming whether someone or something is, in fact, who or what it is declared to be.
In the case of a person, authentication consists in verifying his/her identity based on one or several factors, ensuring the sender’s data are correct.

Some authentication methods are:

  • Biomedical methods, fingerprints or retinal scan, etc.
  • Smart cards that save a user´s certificate information.
  • Standard methods based on passwords.
  • For example, to log into Mercado Libre we authenticate ourselves by entering our user name and password.

login

Authorization

Authorization is the process whereby we allow someone or something to access private resources.
The authorization should define which resources and operations can be performed, since it is not the same to grant read-only than read and write access.

How do we obtain authorization? Via the OAuth 2.0 Protocol, which is one of the most widely used protocols in open platforms (Twitter, Facebook, etc.) and a secure method to work with private resources.

OAuth offers:

  • Confidentiality, the user will never have to disclose his/her key.
  • Integrity, private data can only be viewed by applications with permits to do so.
  • Availability, data will always be available, on a need basis.

This protocol offers 4 possible operating modes, called Grant Types:

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

Although each of them is used for different purposes depending on the service being developed, below you will find the explanation of the first two types since they will allow you to work with our resources and develop tools for every user in Mercado Libre.

Client-side

The Client-side authorization flow is better suited for applications executing the client-side code, e.g., applications developed in javascript/ajax, Angular or mobile applications.
For more information about this flow, go to the tutorial “Client-Side Authorization

Server-side

The Server Side authorization flow is better suited for applications executing the server-side code, such as, applications developed in Java, Grails, Go, etc.
Note: This option will be helpful for applications executing cron jobs, to update product stock or operate when the user is not directly interacting with the application.
For more information about this flow, go to the tutorial “Server-Side Authorization

Get your access_token!

Enter the application ID you have just created:

*Please enter a valid Application ID
User informationJSON Response

-

Use our SDKs

Using our SDKs the authentication process will be simpler since our SDKs save you from coding the whole OAuth protocol from scratch.
Our community is already using them!
We already provide SDKs for:

If you find an enhancement or have a suggestion, you can share it with the community creating a Pull Request within our GitHub repository.

Considerations

Token validity and expiration
When you get an access_token, it will be immediately valid and usable to make requests to the API for a limited period of 6 hours.
There are also events which may cause an access_token to become invalid before the expiration time. For example: user changing his/her password, an application refreshing its App Secret and, of course, a user revoking permissions to your application.

Error Codes Reference

ErrorDescriptionPossible solution
invalid_client

invalid client_id or client_secret

Invalid client_id and/or client_secret provided.Check your application info and verify parameters client_id and client_secret
invalid_grant

To create an access token the user {0} must have an active session, or your application should request authorization for offline_access scope.

The provided authorization grant is invalid, expired, revoked, or does not match the redirection URI used in the authorization request.Verify the parameter redirect_uri is the same configured in your application (App Manager), if this not solve, do a new request to obtain a new code.
invalid_grant

Error validating grant. Your authorization code or refresh token may have expired or it has already been used.

It has expired or it has already been used.Make a new request to obtain one new code or refresh_token.
invalid_grant

The client_id does not match the original.

Client ID does not match.The parameter client_id wasn’t found, to get your client_id, consult your application (App Manager).
invalid_grant

The redirect_uri does not match the original.

Redirect URI does not match the original.The parameter redirect_uri is not the same configured in you application, to get your a redirect_uri, consult your application (App Manager)
invalid_scopeThe requested scope is invalid, unknown, or malformed.The values allowed for parameter scope are:“offline_access”,”write”,”read”.
invalid_request

Wrong number of parameters with duplicate values.

The request is missing a required parameter, includes an unsupported parameter or parameter value, or is otherwise malformed.Verify that the parameters sent are valid and are not duplicated.
unsupported_grant_type

Unsupported grant type: ${0}.

The authorization grant type is not supported by the authorization server.The values allowed for parameter grant_type are“authorization_code” or “refresh_token”.
forbidden

The caller is not authorized to access this resource

The caller is not authorized to access.It is using the token of another user.


Next topic: Manage users


Related article:

Server side authentication flow

Client side authentication flow

Please rate this

Searches & advanced features

If you want sellers to use the application that you developed to enhance their business, take into account that you have available a lot of useful market information to help sellers create sales strategies and make smart decisions timely. You can also develop a system to compare prices and attributes between different types of listings.

Follow our guides to learn how to take advantage of every resource!

Advanced queries

Help your sellers stay one step ahead in their business at all times. First, bear in mind that you will not be able to access private data from users who have not granted permission to your application. However, you can get public data about these users, such as who lists under the same categories as you, number of listings posted, prices and attributes included in their listings, categories under which they list, and number of contacts and visits they get on a daily basis.

Compare prices and attributes

You could suggest sellers using your system what’s the best price to sell their products and be competitive by analyzing the price of the same kind of products listed on MercadoLibre. To do this it may come handy to learn how to search items by category, then check the price field of those items and calculate the average.

You could also make a system that analyzes the classified market items prices and attributes so buyers can compare, localize, and find exactly what they’re looking for.

Follow the guides below to learn how to use the resources that will help you accomplish this:

Please rate this

List services

This guide will help you to list your first classified item on MercadoLibre using our API

Contents:

Basics

Classified listings are the only kind of items that allows users to display their contact information to the public, so when users are browsing classifieds and they have an interest on one of yours, they can get in contact with you right away. So, basically, there aren’t any kind of transactions or exchanges made on our site for this kind of items, but you’ll be exposing your listing to every user that’s browsing classifieds on our platform.

Listing results

Each item you list will appear in the listing results of a given search. For example, when a user search for the query “Peluquería”, as a result he will get a list of all items related, that can include yours.
When someone clicks on an item, the item details page is displayed showing all the information about the item that was provided at the time of listing, keep reading to know more about it.

Item details page

This is the page on the frontend of our Marketplace for each item.
When a user chooses an item from the result, this page displays the following item details:

  • Item_id
  • Title
  • City
  • Pictures
  • Price
  • Contact information
  • Contact form
  • Attributes
  • Detailed description
  • Reviews

Service item fields

Let’s see a regular service listing Json from our API. This is easy since you only need to know the item_id associated to that item, and since it’s public you can get it from the item details page. In Argentina, you will find it at the top of the page. You just need to add the site_id before the number you see and that’s it. Now you can call the Items resource to get all the information you need:

Call:

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

Example:

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

Response:

{
  "id": "MLA612001263",
  "site_id": "MLA",
  "title": "Okm Amarok Highline Pack Automatic Cuero Navegador Esp.rebat",
  "subtitle": null,
  "seller_id": 171413284,
  "category_id": "MLA92242",
  "official_store_id": null,
  "price": 694000,
  "base_price": 694000,
  "original_price": null,
  "currency_id": "ARS",
  "initial_quantity": 1,
  "available_quantity": 1,
  "sold_quantity": 0,
  "buying_mode": "classified",
  "listing_type_id": "gold",
  "start_time": "2016-03-17T12:52:07.000Z",
  "stop_time": "2016-04-23T17:06:37.707Z",
  "condition": "not_specified",
  "permalink": "http://auto.mercadolibre.com.ar/MLA-612001263-okm-amarok-highline-pack-automatic-cuero-navegador-esprebat-_JM",
  "thumbnail": "http://mla-s2-p.mlstatic.com/624411-MLA20545255891_012016-I.jpg",
  "secure_thumbnail": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/624411-MLA20545255891_012016-I.jpg",
  "pictures": [
    {
      "id": "624411-MLA20545255891_012016",
      "url": "http://mla-s2-p.mlstatic.com/624411-MLA20545255891_012016-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/624411-MLA20545255891_012016-O.jpg",
      "size": "500x428",
      "max_size": "1200x1028",
      "quality": ""
    },
    {
      "id": "366311-MLA20544374183_012016",
      "url": "http://mla-s1-p.mlstatic.com/366311-MLA20544374183_012016-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/366311-MLA20544374183_012016-O.jpg",
      "size": "499x272",
      "max_size": "995x543",
      "quality": ""
    },
    {
      "id": "636311-MLA20545255955_012016",
      "url": "http://mla-s1-p.mlstatic.com/636311-MLA20545255955_012016-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/636311-MLA20545255955_012016-O.jpg",
      "size": "500x383",
      "max_size": "1200x921",
      "quality": ""
    },
    {
      "id": "134311-MLA20545256000_012016",
      "url": "http://mla-s1-p.mlstatic.com/134311-MLA20545256000_012016-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/134311-MLA20545256000_012016-O.jpg",
      "size": "500x357",
      "max_size": "1200x858",
      "quality": ""
    },
    {
      "id": "661411-MLA20545258607_012016",
      "url": "http://mla-s2-p.mlstatic.com/661411-MLA20545258607_012016-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/661411-MLA20545258607_012016-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    },
    {
      "id": "820411-MLA20545256923_012016",
      "url": "http://mla-s1-p.mlstatic.com/820411-MLA20545256923_012016-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/820411-MLA20545256923_012016-O.jpg",
      "size": "375x500",
      "max_size": "900x1200",
      "quality": ""
    },
    {
      "id": "757311-MLA20545256948_012016",
      "url": "http://mla-s2-p.mlstatic.com/757311-MLA20545256948_012016-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/757311-MLA20545256948_012016-O.jpg",
      "size": "375x500",
      "max_size": "900x1200",
      "quality": ""
    },
    {
      "id": "843311-MLA20545256985_012016",
      "url": "http://mla-s1-p.mlstatic.com/843311-MLA20545256985_012016-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/843311-MLA20545256985_012016-O.jpg",
      "size": "375x500",
      "max_size": "900x1200",
      "quality": ""
    },
    {
      "id": "952411-MLA20545259213_012016",
      "url": "http://mla-s2-p.mlstatic.com/952411-MLA20545259213_012016-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/952411-MLA20545259213_012016-O.jpg",
      "size": "375x500",
      "max_size": "900x1200",
      "quality": ""
    },
    {
      "id": "658311-MLA20545259279_012016",
      "url": "http://mla-s2-p.mlstatic.com/658311-MLA20545259279_012016-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/658311-MLA20545259279_012016-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    },
    {
      "id": "281411-MLA20545257928_012016",
      "url": "http://mla-s1-p.mlstatic.com/281411-MLA20545257928_012016-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/281411-MLA20545257928_012016-O.jpg",
      "size": "500x375",
      "max_size": "1200x900",
      "quality": ""
    },
    {
      "id": "846311-MLA20545257964_012016",
      "url": "http://mla-s1-p.mlstatic.com/846311-MLA20545257964_012016-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/846311-MLA20545257964_012016-O.jpg",
      "size": "375x500",
      "max_size": "900x1200",
      "quality": ""
    },
    {
      "id": "816311-MLA20545261007_012016",
      "url": "http://mla-s2-p.mlstatic.com/816311-MLA20545261007_012016-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/816311-MLA20545261007_012016-O.jpg",
      "size": "489x500",
      "max_size": "1174x1200",
      "quality": ""
    },
    {
      "id": "793311-MLA20545258000_012016",
      "url": "http://mla-s1-p.mlstatic.com/793311-MLA20545258000_012016-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/793311-MLA20545258000_012016-O.jpg",
      "size": "500x254",
      "max_size": "1200x610",
      "quality": ""
    }
  ],
  "video_id": "XVYGawQRnlo",
  "descriptions": [
    {
      "id": "MLA612001263-1056189973"
    }
  ],
  "accepts_mercadopago": false,
  "non_mercado_pago_payment_methods": [
  ],
  "shipping": {
    "mode": "not_specified",
    "local_pick_up": false,
    "free_shipping": false,
    "methods": [
    ],
    "dimensions": null,
    "tags": [
    ]
  },
  "international_delivery_mode": "none",
  "seller_address": {
    "id": 153496278,
    "comment": "",
    "address_line": "av Gaona 4460",
    "zip_code": "",
    "city": {
      "id": "TUxBQkZMTzg5MjFa",
      "name": "Floresta"
    },
    "state": {
      "id": "AR-C",
      "name": "Capital Federal"
    },
    "country": {
      "id": "AR",
      "name": "Argentina"
    },
    "latitude": "",
    "longitude": "",
    "search_location": {
      "neighborhood": {
        "id": "TUxBQkZMTzg5MjFa",
        "name": "Floresta"
      },
      "city": {
        "id": "TUxBQ0NBUGZlZG1sYQ",
        "name": "Capital Federal"
      },
      "state": {
        "id": "TUxBUENBUGw3M2E1",
        "name": "Capital Federal"
      }
    }
  },
  "seller_contact": {
    "contact": "",
    "other_info": "",
    "area_code": "",
    "phone": "",
    "area_code2": "",
    "phone2": "",
    "email": "",
    "webpage": ""
  },
  "location": {
    "address_line": "",
    "zip_code": "",
    "neighborhood": {
      "id": "TUxBQlNBTjEyMjNa",
      "name": "Santa Rita"
    },
    "city": {
      "id": "TUxBQ0NBUGZlZG1sYQ",
      "name": "Capital Federal"
    },
    "state": {
      "id": "TUxBUENBUGw3M2E1",
      "name": "Capital Federal"
    },
    "country": {
      "id": "AR",
      "name": "Argentina"
    },
    "latitude": "",
    "longitude": "",
    "open_hours": ""
  },
  "geolocation": {
    "latitude": "",
    "longitude": ""
  },
  "coverage_areas": [
  ],
  "attributes": [
    {
      "id": "MLA1743-HORPREF",
      "name": "Horario de contacto",
      "value_id": "",
      "value_name": "08.30 a 20 ",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "MLA1744-COLOREXT",
      "name": "Color",
      "value_id": "",
      "value_name": "",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "MLA1744-DIREC",
      "name": "Dirección",
      "value_id": "",
      "value_name": "",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "MLA1744-OWNER",
      "name": "Único dueño",
      "value_id": "",
      "value_name": "",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "MLA1744-AIRACON",
      "name": "Aire acondicionado",
      "value_id": "MLA1744-AIRACON-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-ALARMLUC",
      "name": "Alarma de luces encendidas",
      "value_id": "MLA1744-ALARMLUC-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-APERBAUL",
      "name": "Apertura remota de baúl",
      "value_id": "MLA1744-APERBAUL-N",
      "value_name": "No",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-ASIENELEC",
      "name": "Asientos eléctricos",
      "value_id": "MLA1744-ASIENELEC-N",
      "value_name": "No",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-ASREBAT",
      "name": "Asiento trasero rebatible",
      "value_id": "MLA1744-ASREBAT-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-ASREGULA",
      "name": "Asiento conductor regulable en altura",
      "value_id": "MLA1744-ASREGULA-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-BLQCNTDOOR",
      "name": "Cierre centralizado de puertas",
      "value_id": "MLA1744-BLQCNTDOOR-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-CLIMAUT",
      "name": "Climatizador automático",
      "value_id": "MLA1744-CLIMAUT-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-COMPABO",
      "name": "Computadora de abordo",
      "value_id": "MLA1744-COMPABO-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-CTRLVEL",
      "name": "Control de velocidad de crucero",
      "value_id": "MLA1744-CTRLVEL-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-ESPELEC",
      "name": "Espejos eléctricos",
      "value_id": "MLA1744-ESPELEC-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-ESTACIONAM",
      "name": "Sensor de estacionamiento",
      "value_id": "MLA1744-ESTACIONAM-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-FAROREG",
      "name": "Faros regulables desde el interior",
      "value_id": "MLA1744-FAROREG-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-GPS",
      "name": "GPS",
      "value_id": "MLA1744-GPS-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-SENSLL",
      "name": "Sensor de lluvia",
      "value_id": "MLA1744-SENSLL-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-SENSLUZ",
      "name": "Sensor de luz",
      "value_id": "MLA1744-SENSLUZ-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-TAPCUERO",
      "name": "Tapizado de cuero",
      "value_id": "MLA1744-TAPCUERO-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-TECHOCORR",
      "name": "Techo corredizo",
      "value_id": "MLA1744-TECHOCORR-N",
      "value_name": "No",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-VIDELEC",
      "name": "Cristales eléctricos",
      "value_id": "MLA1744-VIDELEC-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-LIMPIA_LAV",
      "name": "Limpia/lava luneta",
      "value_id": "MLA1744-LIMPIA/LAV-N",
      "value_name": "No",
      "attribute_group_id": "EXTERIOR",
      "attribute_group_name": "Exterior"
    },
    {
      "id": "MLA1744-LLANALEAC",
      "name": "Llantas de aleación",
      "value_id": "MLA1744-LLANALEAC-Y",
      "value_name": "Sí",
      "attribute_group_id": "EXTERIOR",
      "attribute_group_name": "Exterior"
    },
    {
      "id": "MLA1744-PARAGOLPES",
      "name": "Paragolpes pintados",
      "value_id": "MLA1744-PARAGOLPES-Y",
      "value_name": "Sí",
      "attribute_group_id": "EXTERIOR",
      "attribute_group_name": "Exterior"
    },
    {
      "id": "MLA1744-VIDPOLARIZ",
      "name": "Vidrios polarizados",
      "value_id": "MLA1744-VIDPOLARIZ-N",
      "value_name": "No",
      "attribute_group_id": "EXTERIOR",
      "attribute_group_name": "Exterior"
    },
    {
      "id": "MLA1744-COMBUS",
      "name": "Combustible",
      "value_id": "MLA1744-COMBUS-DIESEL",
      "value_name": "Diesel",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-DOOR",
      "name": "Cant. de puertas",
      "value_id": "MLA1744-DOOR-4",
      "value_name": "4",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-KMTS",
      "name": "Kilómetros",
      "value_id": "",
      "value_name": "0",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-MARC",
      "name": "Marca",
      "value_id": "MLA1744-MARC-VOLKSWAGEN",
      "value_name": "Volkswagen",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-MODL",
      "name": "Modelo",
      "value_id": "MLA1744-MODL-AMAROK",
      "value_name": "Amarok",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-TRANS",
      "name": "Transmisión",
      "value_id": "",
      "value_name": "",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-YEAR",
      "name": "Año",
      "value_id": "MLA1744-YEAR-95192c",
      "value_name": "2016",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA92242-VERS",
      "name": "Versión",
      "value_id": "",
      "value_name": "",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-3LUZSTOP",
      "name": "Tercer stop",
      "value_id": "MLA1744-3LUZSTOP-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-ABS",
      "name": "Frenos ABS",
      "value_id": "MLA1744-ABS-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-AIR1",
      "name": "Airbag conductor",
      "value_id": "MLA1744-AIR1-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-AIR2",
      "name": "Airbag pasajero",
      "value_id": "MLA1744-AIR2-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-AIR3",
      "name": "Airbag laterales",
      "value_id": "MLA1744-AIR3-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-AIRBAGCORT",
      "name": "Airbag de cortina",
      "value_id": "MLA1744-AIRBAGCORT-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-ALAR",
      "name": "Alarma",
      "value_id": "MLA1744-ALAR-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-APCABEZA",
      "name": "Apoya cabeza en asientos traseros",
      "value_id": "MLA1744-APCABEZA-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-BLIND",
      "name": "Blindado",
      "value_id": "MLA1744-BLIND-N",
      "value_name": "No",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-CNTTRACC",
      "name": "Control de tracción",
      "value_id": "MLA1744-CNTTRACC-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-CONTR",
      "name": "Control de estabilidad",
      "value_id": "MLA1744-CONTR-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-DOBTRACC",
      "name": "Doble tracción",
      "value_id": "MLA1744-DOBTRACC-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-FARANTI",
      "name": "Faros antinieblas delanteros",
      "value_id": "MLA1744-FARANTI-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-FAROXEN",
      "name": "Faros de xenón",
      "value_id": "MLA1744-FAROXEN-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-INMOVMOT",
      "name": "Inmovilizador de motor",
      "value_id": "MLA1744-INMOVMOT-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-ISOFIX",
      "name": "Isofix",
      "value_id": "MLA1744-ISOFIX-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-NEBLTRAS",
      "name": "Faros antinieblas traseros",
      "value_id": "MLA1744-NEBLTRAS-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-REPFUERZA",
      "name": "Repartidor electrónico de fuerza de frenado",
      "value_id": "MLA1744-REPFUERZA-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-AM_FM",
      "name": "AM/FM",
      "value_id": "MLA1744-AM/FM-Y",
      "value_name": "Sí",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-BLUETOOTH",
      "name": "Bluetooth",
      "value_id": "MLA1744-BLUETOOTH-Y",
      "value_name": "Sí",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-CAJACD",
      "name": "Caja de CD",
      "value_id": "MLA1744-CAJACD-N",
      "value_name": "No",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-CARGADORCD",
      "name": "Cargador de CD",
      "value_id": "MLA1744-CARGADORCD-N",
      "value_name": "No",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-CASET",
      "name": "Pasacassette",
      "value_id": "MLA1744-CASET-N",
      "value_name": "No",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-COMANDOSAT",
      "name": "Comando satelital de stereo",
      "value_id": "MLA1744-COMANDOSAT-N",
      "value_name": "No",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-DVD",
      "name": "DVD",
      "value_id": "MLA1744-DVD-N",
      "value_name": "No",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-ENTAUXILIA",
      "name": "Entrada auxiliar",
      "value_id": "MLA1744-ENTAUXILIA-Y",
      "value_name": "Sí",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-MP3",
      "name": "MP3",
      "value_id": "MLA1744-MP3-Y",
      "value_name": "Sí",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-REPRODCD",
      "name": "CD",
      "value_id": "MLA1744-REPRODCD-Y",
      "value_name": "Sí",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-TARJETASD",
      "name": "Tarjeta SD",
      "value_id": "MLA1744-TARJETASD-Y",
      "value_name": "Sí",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-USB",
      "name": "Entrada USB",
      "value_id": "MLA1744-USB-Y",
      "value_name": "Sí",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    }
  ],
  "warnings": [
  ],
  "listing_source": "",
  "variations": [
  ],
  "status": "active",
  "sub_status": [
  ],
  "tags": [
    "dragged_visits"
  ],
  "warranty": null,
  "catalog_product_id": null,
  "parent_item_id": "MLA599924359",
  "differential_pricing": null,
  "deal_ids": [
  ],
  "automatic_relist": false,
  "date_created": "2016-03-17T12:52:08.000Z",
  "last_updated": "2016-03-22T17:07:24.286Z"
}

 

There’s a lot of information about the service this user is selling. Is very important you send the most attributes you can so user’s get the whole picture right away. You can click on the permalink attribute on an item to see how it looks on our Marketplace.

Defining attributes

There are no mandatory attributes on services except for title.

Title

You must send a title for your service. This make it easier for users to find exactly what they’re looking for.

Description

A detailed description will improve your chances to get contacts for your service and will save you time from answering unnecessary question. It can be a text-only description or you can add your own personalized HTML. There are some considerations when working with descriptions. If you are interested in increasing your knowledge about this topic, check our Item description guide.

Pictures

Good pictures can make your service more appealing. Basically, you should add an array of up to six URL pictures on the Json.

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

We highly recommend not to use slow servers to host your pictures since this can lead to disadvantages when listing.
You can also add or change pictures to your item later on, please read more about this topic to know which kind of pictures are allowed and how to work with them on our Working with pictures guide.

Category & attributes

Sellers must define a category in MercadoLibre site. This attribute is mandatory and only accepts pre-established ids. To get the details see our Categories guide.

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

 

Price

Price is mandatory, if you’re open to negotiate the price for rent or sale with other users you can set it as to be agreed.

Currency

If you set a price you need to define it using a pre-established id. You’ll find available currency ids calling the category where you want to list your item. Learn how by following our category guide.

Seller Custom Field

The seller custom field is not mandatory but is very useful since there aren’t any pre-established values and you can send anything as a String. Most sellers use this field to associate their own SKUs to their products, to identify the product sold on the order.
Example:

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

Listing types

This is another case of a mandatory attribute that only accepts pre-defined values and is very important for you to understand about it.
There are different listing types available for each site. You should make a mixed call through sites and listing_types resources to know which listing_types are supported. Follow our guide to know which listing type will suite your service best.

List a service item

You’re ready to list your first classified item. Notice you’ll need an access_token to make it. If you have questions regarding how to get your access token, please go back to the Getting Started tutorial. In addition, we highly recommended you validate the Json you’re sending before making a POST, so you better check out this really easy and quick item validation tutorial.
You can create a Json for your item basing on the following example, or just send it and you’ll be listing a sample service on the site:

curl -X POST ‘{
    "site_id": "MLA",
    "title": "Alquiler De Luces Y Sonido Efectos Maquina De Humo Fiestas",
    "category_id": "MLA43985",
    "price": 100,
    "currency_id": "ARS",
    "available_quantity": 1,
    "buying_mode": "classified",
    "listing_type_id": "gold_premium",
    "pictures": [],
    "video_id": null,
    "accepts_mercadopago": false,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "profile_id": null,
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null
    },
    "seller_contact": {
        "contact": "",
        "other_info": "",
        "area_code": "",
        "phone": "(01143333423)",
        "area_code2": "",
        "phone2": "",
        "email": "viedusabores@hotmail.com",
        "webpage": ""
    },
    "location": {
        "address_line": "",
        "zip_code": "",
        "neighborhood": {
            "id": "",
            "name": ""
        },
        "city": {
            "id": "",
            "name": "Flores-Villa Crespo"
        },
        "state": {
            "id": "TUxBUENBUGw3M2E1",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": "",
        "longitude": ""
    },
    "coverage_areas": [],
    "attributes": [],
    "variations": []
}



Next topic: Sync your listings.

Please rate this

Manage coverage areas

Coverage areas will let users know if the service you’re offering reach the areas they’re about. You must send each area with pre-established ids you’ll find in our API.

Contents:

Coverage areas by site

To know the ids belonging to areas around your country make a mixed call between sites and add coverage areas resources.

Example:

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

Response:

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

Coverage area Id

Get the details about an specific area.

Example:

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

Response:

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

Add coverage area

To add coverage areas to an existing listing just make a PUT to items API with the following Json.

Example:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
coverage_areas: ["TUxBUExBWmEyNzY0","TUxBUEpVSnk3YmUz"]
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN



Next topic: Start listing your services.

Please rate this

Choose service type

Overview

Categories are a hierarchical set of groups in which items of a similar nature are listed, called “Category Tree”. Categories help buyers find the kind of items they want, as the buyer only needs to look into one or few categories to find items they are interested in. Sellers benefit from the use of categories by the increasing chances of selling due to better and faster access to items by buyers.
Each site has its own set of categories, which means that Argentina will have a unique set of categories, different from the ones in Brazil.
Before listing an item, you need to go through the category structure and choose the one in which you want to list. To help you make it, you can download the complete category hierarchy with ID and human-friendly names from our API.

Contents:

  • Categories by Site
  • Categories Json
  • Category Dump
  • Choosing a category
  • Search by Category
  • Paging & sizing results

Categories by Site

The Sites resource can give you the category structure for a particular country, in this case Argentina.

Example:

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

Response:

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

For a second level categories, or information related to specific categories, you have to use the Categories resource, sending the category Id as a URL parameter.
The next example shows the “Servicios” category:

Example:

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

Response:

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

 

As you can see, you get the “path_from_root” and children_categories attributes. Use these attributes to browse through the category tree and find the specific category for your item.

Categories JSON

Making a call to a particular category will let you know specific information and description that belongs to it. Following you’ll find the description of some of these attributes.

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

 

Name

This attribute shows a human-friendly label. You cannot use this label to search items. If you are interested in searching using categories ids, you can use the following request:

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

See more on search items by category article.

Path from root

When you are in a category you can know the path from root to the category selected.
Take a look how MercadoLibre uses this path to show the item’s category:

Screenshot_7

Finding the best category for your item

A leaf category is the last category on the tree and those are the only categories where you can post items.
Choosing the right category for your item will determine how quickly buyers will find your item and will improve your chances of selling it. For this reason, we highly recommend to use our Category predictor tool before listing an item.

Maybe some categories won’t have a good suggestions, so you’ll have to make the user of your system to map manually the categories for his products. The simplest process could be to use the Category API and navigate the category tree to detect the best option. You must use only those categories retrieved from the API which don’t have subcategories related.

Another option could be to find similar items in MercadoLibre and use their category.



Next topic: Manage coverage areas.

Please rate this

Manage users

Overview

If you registered your application, got authenticated and created a Test user successfully, the next step is to learn how to work with users (sellers and buyers).

Contents:

  • Get my personal data
  • Get data from other users
  • Get the user ID
  • Get public information
  • Get private information
  • Common error codes
  • Update user’s information
  • Common error codes

Get my personal data

If you are logged in MercadoLibre and have a token, you will be able to make the call below and learn about your user-related information:

Example:

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

Response:

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

Get data from other users

If you want to query third-party user data, you will be able to identify two information levels: public data, which you can find navigating the MercadoLibre profile of any other user, e.g.: http://perfil.mercadolibre.com.ar/TETE2870021, and private data, which will be hidden unless you have user permission and a valid token to work on his/her behalf.
In both cases, first you need to know the user ID.

How to get a user’s ID?

If you do not have the ID but you know the user’s nickname and the site he/she belongs to, you will be able to get their ID using the following search:

Call:

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

Example:

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

Response:

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

Get a user’s public information

Now, as you already know the user ID, you can make a call to the users’ resource as shown below in order to get the public information of the user you want:

Call:

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

Example:

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

Response:

{
  "id": 205159033,
  "nickname": "TETE4358231",
  "registration_date": "2016-02-04T13:49:09.000-04:00",
  "country_id": "AR",
  "address": {
	"state": "AR-C",
	"city": "Palermo"
  },
  "user_type": "car_dealer",
  "tags": [
	"car_dealer",
	"test_user",
	"user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE4358231",
  "seller_reputation": {
	"level_id": null,
	"power_seller_status": null,
	"transactions": {
  	"period": "historic",
  	"total": 0,
  	"completed": 0,
  	"canceled": 0,
  	"ratings": {
    	"positive": 0,
    	"negative": 0,
    	"neutral": 0
  	}
	}
  },
  "buyer_reputation": {
	"tags": [
	]
  },
  "status": {
	"site_status": "active"
  }
}

Get private information of a user who accepted the use of my application

In order to get a user’s private data, you just need to know the user’s ACCESS_TOKEN at the end of the call that you made before.

Call:

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

Example:

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

Response:

{
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "first_name": "Test",
  "last_name": "Test",
  "country_id": "AR",
  "email": "test_user_50698062@testuser.com",
  "identification": {
	"type": "DNI",
	"number": "1111111"
  },
  "address": {
	"state": "AR-C",
	"city": "Palermo",
	"address": "Test Address 123",
	"zip_code": "1414"
  },
  "phone": {
	"area_code": "01",
	"number": "1111-1111",
	"extension": "",
	"verified": false
  },
  "alternative_phone": {
	"area_code": "",
	"number": "",
	"extension": ""
  },
  "user_type": "real_estate_agency",
  "tags": [
	"real_estate_agency",
	"test_user",
	"user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
  "shipping_modes": [
	"custom",
	"not_specified"
  ],
  "seller_experience": "ADVANCED",
  "seller_reputation": {
	"level_id": null,
	"power_seller_status": null,
	"transactions": {
  	"period": "historic",
  	"total": 0,
  	"completed": 0,
  	"canceled": 0,
  	"ratings": {
    	"positive": 0,
    	"negative": 0,
    	"neutral": 0
  	}
	}
  },
  "buyer_reputation": {
	"canceled_transactions": 0,
	"transactions": {
  	"period": "historic",
  	"total": null,
  	"completed": null,
  	"canceled": {
    	"total": null,
    	"paid": null
  	},
  	"unrated": {
    	"total": null,
    	"paid": null
  	},
  	"not_yet_rated": {
    	"total": null,
    	"paid": null,
    	"units": null
  	}
	},
	"tags": [
	]
  },
  "status": {
	"site_status": "active",
	"list": {
  	"allow": true,
  	"codes": [
  	],
  	"immediate_payment": {
    	"required": false,
    	"reasons": [
    	]
  	}
	},
	"buy": {
  	"allow": true,
  	"codes": [
  	],
  	"immediate_payment": {
    	"required": false,
    	"reasons": [
    	]
  	}
	},
	"sell": {
	  "allow": true,
  	"codes": [
  	],
  	"immediate_payment": {
    	"required": false,
    	"reasons": [
    	]
  	}
	},
	"billing": {
  	"allow": true,
  	"codes": [
  	]
	},
	"mercadopago_tc_accepted": true,
	"mercadopago_account_type": "personal",
	"mercadoenvios": "not_accepted",
	"immediate_payment": false,
	"confirmed_email": false,
	"user_type": "eventual",
	"required_action": ""
  },
  "credit": {
	"consumed": 100,
	"credit_level_id": "MLA1"
  }
}

As you can see, this time you got more information about the user: full name, e-mail, telephone, address, etc. Please do not disclose this data since it may jeopardize the user.

Update user’s information

You can use our resources to update your user information after registration. This is a common issue, since at this instance you’re not asked to fill your address or personal identification, but you need to have them filled or you’ll be unable to list items on MercadoLibre.
To update your user information, follow the example:

Example:

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

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

Congratulations, you’ve updated your user Information. Remember to only send the fields you want to update.

Common error codes

206 – Partial content: in some cases Users API resource will return a 206 – Partial Content code. This is going to happen when the request to some of the data fails (for example, user reputation), to make you aware that you’re getting an incomplete response.

Please rate this

Services Guide

Services are classified listings where providers’ contact data is public, which makes direct contact between users and service providers easier; and payment and engagement conditions are agreed between the parties.


You can create applications to list services and take contact metrics, search services by geolocation, compare prices and features, send reminders, suggest similar listings, etc.




Next topic: Follow our authentication guide to start working with our API.

Please rate this