Category

Retrieves the information about a MercadoLibres category.

collapse allexpand all

{
  "id": "MLA5725",
  "name": "Accesorios para Vehículos",
  "picture": "http://resources.mlstatic.com/category/images/6fc20d84-2ce6-44ee-8e7e-e5479a78eab0.png",
  "permalink": "http://home.mercadolibre.com.ar/vehiculos-accesorios/",
  "total_items_in_this_category": 2655539,
  "path_from_root": [
    {
      "id": "MLA5725",
      "name": "Accesorios para Vehículos"
    }
  ],
  "children_categories": [
    {
      "id": "MLA4711",
      "name": "Acc. para Motos y Cuatriciclos",
      "total_items_in_this_category": 111635
    },
    {
      "id": "MLA6520",
      "name": "Accesorios de Auto y Camioneta",
      "total_items_in_this_category": 152971
    },
    {
      "id": "MLA6070",
      "name": "Accesorios Náuticos",
      "total_items_in_this_category": 10132
    },
    {
      "id": "MLA86360",
      "name": "Accesorios para Camiones",
      "total_items_in_this_category": 10942
    },
    {
      "id": "MLA3381",
      "name": "Audio para Vehículos",
      "total_items_in_this_category": 39352
    },
    {
      "id": "MLA4610",
      "name": "GNC",
      "total_items_in_this_category": 3365
    },
    {
      "id": "MLA2227",
      "name": "Herramientas",
      "total_items_in_this_category": 16260
    },
    {
      "id": "MLA86838",
      "name": "Limpieza de Vehículos",
      "total_items_in_this_category": 18606
    },
    {
      "id": "MLA6537",
      "name": "Llantas y Tazas",
      "total_items_in_this_category": 27626
    },
    {
      "id": "MLA8531",
      "name": "Navegadores GPS para Vehículos",
      "total_items_in_this_category": 5749
    },
    {
      "id": "MLA400928",
      "name": "Neumáticos",
      "total_items_in_this_category": 86981
    },
    {
      "id": "MLA1747",
      "name": "Repuestos Autos y Camionetas",
      "total_items_in_this_category": 1757903
    },
    {
      "id": "MLA1771",
      "name": "Repuestos para Motos",
      "total_items_in_this_category": 320973
    },
    {
      "id": "MLA86080",
      "name": "Seguridad Vehicular",
      "total_items_in_this_category": 32019
    },
    {
      "id": "MLA377674",
      "name": "Service Programado",
      "total_items_in_this_category": 5135
    },
    {
      "id": "MLA4589",
      "name": "Tuning y Performance",
      "total_items_in_this_category": 46389
    },
    {
      "id": "MLA6177",
      "name": "Otros",
      "total_items_in_this_category": 9514
    }
  ],
  "attribute_types": "none",
  "settings": {
    "adult_content": false,
    "buying_allowed": true,
    "buying_modes": [
      "auction",
      "buy_it_now"
    ],
    "catalog_domain": null,
    "coverage_areas": "not_allowed",
    "currencies": [
      "ARS"
    ],
    "fragile": false,
    "immediate_payment": "required",
    "item_conditions": [
      "used",
      "not_specified",
      "new"
    ],
    "items_reviews_allowed": false,
    "listing_allowed": false,
    "max_description_length": 50000,
    "max_pictures_per_item": 12,
    "max_pictures_per_item_var": 10,
    "max_sub_title_length": 70,
    "max_title_length": 60,
    "maximum_price": null,
    "minimum_price": null,
    "mirror_category": null,
    "mirror_master_category": null,
    "mirror_slave_categories": [
    ],
    "price": "required",
    "reservation_allowed": null,
    "restrictions": [
    ],
    "rounded_address": false,
    "seller_contact": "not_allowed",
    "shipping_modes": [
      "not_specified",
      "custom"
    ],
    "shipping_options": [
      "carrier",
      "custom"
    ],
    "shipping_profile": "optional",
    "show_contact_information": false,
    "simple_shipping": "optional",
    "stock": "required",
    "sub_vertical": "vehicle_parts_accessories",
    "subscribable": null,
    "tags": [
    ],
    "vertical": "vehicle_parts_accessories",
    "vip_subdomain": "articulo"
  },
  "meta_categ_id": null,
  "attributable": false
}
Allowed methods
Retrieves information of a category and its configuration.
GET
/categories/:id
Attributes
attribute_types
Possible values: variations|attributes|none
children_categories
List of subcategories that depends on this category
id
ID
name
Name of the category
path_from_root
Path of categories from this level up to the root category
permalink
PermaLink
picture
Category picture url
settings
Configuration for this category.
Attributes
adult_content
Indicate if this category contains adult content
buying_allowed
Indicate if it is posible to buy an item that belongs to this category
buying_modes
Buying modes allowed in this category
Attributes
auction
Auction
buy_it_now
Buy it now
classified
Classified
coverage_areas
Indicates if it is posible to set coverage areas for the items that belong to this category
Attributes
not_allowed
Not allowed
optional
Optional
immediate_payment
Indicates if online payment is mandatory for the items that belong to this category
item_conditions
Item conditions allowed for items that belongs to this category
Attributes
new
New
not_especified
Not especified
used
Used
item_reviews_allowed
Indicates if reviews can be made for items that belong to this category
listing_allowed
Indicates if items can be listed in this category
max_pictures_per_item
Maximum number of pictures that can have an item listed in this category
max_pictures_per_item_var
Maximum number of pictures per variation that can have an item listed in this category. This setting overrides max_pictures_per_item
mirror_category
Indicates if there is a mirror category for this category
mirror_master_category
Indicates which is the mirror master category of this mirror slave category. Mirror categories are equivalent categories, with the same configurations, structure and items. Mirror master categories are the ones that receive changes in their configurations.
mirror_slave_categories
Indicates which are the mirror slave categories of this mirror master category. Mirror categories are equivalent categories, with the same configurations, structure and items. Mirror slave categories are copies of a mirror master category in other category trees.
price
Indicates if price is mandatory for the items that belong to this category
Attributes
optional
Optional
required
Requered
seller_contact
Indicates if seller contact information is mandatory for the items that belong to this category
Attributes
now_allowed
Not allowed
optional
Optional
required
Required
shipping_modes
Shipping modes available for items that belong to this category
Attributes
carrier
me2
custom
not_especified
shipping_options
Shipping options available for items that belong to this category
Attributes
carrier
Set by carrier
custom
Set by seller
shipping_profile
Indicates if items that belong to this category have a shipping profile associated
Attributes
now_allowed
Not allowed
optional
Optional
show_contact_information
Indicates if seller contact information must be shown for items that belong to this category
simple_shipping
Indicates if the seller can add shipping information for posible locations
Attributes
now_allowed
Not allowed
optional
Optional
stock
Indicates if items that belong to this category can handle stock
Attributes
optional
Optional
required
Required
tags
Tags for this category
vip_subdomain
Subdomain for this category
total_items_in_this_category
Number of active items listed in this category or in one of his subcategories
Related resources
attributes
categories
shipping