Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Categories & attributes
Look at our webinar on Category Predictor:
Contents
→Categories
→Categories predictor
→Category-specific attributes
→Mandatory attributes
→Top values
→Dump categories
→Search by category
→Paging & sizing results
→Default values
→Limit
→Offset
→Define a range of results
Categories
The Sites resource can give you the category structure for a particular country, in this case Argentina.
Request:
curl -X GET https://api.mercadolibre.com/sites/MLA/categoriesResponse:
[
{
"id": "MLA5725",
"name": "Accesorios para Vehículos"
},
{
"id": "MLA1512",
"name": "Agro"
},
{
"id": "MLA1403",
"name": "Alimentos y Bebidas"
},
{
"id": "MLA1071",
"name": "Animales y Mascotas"
},
{
"id": "MLA1367",
"name": "Antigüedades y Colecciones"
},
{
"id": "MLA1368",
"name": "Arte, Librería y Mercería"
},
{
"id": "MLA1743",
"name": "Autos, Motos y Otros"
},
{
"id": "MLA1384",
"name": "Bebés"
},
{
"id": "MLA1246",
"name": "Belleza y Cuidado Personal"
},
{
"id": "MLA1039",
"name": "Cámaras y Accesorios"
},
{
"id": "MLA1051",
"name": "Celulares y Teléfonos"
},
{
"id": "MLA1648",
"name": "Computación"
},
{
"id": "MLA1144",
"name": "Consolas y Videojuegos"
},
{
"id": "MLA1276",
"name": "Deportes y Fitness"
},
{
"id": "MLA5726",
"name": "Electrodomésticos y Aires Ac."
},
{
"id": "MLA1000",
"name": "Electrónica, Audio y Video"
},
{
"id": "MLA2547",
"name": "Entradas para Eventos"
},
{
"id": "MLA407134",
"name": "Herramientas y Construcción"
},
{
"id": "MLA1574",
"name": "Hogar, Muebles y Jardín"
},
{
"id": "MLA1499",
"name": "Industrias y Oficinas"
},
{
"id": "MLA1459",
"name": "Inmuebles"
},
{
"id": "MLA1182",
"name": "Instrumentos Musicales"
},
{
"id": "MLA3937",
"name": "Joyas y Relojes"
},
{
"id": "MLA1132",
"name": "Juegos y Juguetes"
},
{
"id": "MLA3025",
"name": "Libros, Revistas y Comics"
},
{
"id": "MLA1168",
"name": "Música, Películas y Series"
},
{
"id": "MLA1430",
"name": "Ropa y Accesorios"
},
{
"id": "MLA409431",
"name": "Salud y Equipamiento Médico"
},
{
"id": "MLA1540",
"name": "Servicios"
},
{
"id": "MLA9304",
"name": "Souvenirs, Cotillón y Fiestas"
},
{
"id": "MLA1953",
"name": "Otras categorías"
}
]For second level categories or information related to specific categories, you must use the /categories resource and send the category ID as a parameter. Let's see what we find in category MLA1743 "Auto, Motos y Otros".
Request:
curl -X GET https://api.mercadolibre.com/categories/MLA1743Response:
{
"id": "MLA1743",
"name": "Autos, Motos y Otros",
"picture": "http://resources.mlstatic.com/category/images/e1a43666-ad57-4b8b-b405-f9d04dbbd8fc.png",
"permalink": "http://www.mercadolibre.com.ar/vehiculos/",
"total_items_in_this_category": 176713,
"path_from_root": [
{
"id": "MLA1743",
"name": "Autos, Motos y Otros"
}
],
"children_categories": [
{
"id": "MLA93412",
"name": "Autos Chocados y Averiados",
"total_items_in_this_category": 1406
},
{
"id": "MLA1745",
"name": "Autos de Colección",
"total_items_in_this_category": 2670
},
{
"id": "MLA1744",
"name": "Autos y Camionetas",
"total_items_in_this_category": 104271
},
{
"id": "MLA58254",
"name": "Camiones",
"total_items_in_this_category": 3242
},
{
"id": "MLA51547",
"name": "Colectivos",
"total_items_in_this_category": 555
},
{
"id": "MLA7312",
"name": "Maquinaria Agrícola",
"total_items_in_this_category": 3644
},
{
"id": "MLA405183",
"name": "Maquinaria Vial",
"total_items_in_this_category": 2293
},
{
"id": "MLA80579",
"name": "Motorhomes",
"total_items_in_this_category": 984
},
{
"id": "MLA1763",
"name": "Motos",
"total_items_in_this_category": 38878
},
{
"id": "MLA1785",
"name": "Náutica",
"total_items_in_this_category": 7730
},
{
"id": "MLA1784",
"name": "Planes de Ahorro",
"total_items_in_this_category": 1708
},
{
"id": "MLA93430",
"name": "Semirremolques",
"total_items_in_this_category": 1147
},
{
"id": "MLA1907",
"name": "Otros Vehículos",
"total_items_in_this_category": 8081
}
],
"attribute_types": "none",
"settings": {
"adult_content": false,
"buying_allowed": false,
"buying_modes": [
"classified"
],
"catalog_domain": null,
"coverage_areas": "not_allowed",
"currencies": [
"USD",
"ARS"
],
"fragile": false,
"immediate_payment": "optional",
"item_conditions": [
"used",
"not_specified",
"new"
],
"items_reviews_allowed": false,
"listing_allowed": false,
"max_description_length": 50000,
"max_pictures_per_item": 15,
"max_pictures_per_item_var": 6,
"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": "mandatory",
"restrictions": [],
"rounded_address": false,
"seller_contact": "optional",
"shipping_modes": [
"not_specified",
"custom"
],
"shipping_options": [],
"shipping_profile": "not_allowed",
"show_contact_information": true,
"simple_shipping": "not_allowed",
"stock": "required",
"sub_vertical": null,
"subscribable": false,
"tags": [],
"vertical": "motors",
"vip_subdomain": "vehiculo",
"buyer_protection_programs": [
"delivered",
"undelivered"
],
"status": "enabled"
},
"meta_categ_id": null,
"attributable": false,
"date_created": "2018-04-25T08:12:56.000Z"
}Realiza una llamada a una categoría en particular, encontrarás todos los atributos disponibles y puedes saber si son obligatorios u opcionales para publicar en la categoría. Por ejemplo, para explorar el árbol de categorías debes utilizar “path_from_root” para conocer los niveles anteriores y "children_categories" para los niveles abajo. Realizaremos otra llamada, ahora en la categoría MLA1744, que es la categoría de los automóviles.
Request:
curl -X GET https://api.mercadolibre.com/categories/MLA1744Response:
{
"id": "MLA1744",
"name": "Autos y Camionetas",
"picture": "http://resources.mlstatic.com/category/images/470e5a62-5d07-432a-8f00-6a67b2ffada8.png",
"permalink": null,
"total_items_in_this_category": 104271,
"path_from_root": [
{
"id": "MLA1743",
"name": "Autos, Motos y Otros"
},
{
"id": "MLA1744",
"name": "Autos y Camionetas"
}
],
"children_categories": [
{
"id": "MLA6039",
"name": "Alfa Romeo",
"total_items_in_this_category": 199
},
{
"id": "MLA411489",
"name": "Aro",
"total_items_in_this_category": 11
},
{
"id": "MLA10356",
"name": "Asia",
"total_items_in_this_category": 8
},
{
"id": "MLA420506",
"name": "Aston Martin",
"total_items_in_this_category": 0
},
{
"id": "MLA5782",
"name": "Audi",
"total_items_in_this_category": 3375
},
{
"id": "MLA410981",
"name": "BAIC",
"total_items_in_this_category": 108
},
{
"id": "MLA5783",
"name": "BMW",
"total_items_in_this_category": 2184
},
{
"id": "MLA422397",
"name": "Changan",
"total_items_in_this_category": 58
},
{
"id": "MLA42429",
"name": "Chery",
"total_items_in_this_category": 698
},
{
"id": "MLA3185",
"name": "Chevrolet",
"total_items_in_this_category": 12132
},
{
"id": "MLA4357",
"name": "Chrysler",
"total_items_in_this_category": 186
},
{
"id": "MLA5779",
"name": "Citroën",
"total_items_in_this_category": 3786
},
{
"id": "MLA411740",
"name": "Dacia",
"total_items_in_this_category": 4
},
{
"id": "MLA5680",
"name": "Daewoo",
"total_items_in_this_category": 21
},
{
"id": "MLA6619",
"name": "Daihatsu",
"total_items_in_this_category": 33
},
{
"id": "MLA412008",
"name": "DFSK",
"total_items_in_this_category": 97
},
{
"id": "MLA6671",
"name": "Dodge",
"total_items_in_this_category": 510
},
{
"id": "MLA411856",
"name": "DS",
"total_items_in_this_category": 123
},
{
"id": "MLA97714",
"name": "Ferrari",
"total_items_in_this_category": 23
},
{
"id": "MLA3174",
"name": "Fiat",
"total_items_in_this_category": 11657
},
{
"id": "MLA3180",
"name": "Ford",
"total_items_in_this_category": 9319
},
{
"id": "MLA410982",
"name": "Foton",
"total_items_in_this_category": 67
},
{
"id": "MLA406048",
"name": "Geely",
"total_items_in_this_category": 104
},
{
"id": "MLA413791",
"name": "Great Wall",
"total_items_in_this_category": 43
},
{
"id": "MLA413792",
"name": "Haval",
"total_items_in_this_category": 116
},
{
"id": "MLA5791",
"name": "Honda",
"total_items_in_this_category": 1555
},
{
"id": "MLA8509",
"name": "Hummer",
"total_items_in_this_category": 8
},
{
"id": "MLA5683",
"name": "Hyundai",
"total_items_in_this_category": 788
},
{
"id": "MLA6599",
"name": "Isuzu",
"total_items_in_this_category": 50
},
{
"id": "MLA412827",
"name": "Iveco",
"total_items_in_this_category": 33
},
{
"id": "MLA417839",
"name": "JAC",
"total_items_in_this_category": 61
},
{
"id": "MLA83415",
"name": "Jaguar",
"total_items_in_this_category": 42
},
{
"id": "MLA6600",
"name": "Jeep",
"total_items_in_this_category": 3015
},
{
"id": "MLA7079",
"name": "Kia",
"total_items_in_this_category": 909
},
{
"id": "MLA7219",
"name": "Lada",
"total_items_in_this_category": 8
},
{
"id": "MLA8125",
"name": "Land Rover",
"total_items_in_this_category": 175
},
{
"id": "MLA412093",
"name": "Lexus",
"total_items_in_this_category": 7
},
{
"id": "MLA389337",
"name": "Lifan",
"total_items_in_this_category": 248
},
{
"id": "MLA407429",
"name": "Maserati",
"total_items_in_this_category": 25
},
{
"id": "MLA5681",
"name": "Mazda",
"total_items_in_this_category": 39
},
{
"id": "MLA6038",
"name": "Mercedes Benz",
"total_items_in_this_category": 2717
},
{
"id": "MLA8480",
"name": "Mini",
"total_items_in_this_category": 377
},
{
"id": "MLA5743",
"name": "Mitsubishi",
"total_items_in_this_category": 366
},
{
"id": "MLA6173",
"name": "Nissan",
"total_items_in_this_category": 1525
},
{
"id": "MLA4100",
"name": "Peugeot",
"total_items_in_this_category": 8293
},
{
"id": "MLA8503",
"name": "Porsche",
"total_items_in_this_category": 179
},
{
"id": "MLA411743",
"name": "Proton",
"total_items_in_this_category": 0
},
{
"id": "MLA99993",
"name": "Ram",
"total_items_in_this_category": 461
},
{
"id": "MLA3205",
"name": "Renault",
"total_items_in_this_category": 11829
},
{
"id": "MLA6041",
"name": "Rover",
"total_items_in_this_category": 48
},
{
"id": "MLA411512",
"name": "Saab",
"total_items_in_this_category": 4
},
{
"id": "MLA6109",
"name": "Seat",
"total_items_in_this_category": 58
},
{
"id": "MLA440813",
"name": "Sero Electric",
"total_items_in_this_category": 6
},
{
"id": "MLA413532",
"name": "Shineray",
"total_items_in_this_category": 94
},
{
"id": "MLA106929",
"name": "Smart",
"total_items_in_this_category": 127
},
{
"id": "MLA11927",
"name": "Ssangyong",
"total_items_in_this_category": 23
},
{
"id": "MLA7078",
"name": "Subaru",
"total_items_in_this_category": 121
},
{
"id": "MLA6583",
"name": "Suzuki",
"total_items_in_this_category": 329
},
{
"id": "MLA11807",
"name": "Tata",
"total_items_in_this_category": 8
},
{
"id": "MLA5753",
"name": "Toyota",
"total_items_in_this_category": 5099
},
{
"id": "MLA3196",
"name": "Volkswagen",
"total_items_in_this_category": 19957
},
{
"id": "MLA440812",
"name": "Volt Motors",
"total_items_in_this_category": 0
},
{
"id": "MLA7080",
"name": "Volvo",
"total_items_in_this_category": 179
},
{
"id": "MLA417354",
"name": "Zanella",
"total_items_in_this_category": 4
},
{
"id": "MLA1939",
"name": "Otras Marcas",
"total_items_in_this_category": 313
}
],
"attribute_types": "attributes",
"settings": {
"adult_content": false,
"buying_allowed": false,
"buying_modes": [
"classified"
],
"catalog_domain": "MLA-CARS_AND_VANS",
"coverage_areas": "not_allowed",
"currencies": [
"USD",
"ARS"
],
"fragile": false,
"immediate_payment": "optional",
"item_conditions": [
"used",
"not_specified",
"new"
],
"items_reviews_allowed": false,
"listing_allowed": false,
"max_description_length": 50000,
"max_pictures_per_item": 15,
"max_pictures_per_item_var": 6,
"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": "mandatory",
"restrictions": [],
"rounded_address": false,
"seller_contact": "optional",
"shipping_modes": [
"not_specified",
"custom"
],
"shipping_options": [],
"shipping_profile": "not_allowed",
"show_contact_information": true,
"simple_shipping": "not_allowed",
"stock": "required",
"sub_vertical": "cars",
"subscribable": false,
"tags": [],
"vertical": "motors",
"vip_subdomain": "auto",
"buyer_protection_programs": [
"delivered",
"undelivered"
],
"status": "enabled"
},
"meta_categ_id": null,
"attributable": true,
"date_created": "2018-04-25T08:12:56.000Z"
}Categories predictor
To identify the best category for your post, make a GET request on the /domain_discovery resource from the title provided. In the answer, the first is the one with the highest probability.
Mandatory parameters
site_id: the site where you make the publication.
q: the title of the article to be predicted and must be completely in the language of the site.
Optional parameters
limit: by default, the limit will be 4 with a maximum of 8, so you could define a limit between 1 to 8.
target: it can be composed of core (Product) or classified (Classified) depending on the vertical in which you are publishing.
Request:
curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/domain_discovery/search?q=$QExample:
curl -X GET https://api.mercadolibre.com/sites/MLA/domain_discovery/search?limit=1&q=fiat%20unoResponse:
[
{
"domain_id": "MLA-CARS_AND_VANS",
"domain_name": "Autos y camionetas",
"category_id": "MLA24322",
"category_name": "Uno",
"attributes": []
}
]Response fields
domain_id: ID of the domain you predict for the article.
domain_name: domain name you predict.
category_id: ID of the category you predict for the article.
category_name: name of the category you predict.
attributes: list of attributes for the predicted category.
Category-specific attributes
For the specific attributes and possible values of the categories to publish a car, see the /attributes resource.
Request:
curl -X GET https://api.mercadolibre.com/categories/MLA1744/attributesShort response:
[
{
"id": "BRAND",
"name": "Marca",
"tags": {
"catalog_required": true,
"required": true
},
"hierarchy": "PARENT_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"values": [
...
{
"id": "389168",
"name": "Chery"
},
{
"id": "58955",
"name": "Chevrolet"
},
{
"id": "66395",
"name": "Chrysler"
},
{
"id": "389169",
"name": "Citroën"
},
...
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "MODEL",
"name": "Modelo",
"tags": {
"catalog_required": true,
"required": true
},
"hierarchy": "PARENT_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"values": [
...
{
"id": "389394",
"name": "Aircross"
},
{
"id": "389395",
"name": "Airtrek"
},
{
"id": "71720",
"name": "Albea"
},
{
"id": "60597",
"name": "Alhambra"
},
{
"id": "64101",
"name": "Alliance"
},
...
],
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "VEHICLE_YEAR",
"name": "Año",
"tags": {
"required": true
},
"hierarchy": "PARENT_PK",
"relevance": 1,
"value_type": "number",
"value_max_length": 18,
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
"id": "TRIM",
"name": "Versión",
"tags": {
"catalog_required": true,
"required": true
},
"hierarchy": "PARENT_PK",
"relevance": 1,
"value_type": "string",
"value_max_length": 255,
"attribute_group_id": "FIND",
"attribute_group_name": "Ficha técnica"
},
{
...
}
]Mandatory attributes
The mandatory attributes are configured as “required” in the category detail. In the example above, you can see what price and stock are required. Coverage areas are not allowed and the seller_contact is optional.
Top values
With this resource you will be able to know what are the most used values for a specific attribute of a domain. You can also further search by indicating other attribute values so that only the values that apply to them are listed.
Sellers will be able to use the values obtained to choose the correct one among them and improve the quality of the publications.
Mandatory parameters
domain_id: is the ID of the domain we want to refer to.
attribute_id: is the ID of the attribute for which we need to know the most used values.
Optionals parameters
limit: is the limit of results that is requested has a maximum of 1000.
metric_type: It is the metric by which the results will be ordered, in principle only NOLs are supported (new publications in the last 90 days). The only parameter at the moment is NOL_90. Soon, we will add new criteria. Example: metric_type = NOL_90.
To identify the recommended and known attributes, you must perform a POST.
Simple rrequest with a single attribute
curl -X POST https://api.mercadolibre.com/catalog_domains/$DOMAIN_ID/attributes/$ATTRIBUTE_ID/top_valuesExample:
curl -X POST https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS/attributes/BRAND/top_valuesResponse:<7
[
{
"id": "60249",
"name": "Volkswagen",
"metric": 7987
},
{
"id": "66432",
"name": "Ford",
"metric": 5619
},
{
"id": "9909",
"name": "Renault",
"metric": 4659
},
{
"id": "58955",
"name": "Chevrolet",
"metric": 4319
},
{
"id": "60279",
"name": "Peugeot",
"metric": 4285
},
{
"id": "67781",
"name": "Fiat",
"metric": 4172
},
…
]Example with more than one attribute
Request:
curl -X POST https://api.mercadolibre.com/catalog_domains/$DOMAIN_ID/attributes/$ATTRIBUTE_ID/top_values
{
"known_attributes": [
{
"id": "attributes.id",
"value_id": "attributes.value_id"
}
]
}Example:
curl -X POST https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS/attributes/MODEL/top_values
{
"known_attributes": [
{
"id": "BRAND",
"value_id": "60249"
}
]
}In this case, the content of the response will be the most used models of the 6249 Volkswagen brand.
Dump categories
Remember that we recommend using the category predictor in your development, but if you prefer, you can download the category tree for the country's site for offline processing. This resource returns the category tree in JSON format within a gzip encoded response. To get the Argentina categories, use this URL:
curl -X GET https://api.mercadolibre.com/sites/MLA/allIt contains 2 headers that can be used to check when the last dump was generated.
X-Content-Created [contenido X creado]: contains the date of the last generation.
X-Content-MD5: Contains the latest generation MD5 checksum.
Request:
curl -X GET https://api.mercadolibre.com/sites/MLA/allResponse:
HTTP/2 200
content-type: application/json
content-length: 0
date: Wed, 29 Apr 2020 20:40:14 GMT
x-amz-id-2: VTcFVSUdn06VM4dbsuP5vZyHQ5fycw3kHjUgzRxEzSJxSJfEuYpr9DlHZ6ab+2DPvJ/SD97R7OQ=
x-amz-replication-status: COMPLETED
x-amz-request-id: 8BA998DE0241013D
x-amz-version-id: nhcoZXYi83Rh5CjxRYMmFLRIPO_cz7yl
x-content-type-options: nosniff
x-request-id: 071f0a43-1b95-4b04-accd-77646bd6dc3e
x-frame-options: DENY
x-xss-protection: 1; mode=block
access-control-allow-origin: *
access-control-allow-headers: Content-Type
access-control-allow-methods: PUT, GET, POST, DELETE, OPTIONS
access-control-max-age: 86400
accept-ranges: bytes
last-modified: Wed, 29 Apr 2020 20:01:12 GMT
cache-control: max-age=300
content-encoding: gzip
x-content-created: 2020-04-29T20:01:12.000Z
x-content-md5: 7526ed93467ec227359522beac126d82
x-cache: Miss from cloudfront
via: 1.1 b7b2667a8f791fb60d70bb1835ef9b2b.cloudfront.net (CloudFront)
x-amz-cf-pop: GRU1-C1
x-amz-cf-id: bvgXHVEFMS1BSLQCqEJxXmUL6zMRQQnCHBCCJMg78WUfPLVYGubO8Q==Search by category
The search operation returns publications that belong to a Mercado Libre publication category; While there may be a lot of posts in certain categories, don't worry, you can paginate the results. Read about pagination in search results. To access all the posts in a certain category, you have to do the following:
curl -X GET https://api.mercadolibre.com/MLA/search?category=MLA5726The search response has a large number of parameters. Use the http OPTIONS method to get a JSON-encoded response that will describe the API, with all the methods and connections allowed between another part of the API.
Paging & sizing results
Now you can work with specific sets of results every time you make a call to the resource. Most of the resources have common url parameters to paginate and size limit and offset results.
Default values
The default values are offset=0 and limit=50.
curl -X GET https://api.mercadolibre.com/sites/MLA/search?q=ipod nanoIn the pagination section of the JSON response, you can see the total number of posts matching the search and the offset value with the default limit applied.
.....
"paging": {
"total": 285,
"offset": 0,
"limit": 50,
}
.....Limit
To reduce the page size, you can change the limit parameter. For example, if you are interested in retrieving only the first 3 posts.
Example:
curl -X GET https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&limit=3This action retrieves a JSON data with a set of 3 posts, as in the answer below:
{
"site_id": "MLA",
"query": "ipod nano",
"paging": {
"total": 284,
"offset": 0,
"limit": 3,
},
"results": [
{...},
{...},
{...},
],
"sort": {...},
"available_sorts": [...],
"filters": [...],
"available_filters": [...],
}Offset
By using the offset attribute, you can move the lower limit of the result block. For example, if you are interested in retrieving the 50 posts that follow the default answer.
Example:
curl -X GET https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&offset=50Response:
{
"site_id": "MLA",
"query": "ipod nano",
"paging": {
"total": 285,
"offset": 50,
"limit": 50,
},
"results": [...],
"sort": {...},
"available_sorts": [...],
"filters": [...],
"available_filters": [...],
}Esta respuesta recupera 50 publicaciones a partir de los primeros cincuenta.
Define a range of results
It is possible to combine both parameters. You can retrieve posts from 3rd to 6th in the original search result:
curl -X GET https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&offset=3&limit=3This action retrieves a JSON data with a set of 3 posts, as illustrated below:
{
"site_id": "MLA",
"query": "ipod nano",
"paging": {
"total": 285,
"offset": 3,
"limit": 3,
},
"results": [
{...},
{...},
{...},
],
"sort": {...},
"available_sorts": [...],
"filters": [...],
"available_filters": [...],
}