Users

Returns information about MercadoLibre users. Private attributes are displayed only if the user is authenticated and authorized.

collapse allexpand all

{
  "id": 19628081,
  "nickname": "COMPRA-LIDER-IN-ALL",
  "registration_date": "2007-06-15T12:45:05.000-04:00",
  "country_id": "BR",
  "address": {
    "city": "Recife",
    "state": "BR-PE"
  },
  "user_type": "normal",
  "tags": [
    "normal",
    "eshop"
  ],
  "logo": null,
  "points": 1646,
  "site_id": "MLB",
  "permalink": "http://perfil.mercadolivre.com.br/COMPRA-LIDER-IN-ALL",
  "seller_reputation": {
    "level_id": "5_green",
    "power_seller_status": null,
    "transactions": {
      "canceled": 171,
      "completed": 3295,
      "period": "historic",
      "ratings": {
        "negative": 0.02,
        "neutral": 0.01,
        "positive": 0.97
      },
      "total": 3466
    }
  },
  "buyer_reputation": {
    "tags": [
      ""
    ]
  },
  "status": {
    "site_status": "active"
  }
}
Allowed methods
Returns information about MercadoLibre users. Some attributes are only displayed if the user is logged.
GET
/users/:id
Returns information about MercadoLibre logged user
GET
/users/me/
Returns information from a list of MercadoLibre users.
GET
/users/:ids=id,id...,id
Attributes
buyer_reputation
Reputation as buyer
Attributes
transactions
Purchases made
Attributes
canceled
Purchases canceled
Attributes
paid
Total paid purchases
total
Total purchases
completed
Purchases completed
not_yet_rated
Purchases under rating period
Attributes
paid
Total paid purchases
total
Total purchases
period
Time period taken to evaluate its reputation.
total
Total purchases
unrated
Unrated purchases
Attributes
paid
Total paid purchases
total
Total purchases
country_id
Country ID
credit
User Credit Level
Attributes
consumed
Credit consumed by the user
credit_level_id
Credit level ID
email
User electronic email
first_name
First Name
id
User ID
identification
Personal identification
Attributes
identification_number
Number
identification_type
Type
last_name
Last Name
logo
Real state agency or car dealer logo
nickname
User Nickname
permalink
User URL
personal_information
User personal info
Attributes
address
User address
Attributes
address
address
city
city
state
state
zip_code
zip code
company_establishment_date
Company establishment date
company_main_activity
Company main activity
company_name
Company Name
company_rep
Company agent
Attributes
id
Number
name
Name
company_type
Company type
first_name
First Name
identification
Personal identification
Attributes
identification_number
Number
identification_type
Type
last_name
Last Name
person_birthdate
Person birthdate
person_birthplace
Person birthplace
person_mothers_name
Person mothers name
phone
User Phone
Attributes
area_code
Area code
number
Number
verified
Indicates whether the phone was checked
taxpayer_number
Taxpayer number
phone
User Phone
Attributes
area_code
Area code
number
Number
verified
Indicates whether the phone was checked
points
Points
registration_date
User registration date on site
seller_experience
Experience as seller. It can be:
Attributes
advanced
Advanced
intermediate
Intermediate
newbie
Newbie
seller_reputation
Reputation as seller
Attributes
level_id
Thermometer location as seller. It can be:
Attributes
1_red
Red
2_orange
Orange
3_yellow
Yellow
4_light_green
Light green
5_green
Green
null (null value)
Without level.
metrics
Sales metrics
Attributes
claims
Metric of sales with claims
Attributes
period
Time period taken to evaluate specifically this metric. It can be:
Attributes
3 months
Last 3 months
historic
historic
rate
The rate between received claims and the completed transactions in the period
delayed_handling_time
Metric of sales with delayed handling time
Attributes
period
Time period taken to evaluate specifically this metric. It can be:
Attributes
3 months
Last 3 months
historic
historic
rate
The rate between sales with delayed handling time and sales done with ME in the period
sales
Metric of completed sales
Attributes
completed
Completed sales in the period
period
Time period taken to evaluate specifically this metric. It can be:
Attributes
3 months
Last 3 months
historic
historic
power_seller_status
MercadoLíder Level. It can be:
Attributes
gold
Gold
null (null value)
Without level.
platinum
Platinum
silver
Silver
transactions
Sales made
Attributes
canceled
Sales Cancelled
completed
Completed sales
period
Time period taken to evaluate its reputation. It can be:
Attributes
12 months
Last 12 months
3 months
Last 3 months
historic
historic
ratings
Rated sales
Attributes
negative
Negative ratings percentage
neutral
Neutral ratings percentage
positive
Positive ratings percentage
total
Total sales
site_id
Site ID
status
User status
Attributes
buy
To Buy
Attributes
allow
Indicates whether the user is allowed to buy items
codes
Error Codes. It may be more than one:
Attributes
historical_behaviour
Indicates that the user has an incorrect historical behavior
internal_control
Indicates that the user is under internal control
mercadopago_restrictions
Indicates that the user has a restriction imposed by MercadoPago
immediate_payment
Indicates whether the user has to pay with credit card to buy. It can be:
Attributes
optional
Optional
required
Required
list
To List
Attributes
allow
Specifies whether the user is allowed to post new items
codes
Error Codes. It may be more than one:
Attributes
credit_limit_exeeded
Indicates that the user exceeded his credit limit
feedback_restriction
Indicates that the user is restricted by Feedback
has_debt
Indicates that the user has MercadoLibre debt
historical_behaviour
Indicates that the user has an incorrect historical behavior
internal_control
Indicates that the user is under internal control
mercadopago_restrictions
Indicates that the user has a restriction imposed by MercadoPago
mercadopago_tc_accepted
Indicates if the user accepts the terms and conditions of MercadoPago
sell
To Sell
Attributes
allow
Indicates whether the user is allowed to sell the items that has listed
codes
Error Codes. It may be more than one:
Attributes
credit_limit_exeeded
Indicates that the user exceeded his credit limit
feedback_restriction
Indicates that the user is restricted by Feedback
has_debt
Indicates that the user has MercadoLibre debt
site_status
General status of the user on the site. It can be:
Attributes
active
Active user
deactive
Deactive user
pending
Pending e-mail confirmation
user_type
User type. It can be:
Attributes
branch
Branch
brand
Brand
car_dealer
Car dealer
franchise
Franchise
normal
Normal
real_estate_agency
Real state agency
Related resources
/sites