OLX Category Filters — Keys, Types & Allowed Values
Send an OLX category ID and this source returns the filters that category supports: each filter's key, display name, type, allowed values and suggested ranges.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "olx_categories_filters",
"domain": "olx.pl",
"category_id": 1920,
"max_items": 2,
"partial": false,
"human": "# OLX category filters\n\n- **Domain:** olx.pl\n- **Category id:** 1920\n- **Max items:** 2\n- **Records returned:** 2\n- **Proxy traffic:** 451.5 KB",
"machine": {
"total_items": 2,
"total_available": 8,
"first_item": {
"key": "filter_enum_state",
"name": "Stan",
"type": "select",
"unit": null,
"scope": "offer",
"value_type": "string",
"position": 0,
"values": [
{
"value": "used",
"label": "Używane"
},
{
"value": "new",
"label": "Nowe"
}
],
"suggested_ranges": []
},
"items": [
{
"key": "filter_enum_state",
"name": "Stan",
"type": "select",
"unit": null,
"scope": "offer",
"value_type": "string",
"position": 0,
"values": [
{
"value": "used",
"label": "Używane"
},
{
"value": "new",
"label": "Nowe"
}
],
"suggested_ranges": []
},
{
"key": "filter_enum_price",
"name": "Cena",
"type": "price",
"unit": null,
"scope": null,
"value_type": "string",
"position": 2,
"values": [
{
"value": "exchange",
"label": "Zamienię"
},
{
"value": "free",
"label": "Za darmo"
}
],
"suggested_ranges": [
50,
100
]
}
],
"proxy_traffic_bytes": 462344
},
"total_points": 5
}- You send
- An OLX category ID, and the marketplace domain (defaults to olx.pl)
- You get back
- Filter keys, names, types, allowed values and suggested ranges
- Coverage
- Category filters of the OLX marketplaces for Poland, Ukraine, Romania, Bulgaria, Portugal, Kazakhstan and Uzbekistan.
- Price
- 5 points per run — $5 per 1,000
- Priced per run, not per record: the sample response below billed 5 points for 2 records.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Browsing OLX by hand | Click through the site and note the IDs | Free, and tedious | Fine for one or two, impractical for a full set |
| Building a scraper | Write it, host it, and repair it when OLX changes its pages | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request per category | $5 per run | Filter definitions are specific to one category and marketplace, so you need one run per category you care about |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
total_items | number | How many filters were returned in this batch (capped by max_items). |
total_available | number | How many filters the category has in total. |
first_item | object | The first filter, repeated from items. |
items | array | The returned filters. Each has the keys below. |
key | string | Filter key, e.g. filter_enum_state. |
name | string | Filter name, in the marketplace language. |
type | string | Filter type, e.g. select or price. |
unit | string | Unit of the filter value. null in the sample. |
scope | string | Scope of the filter, e.g. offer. null on some filters. |
value_type | string | Type of the filter value, e.g. string. |
position | number | Display position of the filter. |
values | array | Allowed values, each with a value and a label. |
suggested_ranges | array | Suggested range breakpoints, e.g. 50 and 100 for price. Empty when none. |
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
category_id is the only required field; take it from OLX categories. max_items goes up to 500 (default 100). Billing is per run, not per record: the sample below billed 5 points for 2 filters.
curl -X POST https://api.neuralverge.ai/functions/v1/run-olx-categories-filters \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "category_id": 1920, "max_items": 100 }'What teams use it for
Where this field shows up in an actual workflow.
Find valid filter keys and values before running OLX offers search.
See which attributes a category exposes, such as condition options.
Populate filter dropdowns from the real allowed values.
Compare how filters differ for the same kind of category between marketplaces.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Category filters of the OLX marketplaces for Poland, Ukraine, Romania, Bulgaria, Portugal, Kazakhstan and Uzbekistan.
Read at request time.
This source returns publicly visible category information, stamped with the category ID and domain it was read from and a session id you can trace.
- —Filter names and value labels are in the marketplace language.
- —Category IDs are specific to one marketplace and cannot be reused on another domain.
- —The filter definitions describe OLX's own filters; not every filter key maps to a parameter of OLX offers search.
Questions, answered
From the OLX categories source. Each category there has an id.
Related sources
Try olx category filters on your own data
One request format across every source in the catalog.