nvNeuralVerge
E-commerce & Marketplaces

Avito Category Tree — IDs, Aliases & Browse URLs

This source returns Avito's category tree as data: departments and sub-categories with an ID, name, alias, parent ID, level and browse URL for each.

Example response
{
  "session_id": "11111111-1111-1111-1111-111111111111",
  "kind": "avito_categories",
  "human": "# Avito categories\n\n- **Categories returned:** 77\n- **Proxy traffic:** 2.16 MB",
  "machine": {
    "total_items": 77,
    "items": [
      {
        "@type": "AvitoCategory",
        "id": "1",
        "name": "Транспорт",
        "alias": "transport",
        "parent_id": null,
        "level": 1,
        "url": "https://www.avito.ru/all/transport",
        "node_id": "25984",
        "microcategory_id": "2"
      },
      {
        "@type": "AvitoCategory",
        "id": "9",
        "name": "Автомобили",
        "alias": "avtomobili",
        "parent_id": "1",
        "level": 2,
        "url": "https://www.avito.ru/all/avtomobili",
        "node_id": "25985",
        "microcategory_id": "14"
      }
    ],
    "response_bytes": 2268767
  },
  "total_points": 5
}
You send
Nothing — no parameters
You get back
The category tree: ID, name, alias, parent ID, level and browse URL
Coverage
The Avito category tree as published on the site.
Price
5 points per run — $5 per 1,000
Flat 5 points for the run, as shown in the sample response (total_points is 5 for the whole tree). With no input there is no partial match to worry about.
Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

ApproachWhat it takesCostTrade-off
Browsing Avito's category pages by handClick through departments and copy each slugFree, and tediousFine for one or two categories, impractical for the full tree
Building a scraperWrite it, host it, and repair it when Avito changes its navigationEngineering timeA lot of upkeep for a lookup you run rarely
NeuralVergeOne request, no parameters5 points flatReturns the whole tree every time — there's no way to ask for one branch
Response

What you get back

Every field in the response shown above.

FieldTypeDescription
total_itemsnumberHow many categories the tree contains.
idstringAvito's ID for the category.
namestringCategory name, in Russian.
aliasstringURL slug for the category, the value used for the category filter in Avito items search.
parent_idstringID of the parent category; null for a top-level department.
levelnumberDepth in the tree, 1 for a department.
urlstringLink to the category's browse page.
node_idstringAvito's node ID for the category.
microcategory_idstringAvito's microcategory ID.
Integration

How to run it

The same lookup works from the app, the API, or as a tool an agent can call mid-task.

No parameters. Use alias as the category value in Avito items search, and parent_id with level to rebuild the tree on your side. The sample is trimmed to two categories for readability; a real run returns the full tree.

curl -X POST https://api.neuralverge.ai/functions/v1/run-avito-categories \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
Use cases

What teams use it for

Where this field shows up in an actual workflow.

Building category filters

Get the alias to pass as category in Avito items search.

Taxonomy mapping

Map Avito's departments to your own product categories.

Coverage planning

List what Avito organises its listings into before you decide what to monitor.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

The Avito category tree as published on the site.

Freshness

Read at request time.

Handling

This source returns the publicly visible category structure, stamped with a session id you can trace.

What it will not do
  • —Category names come back in Russian.
  • —You can't request a single branch — every run returns the whole tree.
  • —The docs describe the price as "5 point per returned record", while the sample response bills 5 points for the whole tree; this page follows the sample.
FAQ

Questions, answered

Pass it as the category value in Avito items search to restrict a query to that category.

Related

Related sources

Try avito categories on your own data

One request format across every source in the catalog.

Get started