OLX Brazil Scraper

ENDPOINTS
GET/categories/filters

Category Filters

Get every filter a category supports, with its query keys and allowed values, plus the live ad count.

QUERY PARAMS

Category path, category code or category link.

Examples:

  • Path: autos-e-pecas/carros-vans-e-utilitarios
  • Code: 2020
{
  "category": {
    "code": 2020,
    "name": "Carros, vans e utilitários",
    "path": "autos-e-pecas/carros-vans-e-utilitarios",
    "parent_code": 2000
  },
  "link": "https://www.olx.com.br/autos-e-pecas/carros-vans-e-utilitarios",
  "total_count": 626102,
  "filters": [
    {
      "id": "vehicle_history_switch",
      "name": "vehicle_tags",
      "label": "Histórico Veicular",
      "description": "Informações sobre IPVA, licenciamento e restrições",
      "type": "toggle_switch",
      "query_keys": [
        "vtvh"
      ],
      "values": null,
      "values_link": null
    },
    {
      "id": "condition_report_status",
      "name": "condition_report_status",
      "label": "Vistoriado",
      "description": "Veículos com vistoria cautelar aprovada",
      "type": "toggle_switch",
      "query_keys": [
        "crss"
      ],
      "values": null,
      "values_link": null
    },
    {
      "id": "motorpower",
      "name": "motorpower",
      "label": "Motor",
      "description": null,
      "type": "selection",
      "query_keys": [
        "motp"
      ],
      "values": [
        {
          "value": "1",
          "label": "1.0"
        },
        {
          "value": "2",
          "label": "1.2"
        },
        {
          "value": "3",
          "label": "1.3"
        },
        {
          "value": "4",
          "label": "1.4"
        },
        {
          "value": "5",
          "label": "1.5"
        },
        {
          "value": "6",
          "label": "1.6"
        },
        {
          "value": "7",
          "label": "1.7"
        },
        {
          "value": "8",
          "label": "1.8"
        },
        {
          "value": "9",
          "label": "1.9"
        },
        {
          "value": "10",
          "label": "2.0 - 2.9"
        },
        {
          "value": "11",
          "label": "3.0 - 3.9"
        },
        {
          "value": "12",
          "label": "4.0 ou mais"
        }
      ],
      "values_link": null
    },
    {
      "id": "exchange",
      "name": "exchange",
      "label": "Aceita Trocas",
      "description": null,
      "type": "chips",
      "query_keys": [
        "exc"
      ],
      "values": [
        {
          "value": "1",
          "label": "Sim"
        },
        {
          "value": "2",
          "label": "Não"
        }
      ],
      "values_link": null
    },
    {
      "id": "mileage",
      "name": "mileage",
      "label": "Quilometragem",
      "description": null,
      "type": "selection_range",
      "query_keys": [
        "ms",
        "me"
      ],
      "values": [
        {
          "value": "0",
          "label": "0"
        },
        {
          "value": "5000",
          "label": "5.000"
        },
        {
          "value": "10000",
          "label": "10.000"
        },
        {
          "value": "20000",
          "label": "20.000"
        },
        {
          "value": "30000",
          "label": "30.000"
        },
        {
          "value": "40000",
          "label": "40.000"
        },
        {
          "value": "60000",
          "label": "60.000"
        },
        {
          "value": "80000",
          "label": "80.000"
        },
        {
          "value": "100000",
          "label": "100.000"
        },
        {
          "value": "120000",
          "label": "120.000"
        },
        {
          "value": "140000",
          "label": "140.000"
        },
        {
          "value": "160000",
          "label": "160.000"
        },
        {
          "value": "180000",
          "label": "180.000"
        },
        {
          "value": "200000",
          "label": "200.000"
        },
        {
          "value": "250000",
          "label": "250.000"
        },
        {
          "value": "300000",
          "label": "300.000"
        },
        {
          "value": "400000",
          "label": "400.000"
        },
        {
          "value": "500000",
          "label": "500.000"
        }
      ],
      "values_link": null
    },
    {
      "id": "regdate",
      "name": "regdate",
      "label": "Ano",
      "description": null,
      "type": "regdate",
      "query_keys": [
        "rs",
        "re"
      ],
      "values": [
        {
          "value": "1950",
          "label": "1950 ou anterior"
        },
        {
          "value": "1951",
          "label": "1951"
        },
        {
          "value": "1952",
          "label": "1952"
        },
        {
          "value": "1953",
          "label": "1953"
        },
        {
          "value": "1954",
          "label": "1954"
        },
        {
          "value": "1955",
          "label": "1955"
        },
        {
          "value": "1956",
          "label": "1956"
        },
        {
          "value": "1957",
          "label": "1957"
        },
        {
          "value": "1958",
          "label": "1958"
        },
        {
          "value": "1959",
          "label": "1959"
        },
        {
          "value": "1960",
          "label": "1960"
        },
        {
          "value": "1961",
          "label": "1961"
        },
        {
          "value": "1962",
          "label": "1962"
        },
        {
          "value": "1963",
          "label": "1963"
        },
        {
          "value": "1964",
          "label": "1964"
        },
        {
          "value": "1965",
          "label": "1965"
        },
        {
          "value": "1966",
          "label": "1966"
        },
        {
          "value": "1967",
          "label": "1967"
        },
        {
          "value": "1968",
          "label": "1968"
        },
        {
          "value": "1969",
          "label": "1969"
        },
        {
          "value": "1970",
          "label": "1970"
        },
        {
          "value": "1971",
          "label": "1971"
        },
        {
          "value": "1972",
          "label": "1972"
        },
        {
          "value": "1973",
          "label": "1973"
        },
        {
          "value": "1974",
          "label": "1974"
        },
        {
          "value": "1975",
          "label": "1975"
        },
        {
          "value": "1976",
          "label": "1976"
        },
        {
          "value": "1977",
          "label": "1977"
        },
        {
          "value": "1978",
          "label": "1978"
        },
        {
          "value": "1979",
          "label": "1979"
        },
        {
          "value": "1980",
          "label": "1980"
        },
        {
          "value": "1981",
          "label": "1981"
        },
        {
          "value": "1982",
          "label": "1982"
        },
        {
          "value": "1983",
          "label": "1983"
        },
        {
          "value": "1984",
          "label": "1984"
        },
        {
          "value": "1985",
          "label": "1985"
        },
        {
          "value": "1986",
          "label": "1986"
        },
        {
          "value": "1987",
          "label": "1987"
        },
        {
          "value": "1988",
          "label": "1988"
        },
        {
          "value": "1989",
          "label": "1989"
        },
        {
          "value": "1990",
          "label": "1990"
        },
        {
          "value": "1991",
          "label": "1991"
        },
        {
          "value": "1992",
          "label": "1992"
        },
        {
          "value": "1993",
          "label": "1993"
        },
        {
          "value": "1994",
          "label": "1994"
        },
        {
          "value": "1995",
          "label": "1995"
        },
        {
          "value": "1996",
          "label": "1996"
        },
        {
          "value": "1997",
          "label": "1997"
        },
        {
          "value": "1998",
          "label": "1998"
        },
        {
          "value": "1999",
          "label": "1999"
        },
        {
          "value": "2000",
          "label": "2000"
        },
        {
          "value": "2001",
          "label": "2001"
        },
        {
          "value": "2002",
          "label": "2002"
        },
        {
          "value": "2003",
          "label": "2003"
        },
        {
          "value": "2004",
          "label": "2004"
        },
        {
          "value": "2005",
          "label": "2005"
        },
        {
          "value": "2006",
          "label": "2006"
        },
        {
          "value": "2007",
          "label": "2007"
        },
        {
          "value": "2008",
          "label": "2008"
        },
        {
          "value": "2009",
          "label": "2009"
        },
        {
          "value": "2010",
          "label": "2010"
        },
        {
          "value": "2011",
          "label": "2011"
        },
        {
          "value": "2012",
          "label": "2012"
        },
        {
          "value": "2013",
          "label": "2013"
        },
        {
          "value": "2014",
          "label": "2014"
        },
        {
          "value": "2015",
          "label": "2015"
        },
        {
          "value": "2016",
          "label": "2016"
        },
        {
          "value": "2017",
          "label": "2017"
        },
        {
          "value": "2018",
          "label": "2018"
        },
        {
          "value": "2019",
          "label": "2019"
        },
        {
          "value": "2020",
          "label": "2020"
        },
        {
          "value": "2021",
          "label": "2021"
        },
        {
          "value": "2022",
          "label": "2022"
        },
        {
          "value": "2023",
          "label": "2023"
        },
        {
          "value": "2024",
          "label": "2024"
        },
        {
          "value": "2025",
          "label": "2025"
        },
        {
          "value": "2026",
          "label": "2026"
        },
        {
          "value": "2027",
          "label": "2027"
        }
      ],
      "values_link": null
    },
    {
      "id": "price_text",
      "name": "price",
      "label": "Preço",
      "description": null,
      "type": "integer_range",
      "query_keys": [
        "ps",
        "pe"
      ],
      "values": null,
      "values_link": null
    },
    {
      "id": "fipe_price_discount_level",
      "name": "fipe_price_discount_level",
      "label": "Ofertas abaixo da FIPE",
      "description": "Veículos que estão abaixo da tabela FIPE",
      "type": "toggle_switch",
      "query_keys": [
        "fpdll"
      ],
      "values": null,
      "values_link": null
    },
    {
      "id": "gearbox",
      "name": "gearbox",
      "label": "Câmbio",
      "description": null,
      "type": "checkbox",
      "query_keys": [
        "gb"
      ],
      "values": [
        {
          "value": "1",
          "label": "Manual"
        },
        {
          "value": "2",
          "label": "Automático"
        },
        {
          "value": "3",
          "label": "Semi-Automático"
        },
        {
          "value": "4",
          "label": "Automatizado"
        }
      ],
      "values_link": null
    },
    {
      "id": "end_tag",
      "name": "end_tag",
      "label": "Final de placa",
      "description": null,
      "type": "checkbox",
      "query_keys": [
        "et"
      ],
      "values": [
        {
          "value": "1",
          "label": "0"
        },
        {
          "value": "2",
          "label": "1"
        },
        {
          "value": "3",
          "label": "2"
        },
        {
          "value": "4",
          "label": "3"
        },
        {
          "value": "5",
          "label": "4"
        },
        {
          "value": "6",
          "label": "5"
        },
        {
          "value": "7",
          "label": "6"
        },
        {
          "value": "8",
          "label": "7"
        },
        {
          "value": "9",
          "label": "8"
        },
        {
          "value": "10",
          "label": "9"
        }
      ],
      "values_link": null
    },
    {
      "id": "indexed_car_steering",
      "name": "indexed_car_steering",
      "label": "Direção",
      "description": null,
      "type": "checkbox",
      "query_keys": [
        "ics"
      ],
      "values": [
        {
          "value": "1",
          "label": "Hidráulica"
        },
        {
          "value": "2",
          "label": "Elétrica"
        },
        {
          "value": "3",
          "label": "Mecânica"
        },
        {
          "value": "5",
          "label": "Eletro-hidráulica"
        }
      ],
      "values_link": null
    },
    {
      "id": "fuel",
      "name": "fuel",
      "label": "Combustível",
      "description": null,
      "type": "checkbox",
      "query_keys": [
        "fu"
      ],
      "values": [
        {
          "value": "1",
          "label": "Gasolina"
        },
        {
          "value": "2",
          "label": "Álcool"
        },
        {
          "value": "3",
          "label": "Flex"
        },
        {
          "value": "5",
          "label": "Diesel"
        },
        {
          "value": "6",
          "label": "Híbrido"
        },
        {
          "value": "7",
          "label": "Elétrico"
        }
      ],
      "values_link": null
    },
    {
      "id": "has_gnv_kit",
      "name": "has_gnv_kit",
      "label": "Kit GNV",
      "description": null,
      "type": "checkbox",
      "query_keys": [
        "hgnv"
      ],
      "values": [
        {
          "value": "1",
          "label": "Sim"
        },
        {
          "value": "0",
          "label": "Não"
        }
      ],
      "values_link": null
    },
    {
      "id": "cartype",
      "name": "cartype",
      "label": "Tipo",
      "description": null,
      "type": "checkbox",
      "query_keys": [
        "ctp"
      ],
      "values": [
        {
          "value": "6",
          "label": "Buggy"
        },
        {
          "value": "10",
          "label": "Caminhão Leve"
        },
        {
          "value": "2",
          "label": "Conversível"
        },
        {
          "value": "11",
          "label": "Coupé"
        },
        {
          "value": "9",
          "label": "Hatch"
        },
        {
          "value": "12",
          "label": "Perua"
        },
        {
          "value": "3",
          "label": "Pick-up"
        },
        {
          "value": "8",
          "label": "Sedã"
        },
        {
          "value": "5",
          "label": "SUV"
        },
        {
          "value": "7",
          "label": "Van/Utilitário"
        }
      ],
      "values_link": null
    },
    {
      "id": "carcolor",
      "name": "carcolor",
      "label": "Cor",
      "description": null,
      "type": "checkbox",
      "query_keys": [
        "cac"
      ],
      "values": [
        {
          "value": "7",
          "label": "Amarelo"
        },
        {
          "value": "6",
          "label": "Azul"
        },
        {
          "value": "2",
          "label": "Branco"
        },
        {
          "value": "5",
          "label": "Cinza"
        },
        {
          "value": "9",
          "label": "Laranja"
        },
        {
          "value": "3",
          "label": "Prata"
        },
        {
          "value": "1",
          "label": "Preto"
        },
        {
          "value": "8",
          "label": "Verde"
        },
        {
          "value": "4",
          "label": "Vermelho"
        },
        {
          "value": "10",
          "label": "Outra"
        }
      ],
      "values_link": null
    },
    {
      "id": "doors",
      "name": "doors",
      "label": "Portas",
      "description": null,
      "type": "checkbox",
      "query_keys": [
        "cad"
      ],
      "values": [
        {
          "value": "1",
          "label": "2 portas"
        },
        {
          "value": "2",
          "label": "4 portas"
        },
        {
          "value": "3",
          "label": "3 portas"
        }
      ],
      "values_link": null
    },
    {
      "id": "car_features",
      "name": "car_features",
      "label": "Opcionais",
      "description": null,
      "type": "checkbox",
      "query_keys": [
        "cf"
      ],
      "values": [
        {
          "value": "5",
          "label": "Air bag"
        },
        {
          "value": "1",
          "label": "Ar condicionado"
        },
        {
          "value": "6",
          "label": "Alarme"
        },
        {
          "value": "11",
          "label": "Bancos de couro"
        },
        {
          "value": "10",
          "label": "Blindado"
        },
        {
          "value": "9",
          "label": "Câmera de ré"
        },
        {
          "value": "12",
          "label": "Computador de bordo"
        },
        {
          "value": "13",
          "label": "Conexão USB"
        },
        {
          "value": "17",
          "label": "Controle automático de velocidade"
        },
        {
          "value": "15",
          "label": "Interface bluetooth"
        },
        {
          "value": "16",
          "label": "Navegador GPS"
        },
        {
          "value": "18",
          "label": "Rodas de liga leve"
        },
        {
          "value": "8",
          "label": "Sensor de ré"
        },
        {
          "value": "7",
          "label": "Som"
        },
        {
          "value": "19",
          "label": "Teto solar"
        },
        {
          "value": "20",
          "label": "Tração 4x4"
        },
        {
          "value": "4",
          "label": "Trava elétrica"
        },
        {
          "value": "3",
          "label": "Vidro elétrico"
        },
        {
          "value": "14",
          "label": "Volante multifuncional"
        }
      ],
      "values_link": null
    },
    {
      "id": "indexed_financial_status",
      "name": "indexed_financial_status",
      "label": "Estado financeiro",
      "description": null,
      "type": "selection",
      "query_keys": [
        "fncs"
      ],
      "values": [
        {
          "value": "1",
          "label": "Quitado"
        },
        {
          "value": "2",
          "label": "Financiado"
        }
      ],
      "values_link": null
    },
    {
      "id": "documentation_and_regularization",
      "name": "documentation_and_regularization",
      "label": "Documentação e regularização",
      "description": null,
      "type": "checkbox",
      "query_keys": [
        "doc"
      ],
      "values": [
        {
          "value": "1",
          "label": "IPVA Pago"
        },
        {
          "value": "2",
          "label": "Com multas"
        },
        {
          "value": "3",
          "label": "De leilão"
        }
      ],
      "values_link": null
    },
    {
      "id": "conservation_and_warranty",
      "name": "conservation_and_warranty",
      "label": "Conservação e garantia",
      "description": null,
      "type": "checkbox",
      "query_keys": [
        "cnwa"
      ],
      "values": [
        {
          "value": "1",
          "label": "Único dono"
        },
        {
          "value": "2",
          "label": "Com manual"
        },
        {
          "value": "3",
          "label": "Chave reserva"
        },
        {
          "value": "4",
          "label": "Revisões feitas em concessionária"
        },
        {
          "value": "5",
          "label": "Com garantia"
        }
      ],
      "values_link": null
    },
    {
      "id": "company_ad",
      "name": "company_ad",
      "label": "Tipo de anunciante",
      "description": null,
      "type": "chips",
      "query_keys": [
        "f"
      ],
      "values": [
        {
          "value": null,
          "label": "Ambos"
        },
        {
          "value": "0",
          "label": "Particular"
        },
        {
          "value": "1",
          "label": "Profissional"
        }
      ],
      "values_link": null
    },
    {
      "id": "sorting",
      "name": "sort",
      "label": "Ordenar por",
      "description": null,
      "type": "chips",
      "query_keys": [
        "sp",
        "sf"
      ],
      "values": [
        {
          "value": "relevance",
          "label": "Mais Relevantes"
        },
        {
          "value": "date",
          "label": "Mais Recentes"
        },
        {
          "value": "price",
          "label": "Menor Preço"
        },
        {
          "value": "biggest_price",
          "label": "Maior Preço"
        }
      ],
      "values_link": null
    }
  ]
}