Items

Retrieves the information of a listed item.

collapse allexpand all

{
  "id": "MLB833452456",
  "site_id": "MLB",
  "title": "Farol Corsa Mascara Negra 2002 2001 2000 99 98 97 96 95 94",
  "subtitle": null,
  "seller_id": 181764571,
  "category_id": "MLB7863",
  "official_store_id": 1370,
  "price": 79,
  "base_price": 79,
  "original_price": null,
  "currency_id": "BRL",
  "initial_quantity": 2286,
  "available_quantity": 1000,
  "sold_quantity": 250,
  "sale_terms": [
  ],
  "buying_mode": "buy_it_now",
  "listing_type_id": "gold_pro",
  "start_time": "2017-01-25T14:37:12.000Z",
  "stop_time": "2037-01-20T14:37:12.000Z",
  "condition": "new",
  "permalink": "https://produto.mercadolivre.com.br/MLB-833452456-farol-corsa-mascara-negra-2002-2001-2000-99-98-97-96-95-94-_JM",
  "thumbnail": "http://mlb-s1-p.mlstatic.com/697040-MLB28511853503_102018-I.jpg",
  "secure_thumbnail": "https://mlb-s1-p.mlstatic.com/697040-MLB28511853503_102018-I.jpg",
  "pictures": [
    {
      "id": "785295-MLB28511853504_102018",
      "url": "http://mlb-s1-p.mlstatic.com/785295-MLB28511853504_102018-O.jpg",
      "secure_url": "https://mlb-s1-p.mlstatic.com/785295-MLB28511853504_102018-O.jpg",
      "size": "500x500",
      "max_size": "1200x1200",
      "quality": ""
    },
    {
      "id": "941600-MLB28511853505_102018",
      "url": "http://mlb-s1-p.mlstatic.com/941600-MLB28511853505_102018-O.jpg",
      "secure_url": "https://mlb-s1-p.mlstatic.com/941600-MLB28511853505_102018-O.jpg",
      "size": "500x500",
      "max_size": "1200x1200",
      "quality": ""
    },
    {
      "id": "602377-MLB28511853502_102018",
      "url": "http://mlb-s1-p.mlstatic.com/602377-MLB28511853502_102018-O.jpg",
      "secure_url": "https://mlb-s1-p.mlstatic.com/602377-MLB28511853502_102018-O.jpg",
      "size": "500x500",
      "max_size": "1200x1200",
      "quality": ""
    },
    {
      "id": "903082-MLB28511853506_102018",
      "url": "http://mlb-s1-p.mlstatic.com/903082-MLB28511853506_102018-O.jpg",
      "secure_url": "https://mlb-s1-p.mlstatic.com/903082-MLB28511853506_102018-O.jpg",
      "size": "500x500",
      "max_size": "1200x1200",
      "quality": ""
    },
    {
      "id": "635692-MLB28511851000_102018",
      "url": "http://mlb-s1-p.mlstatic.com/635692-MLB28511851000_102018-O.jpg",
      "secure_url": "https://mlb-s1-p.mlstatic.com/635692-MLB28511851000_102018-O.jpg",
      "size": "500x500",
      "max_size": "1200x1200",
      "quality": ""
    },
    {
      "id": "697040-MLB28511853503_102018",
      "url": "http://mlb-s1-p.mlstatic.com/697040-MLB28511853503_102018-O.jpg",
      "secure_url": "https://mlb-s1-p.mlstatic.com/697040-MLB28511853503_102018-O.jpg",
      "size": "500x500",
      "max_size": "1200x1200",
      "quality": ""
    },
    {
      "id": "969685-MLB28511853507_102018",
      "url": "http://mlb-s1-p.mlstatic.com/969685-MLB28511853507_102018-O.jpg",
      "secure_url": "https://mlb-s1-p.mlstatic.com/969685-MLB28511853507_102018-O.jpg",
      "size": "500x500",
      "max_size": "1200x1200",
      "quality": ""
    },
    {
      "id": "947833-MLB28511851001_102018",
      "url": "http://mlb-s1-p.mlstatic.com/947833-MLB28511851001_102018-O.jpg",
      "secure_url": "https://mlb-s1-p.mlstatic.com/947833-MLB28511851001_102018-O.jpg",
      "size": "500x500",
      "max_size": "1200x1200",
      "quality": ""
    }
  ],
  "video_id": null,
  "descriptions": [
    {
      "id": "MLB833452456-1262525212"
    }
  ],
  "accepts_mercadopago": true,
  "non_mercado_pago_payment_methods": [
  ],
  "shipping": {
    "mode": "me2",
    "methods": [
    ],
    "tags": [
    ],
    "dimensions": "25x47x31,2640",
    "local_pick_up": false,
    "free_shipping": false,
    "logistic_type": "cross_docking",
    "store_pick_up": false
  },
  "international_delivery_mode": "none",
  "seller_address": {
    "comment": "",
    "address_line": "",
    "zip_code": "",
    "city": {
      "id": "QlItU1BBcnVqw6E",
      "name": "Arujá"
    },
    "state": {
      "id": "BR-SP",
      "name": "São Paulo"
    },
    "country": {
      "id": "BR",
      "name": "Brasil"
    },
    "search_location": {
      "neighborhood": {
        "id": "",
        "name": ""
      },
      "city": {
        "id": "TVhYQXJ1asOhVFV4Q1VGTkJUMDg1TjJFNA",
        "name": "Arujá"
      },
      "state": {
        "id": "TUxCUFNBT085N2E4",
        "name": "São Paulo"
      }
    },
    "latitude": -23.468035,
    "longitude": -46.302795,
    "id": 160914085
  },
  "seller_contact": null,
  "location": {
  },
  "geolocation": {
    "latitude": -23.468035,
    "longitude": -46.302795
  },
  "coverage_areas": [
  ],
  "attributes": [
    {
      "id": "BRAND",
      "name": "Marca",
      "value_id": null,
      "value_name": "AUTOMOTIVE IMPORTS",
      "value_struct": null,
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Outros"
    },
    {
      "id": "BULB_INCLUDED",
      "name": "Inclui lâmpadas",
      "value_id": "242084",
      "value_name": "Não",
      "value_struct": null,
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Outros"
    },
    {
      "id": "BULB_SIZE",
      "name": "Modelo de lâmpadas",
      "value_id": "351194",
      "value_name": "H4",
      "value_struct": null,
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Outros"
    },
    {
      "id": "HEADLIGHT_LENS_MATERIAL",
      "name": "Material da lente",
      "value_id": "373691",
      "value_name": "Vidro",
      "value_struct": null,
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Outros"
    },
    {
      "id": "INCLUDES_LED_LIGHT",
      "name": "Inclui luzes LED",
      "value_id": "242084",
      "value_name": "Não",
      "value_struct": null,
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Outros"
    },
    {
      "id": "ITEM_CONDITION",
      "name": "Condição do item",
      "value_id": "2230284",
      "value_name": "Novo",
      "value_struct": null,
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Outros"
    },
    {
      "id": "ORIGIN",
      "name": "Origem",
      "value_id": null,
      "value_name": "IMPORTADO",
      "value_struct": null,
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Outros"
    },
    {
      "id": "PARKING_LIGHTS_INCLUDED",
      "name": "Com luz de posição",
      "value_id": "242085",
      "value_name": "Sim",
      "value_struct": null,
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Outros"
    },
    {
      "id": "PART_NUMBER",
      "name": "Número de peça",
      "value_id": null,
      "value_name": "ZN14142160/ 
ZN14142161",
      "value_struct": null,
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Outros"
    },
    {
      "id": "TERMINATION",
      "name": "Terminação",
      "value_id": null,
      "value_name": "IMPORTADO",
      "value_struct": null,
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Outros"
    }
  ],
  "warnings": [
  ],
  "listing_source": "",
  "variations": [
    {
      "id": 16727872730,
      "price": 79,
      "attribute_combinations": [
        {
          "id": "SIDE_POSITION",
          "name": "Lado",
          "value_id": "364128",
          "value_name": "Esquerdo",
          "value_struct": null
        }
      ],
      "available_quantity": 500,
      "sold_quantity": 150,
      "sale_terms": [
      ],
      "picture_ids": [
        "697040-MLB28511853503_102018",
        "969685-MLB28511853507_102018",
        "903082-MLB28511853506_102018",
        "785295-MLB28511853504_102018"
      ],
      "seller_custom_field": "ZN14142161",
      "catalog_product_id": null
    },
    {
      "id": 16727872735,
      "price": 79,
      "attribute_combinations": [
        {
          "id": "SIDE_POSITION",
          "name": "Lado",
          "value_id": "364127",
          "value_name": "Direito",
          "value_struct": null
        }
      ],
      "available_quantity": 500,
      "sold_quantity": 100,
      "sale_terms": [
      ],
      "picture_ids": [
        "635692-MLB28511851000_102018",
        "947833-MLB28511851001_102018",
        "941600-MLB28511853505_102018",
        "602377-MLB28511853502_102018"
      ],
      "seller_custom_field": "ZN14142160",
      "catalog_product_id": null
    }
  ],
  "status": "active",
  "sub_status": [
  ],
  "tags": [
    "good_quality_picture",
    "good_quality_thumbnail",
    "loyalty_discount_eligible",
    "brand_verified",
    "dragged_bids_and_visits",
    "immediate_payment",
    "cart_eligible"
  ],
  "warranty": "90 dias",
  "catalog_product_id": null,
  "domain_id": "MLB-CAR_HEADLIGHTS",
  "parent_item_id": "MLB684273944",
  "differential_pricing": null,
  "deal_ids": [
  ],
  "automatic_relist": false,
  "date_created": "2017-01-25T14:37:13.000Z",
  "last_updated": "2018-12-10T15:02:07.217Z",
  "health": 0.75
}
Allowed methods
Retrieves the information of an item
GET
/items/:id
Retrieves the information of a list of items
GET
/items?ids=:ids
List a new item. Check http://developers.mercadolibre.com/listing-introduction
POST
/items
Validate an item before posting. Check http://developers.mercadolibre.com/validate-item
POST
/items/validate
Update an item. Check http://developers.mercadolibre.com/update-item
PUT
/items/:id
Retrieves the shipping information
GET
/items/:id/shipping/search
Add a picture to the item. Check http://developers.mercadolibre.com/add-pictures-item
POST
/items/:id/pictures
Remove a picture ID from the item
DELETE
/items/:id/pictures/:id
Perform an upgrade of the listing type
POST
/items/:id/listing_type
Retrieves item descriptions and revisions
GET
/items/:id/descriptions
Add a description. Check http://developers.mercadolibre.com/add-description-item
POST
/items/:id/descriptions
Update a description ID
PUT
/items/:id/descriptions/:description_id
Get variations of an item
GET
/items/:id/variations
Add a variation
POST
/items/:id/variations
Get a specific variation of the item
GET
/items/:id/variations/:variation_id
Update the variation
PUT
/items/:id/variations/:variation_id
Delete a variation
DELETE
/items/:id/variations/:variation_id
Retrieves all the available listing types upgrades for the item
GET
/items/:id/available_upgrades
Relist an item. Check http://developers.mercadolibre.com/relist-item
POST
/items/:id/relist
Attributes
accepts_mercadopago
Indicates if the buyer can pay the item through MercadoPago
attributes
Item specifics attributes
Attributes
attribute_group_id
Group ID where the attribute belongs
attribute_group_name
Group name where the attribute belongs
id
Attribute ID
name
Name
value_id
Value ID
value_name
Value
automatic_relist
Indicates if the item can be automatic relist
available_quantity
Indicates the current stock the seller has available for sale in the listing
base_price
The base price of the item. Apply only to auctions
buying_mode
The buying mode of the listing the seller wants to use
Attributes
auction
Auction
buy_it_now
Buy it now (Fixed price)
classified
Classified (Motors, Real Estate, Services)
catalog_product_id
Catalog product ID linked to the item
category_id
The category ID where the item was listed
condition
Items condition
Attributes
new
New
not_specified
Not specified by seller
used
Used
coverage_areas
Coverage area where the seller provides the service. Applies only to services classifieds
currency_id
Currency ID in which the monetary amount is specified
date_created
Date the item was created
deal_ids
List of deal IDs of the item
descriptions
List of sellers description and revisions
Attributes
id
Description ID
differential_pricing
Specifies the items differential pricing
Attributes
id
Differential pricing ID
installments
Number of installments accepted by the differential price
payment_methods
Payment methods accepted by the differential price
domain_id
Domain ID the item belongs to
end_time
When the listing is scheduled to end
expiration_time
When the listing is scheduled to expire due to inactivity.
fee
Specifies item listing fee in local currency
geolocation
Geographic location of the item
Attributes
latitude
Latitude coordinate
longitude
Longitude coordinate
id
ID
initial_quantity
Indicates the stock available when the item was listed
international_delivery_mode
Items international delivery mode
Attributes
ddp
Delivered Duty Paid
ddu
Delivered Duty Unpaid
none
None
inventory_id
Fulfillment by meli inventory id
last_updated
Date the item was updated
listing_source
Indicates the item listing source
listing_type_id
The listing type ID reflects the exposure of the item
Attributes
bronze
Bronze
free
Free
gold
Gold
gold_premium
Gold Premium
silver
Silver
location
Item location details. Currently only applies to classified items
Attributes
address_line
Address line
city
City
Attributes
id
ID
name
Name
country
Country
Attributes
id
ID
name
Name
neighborhood
Neighborhood
Attributes
id
ID
name
Name
state
State
Attributes
id
ID
name
Name
zip_code
Zip code
non_mercado_pago_payment_methods
Other off-platform payment methods the seller accept
Attributes
description
Payment method description
id
Payment method ID
type
Payment method type
official_store_id
The official store id of the seller
original_price
The original price of the item. It will show when its bigger than the price
parent_item_id
Parent item ID of relisted item
permalink
The permanent link to the view item page
pictures
The list of pictures associated with the item
Attributes
id
Picture ID
max_size
Maximum size without losing quality in width x heigth (pixels)
secure_url
SSL URL of the mid-size version
size
Size expressed in width x heigth (pixels)
url
URL of the mid-size version
price
The current price
sale_terms
Item specifics sale terms
Attributes
id
Sale Term ID
name
Name
value_id
Value ID
value_name
Value
secure_thumbnail
SSL gallery version of the primary picture
seller_address
Seller address details
Attributes
address_line
Address line
city
City
Attributes
id
ID
name
Name
comment
Additional comment
country
Country
Attributes
id
ID
name
Name
id
Address ID
state
State
Attributes
id
ID
name
Name
zip_code
Zip code
seller_contact
Contact information for sellers. The data will be available only with the proper permissions
Attributes
area_code1
Are code of the primay phone number
area_code2
Are code of the secondary phone number
contact
Contact name
email
E-mail of the seller
other_info
Additional info
phone1
Primary phone number
phone2
Secondary phone number
webpage
Webpage
seller_custom_field
Seller custom field. Reserved for seller internal use
seller_id
The user ID of the seller
shipping
Shipping details
Attributes
dimensions
Package dimensions
free_shipping
Free shipping
local_pick_up
Indicates if the buyer is able to pick up the items himself
logistic_type
Logistic type
methods
Shipping methods
mode
Shipping mode
profile_id
Profile ID
store_pick_up
Indicates if the buyer is able to pick up the item at sellers store
tags
Shipping tags
site_id
The site ID where the item belongs
sold_quantity
The quantity of units already sold
start_time
When the listing is scheduled to active
status
Specifies the listings status
Attributes
active
Active
closed
Closed
inactive
Inactive
not_yet_active
The item is waiting for activation
paused
The item was paused by the seller or other reason
payment_required
Requires the seller pays the listing fee before activation
under_review
The item is being reviewed by MercadoLibre
stop_time
When the listing was actually ended
sub_status
Internal modifiers and/or statuses
Attributes
banned
Banned
deleted
The item was marked as deleted from MyML account
forbidden
Permanent suspended
freezed
Suspended due ToC infringements
held
Temporal suspended
pending_documentation
Suspended until the seller send the documentation
suspended
Suspended due credit policies infringements
waiting_for_patch
Suspended until the seller amends the item
warning
Possible infraction
subtitle
Subtitle
tags
Tags
Attributes
dragged_bids_and_visits
The item inherited bids and visits from the parent
free_relist
The item was relisted free
thumbnail
Gallery version of the primary picture
title
Title
total_listing_fee
Total listing fee in local currency
variations
Variations are multiple similar (but not identical) items in a single fixed-price listing
Attributes
attribute_combinations
Each variation specifies a combination of attributes
Attributes
id
Varying attribute ID
name
Varying attribute name
value_id
Varying attribute value ID
value_name
Varying attribute value name
available_quantity
Variation current stock
id
Variation ID
initial_quantity
Variation initial stock
inventory_id
Fulfillment by meli inventory id
picture_ids
List of picture IDs of the variation
price
Variation price
sale_terms
Variation sale terms
Attributes
id
Sale term ID
name
Sale term name
value_id
Value ID
value_name
Value
seller_custom_field
Seller custom field. Reserved for seller internal use
video_id
YouTube video ID, e.g. ACGL1OlVFuI
warranty
Indicates whether a warranty is offered for the item
Related resources
/sites
/currencies
/users
/categories
/listing_types
/pictures
/descriptions
/catalog_products
/sites/:siteId/attributes/:attributeId