Avito API: List category listings

Returns one page of an Avito city-category's listings — title, price, address, coordinates, photos, seller and rating. Requires url, an Avito category URL or path. Paginates to page 100 of 50; plan against reachable_count rather than total_count, and de-duplicate on id across pages.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

url*string

Avito category listing URL or path, such as /moskva/avtomobili. Query strings are removed. Item detail URLs are not accepted.

Lengthlength <= 500

page?integer

Page of 50 listings to return, up to 100. At most 5,000 rows are reachable per city and category.

Range1 <= value <= 100

Default1

sort?string

Sort code from the response's sorts array. Codes vary by category; common values are 101 default, 1 cheapest, 2 most expensive, and 104 newest.

Lengthlength <= 32

curl -X GET "https://example.com/v1/avito/listings?url=%2Fmoskva%2Favtomobili" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "requested_url": "/moskva/avtomobili",    "url": "https://www.avito.ru/moskva/avtomobili",    "requested_page": 1,    "requested_sort": null,    "title": "Купить автомобиль в Москве",    "canonical_url": "https://www.avito.ru/moskva/avtomobili",    "location_name": "Москва",    "location_id": "637640",    "category_id": "9",    "results": [      {        "id": "8082366222",        "url": "https://www.avito.ru/moskva/avtomobili/toyota_camry_2.5_at_2013_201_463_km_8082366222",        "title": "Toyota Camry 2.5 AT, 2013, 201 463 км",        "price": 1200000,        "price_text": "1 200 000 ₽",        "price_was_lowered": false,        "category": "Автомобили",        "category_slug": "avtomobili",        "location": "Москва",        "address": "Москва, Варшавская",        "latitude": 55.664456,        "longitude": 37.627059,        "sort_timestamp_ms": 1787324360000,        "is_new": false,        "is_verified": true,        "is_reserved": false,        "images": [          "https://00.img.avito.st/image/1/1.DjHNe…"        ],        "images_count": 32,        "description": "1 собственник. ПТС оригинал.",        "attributes": "201 463 км, 2.5 AT (181 л.с.), седан, передний, бензин",        "seller": {          "name": "ТОРГМАШ",          "url": "https://www.avito.ru/brands/i116890677",          "rating": 4.5,          "reviews_summary": "298 отзывов"        },        "rating": 4.5      }    ],    "count": 50,    "dropped_non_listing_rows": 3,    "descriptions_available": 6,    "page": 1,    "last_page": 100,    "items_per_page": 50,    "max_page": 100,    "total_count": 79551,    "reachable_count": 5000,    "has_next_page": true,    "sorts": [      {        "code": "1",        "name": "Дешевле"      }    ],    "default_sort": "101",    "usage_note": "Avito paginates to page 100 of 50 and no further, whatever total_count says — reachable_count is what the pager will actually hand over. Rows repeat across pages (a 12-page walk returned 554 distinct ids out of 600), so de-duplicate on id when harvesting. description arrives for a leading prefix of the rows only and how long that prefix is varies per render; descriptions_available states how many arrived on this page."  }}