OLX Category Tree Data — IDs, Hierarchy & Live Ad Counts
This source returns the category tree of an OLX marketplace as data: category ID, name, alias, parent ID, depth, child IDs, page URL and the number of live ads in each category.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "olx_categories",
"domain": "olx.pl",
"max_items": 2,
"partial": false,
"human": "# OLX categories\n\n- **Domain:** olx.pl\n- **Max items:** 2\n- **Records returned:** 2\n- **Proxy traffic:** 255.4 KB",
"machine": {
"total_items": 2,
"total_available": 3304,
"first_item": {
"id": "3",
"name": "Nieruchomości",
"alias": "nieruchomosci",
"parent_id": null,
"level": 1,
"position": 5,
"category_type": "real_estate",
"view_type": "gallery",
"path": "nieruchomosci",
"url": "https://www.olx.pl/nieruchomosci/",
"image": "https://categories.olxcdn.com/assets/categories/olxpl/nieruchomosci-3-1x.png",
"child_ids": [
"11",
"32"
],
"offer_count": 169330,
"is_private_business": true,
"photos_max": 8
},
"items": [
{
"id": "3",
"name": "Nieruchomości",
"alias": "nieruchomosci",
"parent_id": null,
"level": 1,
"position": 5,
"category_type": "real_estate",
"view_type": "gallery",
"path": "nieruchomosci",
"url": "https://www.olx.pl/nieruchomosci/",
"image": "https://categories.olxcdn.com/assets/categories/olxpl/nieruchomosci-3-1x.png",
"child_ids": [
"11",
"32"
],
"offer_count": 169330,
"is_private_business": true,
"photos_max": 8
},
{
"id": "4",
"name": "Praca",
"alias": "praca",
"parent_id": null,
"level": 1,
"position": 6,
"category_type": "job",
"view_type": "list",
"path": "praca",
"url": "https://www.olx.pl/praca/",
"image": "https://categories.olxcdn.com/assets/categories/olxpl/praca-4-1x.png",
"child_ids": [
"53",
"56"
],
"offer_count": 85368,
"is_private_business": false,
"photos_max": 0
}
],
"proxy_traffic_bytes": 261578
},
"total_points": 5
}- You send
- A marketplace domain, with an optional parent_id or level
- You get back
- Category ID, name, alias, parent, depth, child IDs, URL and live ad count
- Coverage
- Category trees 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, domain as a parameter | $5 per run | Ad counts are a snapshot, and category names are in the local language of the marketplace |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
total_items | number | How many categories were returned in this batch (capped by max_items). |
total_available | number | How many categories the marketplace has in total. |
first_item | object | The first category, repeated from items. |
items | array | The returned categories. Each has the keys below. |
id | string | OLX category ID. |
name | string | Category name, in the marketplace language. |
alias | string | URL alias of the category. |
parent_id | string | ID of the parent category. null for top-level categories. |
level | number | Depth in the tree (1 for top level). |
position | number | Sort position among siblings. |
category_type | string | Category type, e.g. real_estate or job. |
view_type | string | How OLX displays the category, e.g. gallery or list. |
path | string | URL path of the category. |
url | string | Direct link to the category page. |
image | string | Category icon URL. |
child_ids | array | IDs of the direct child categories. |
offer_count | number | Live ads in the category at request time. |
is_private_business | boolean | Flag returned for the category, true on real estate and false on jobs in the sample. |
photos_max | number | Maximum photos per ad in the category. |
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
Every parameter is optional. max_items goes up to 500 (default 100); parent_id returns the children of one category and level restricts the depth. Billing is per run, not per record: the sample below billed 5 points for 2 categories.
curl -X POST https://api.neuralverge.ai/functions/v1/run-olx-categories \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "domain": "olx.pl", "max_items": 100 }'What teams use it for
Where this field shows up in an actual workflow.
Get category IDs to pass to OLX offers search and OLX user offers.
Compare live ad counts across categories on one marketplace.
Map OLX's category tree to your own product or lead categories.
Take a category ID and run OLX category filters to see what you can filter on.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Category trees 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 domain it was read from and a session id you can trace.
- —Ad counts change constantly and reflect the moment of the request.
- —Category names are in the marketplace language and differ between countries.
- —Category IDs are specific to one marketplace and cannot be reused on another domain.
Questions, answered
Pass an ID as category_id to OLX offers search, OLX user offers or OLX category filters.
Related sources
Try olx categories on your own data
One request format across every source in the catalog.