# Avito Listings Scraper (`piotrv1001/avito-listings-scraper`) Actor The Avito Listings Scraper extracts listings and enriched detail pages from Avito.ru, capturing titles, numeric prices, specs, seller name and type, ratings, locations, photos, and full descriptions across every category — ideal for price monitoring, market research, and lead generation. - **URL**: https://apify.com/piotrv1001/avito-listings-scraper.md - **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community) - **Categories:** E-commerce, Lead generation, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### 🛒 Avito Listings Scraper **Avito Listings Scraper** extracts structured listing data from **[Avito.ru](https://www.avito.ru/)** — Russia's largest classifieds marketplace — without an API key or login. Paste any category or search URL and get clean JSON with **prices, specs, seller info, locations, and photos** for cars, real estate, electronics, jobs, services, and every other Avito category. Run it on the **[Apify platform](https://apify.com/)** to get scheduling, a REST API, webhooks, ready-made integrations (Google Sheets, Make, Zapier, Slack, and more), automatic proxy rotation, and run monitoring out of the box. Try it with the default input to pull live results in seconds. ### ✨ Features - 🏷️ **Rich listing data** — title, numeric price, key specs, location, seller rating, image, listing ID, city, and category for every result. - 🔍 **URL-driven** — provide any Avito category or search result URL; the scraper paginates automatically. - 🧾 **Optional deep details** — enable **Scrape listing details** to also collect the full description, seller name and type, address, complete specifications, and all photos from each listing page. - 📦 **Bulk-ready** — collect up to ~5,000 listings per search URL and combine multiple URLs in one run. - ⚡ **Fast & reliable** — built-in proxy rotation keeps runs stable, and you only pay for the data you actually get. ### 💡 Why use Avito Listings Scraper? - **Market & price intelligence** — track prices and inventory across cities and categories. - **Competitor & sourcing research** — monitor what sellers list, at what price, and where. - **Lead generation & sourcing** — build datasets of sellers and offers by category and region. - **Resale & arbitrage** — spot underpriced items and price trends in real time. ### 🛠️ How to use Avito Listings Scraper 1. **Add start URLs** — paste one or more Avito category or search result URLs (e.g. `https://www.avito.ru/moskva/telefony`). 2. **Set a limit** — choose how many listings to scrape with **Max items**. 3. **(Optional) Enable details** — turn on **Scrape listing details** for full descriptions, seller info, addresses, specs, and all photos. 4. **Run the Actor** — start it and watch results stream into the dataset. 5. **Export** — download your data as JSON, CSV, Excel, or HTML, or pull it via the Apify API. ### 📥 Input Configure the run from the **Input** tab or via the API. Fields: | Field | Type | Description | |---|---|---| | `startUrls` | array | Avito category or search result URLs to scrape. | | `maxItems` | integer | Maximum number of listings to scrape (0 = no limit). Default `50`. | | `scrapeDetails` | boolean | Visit each listing page for full details. Default `false`. | | `proxyConfiguration` | object | Proxy settings. Residential proxies from Russia are recommended and used by default. | Example input: ```json { "startUrls": [{ "url": "https://www.avito.ru/moskva/telefony" }], "maxItems": 50, "scrapeDetails": false } ```` ### 📤 Output Each listing is stored as one dataset item. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. Example output (listing mode): ```json { "id": "8269517209", "url": "https://www.avito.ru/moskva/telefony/samsung_galaxy_s26_ultra_12256_gb_2_sim_8269517209", "title": "Samsung Galaxy S26 Ultra, 12/256 ГБ, 2 SIM", "price": 67000, "priceText": "67 000 ₽", "specs": "Б/у", "location": "Москва", "sellerRating": 4.8, "imageUrl": "https://10.img.avito.st/image/1/...", "city": "moskva", "category": "telefony" } ``` With **Scrape listing details** enabled, each item additionally includes: ```json { "description": "Продаю Samsung S26 Ultra. Цвет золотой, две нано-SIM + eSIM...", "sellerName": "Денис", "sellerType": "Частное лицо", "address": "Москва", "params": { "Производитель": "Samsung", "Модель": "Galaxy S26 Ultra", "Встроенная память": "256 ГБ", "Оперативная память": "12 ГБ" }, "paramsText": "О смартфоне Состояние Отличное ...", "images": ["https://10.img.avito.st/image/1/...", "https://20.img.avito.st/image/1/..."] } ``` #### Data fields | Field | Description | |---|---| | `id` | Avito listing ID | | `url` | Canonical listing URL | | `title` | Listing title | | `price` | Numeric price | | `priceText` | Price as shown on the site | | `specs` | Short specs/parameters from the listing card | | `location` | Listing location | | `sellerRating` | Seller rating (when available) | | `imageUrl` | Main listing photo | | `city` / `category` | Parsed from the listing URL | | `description`\* | Full listing description | | `sellerName`\* / `sellerType`\* | Seller name and type (private person / company) | | `address`\* | Listing address | | `params`\* / `paramsText`\* | Full specifications | | `images`\* | All listing photos | \* Included only when **Scrape listing details** is enabled. ### 💰 Pricing This Actor uses the **pay-per-result** (pay-per-event) pricing model — you pay only for the data you receive: | Event | Price | When it's charged | |---|---|---| | Listing scraped | **$4 / 1,000 listings** | For each listing in the default (listing-only) mode | | Listing detail scraped | **$7 / 1,000 listings** | For each fully enriched listing when **Scrape listing details** is on | There is **no fixed per-run fee**. Scraping 1,000 listings costs about **$4**, or **$7** with full details. New Apify accounts include free monthly usage credits, so you can start testing at no cost. ### ⚙️ Tips & advanced options - **Narrow with the URL.** Avito caps results at ~5,000 per search. Use city + sub-category + filters in your start URL to slice large categories into focused runs. - **Start small.** Keep `scrapeDetails` off for cheap, fast price/inventory snapshots; enable it only when you need descriptions, seller details, or all photos. - **Combine URLs.** Add several category or search URLs in one run to build a broad dataset in a single pass. - **Schedule it.** Use Apify Schedules to refresh your dataset daily or hourly for ongoing price monitoring. ### ❓ FAQ **Is scraping Avito legal?** This Actor collects only publicly available information. You are responsible for how you use the data and for complying with Avito's Terms of Service, applicable laws, and data-protection regulations (e.g. GDPR). It does not collect personal contact details such as phone numbers. **Do I need proxies?** Reliable access to Avito requires residential proxies from Russia, which are configured by default. You can adjust proxy settings in the input. **Why are some fields empty?** Avito listings vary by category, so not every field (e.g. seller rating or specs) is present on every listing. **Can I get more than 5,000 results?** Avito limits a single search to ~5,000 listings. Split your target into multiple, more specific start URLs to go beyond that. ### 🛟 Support Found a bug or need an extra field or category supported? Open an issue from the Actor's **Issues** tab — feedback and feature requests are welcome. Custom scraping solutions are also available on request. # Actor input Schema ## `startUrls` (type: `array`): Avito category or search result URLs to scrape, e.g. https://www.avito.ru/moskva/telefony. The scraper paginates through each URL automatically. ## `maxItems` (type: `integer`): Maximum number of listings to scrape across all start URLs. Set to 0 for no limit (Avito allows up to ~5,000 listings per search). ## `scrapeDetails` (type: `boolean`): When enabled, each listing's detail page is visited to extract richer data: full description, seller name and type, address, all photos, and complete specifications. Slower and more expensive than the listing-only mode. ## `proxyConfiguration` (type: `object`): Proxy settings. Residential proxies from Russia are strongly recommended for reliable access. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.avito.ru/moskva/telefony" } ], "maxItems": 50, "scrapeDetails": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "RU" } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.avito.ru/moskva/telefony" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("piotrv1001/avito-listings-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.avito.ru/moskva/telefony" }] } # Run the Actor and wait for it to finish run = client.actor("piotrv1001/avito-listings-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.avito.ru/moskva/telefony" } ] }' | apify call piotrv1001/avito-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=piotrv1001/avito-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Avito Listings Scraper", "description": "The Avito Listings Scraper extracts listings and enriched detail pages from Avito.ru, capturing titles, numeric prices, specs, seller name and type, ratings, locations, photos, and full descriptions across every category — ideal for price monitoring, market research, and lead generation.", "version": "0.0", "x-build-id": "RbgPtbEbnrgl5Tr2b" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~avito-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-avito-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/piotrv1001~avito-listings-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-avito-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/piotrv1001~avito-listings-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-avito-listings-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Avito category or search result URLs to scrape, e.g. https://www.avito.ru/moskva/telefony. The scraper paginates through each URL automatically.", "default": [ { "url": "https://www.avito.ru/moskva/telefony" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of listings to scrape across all start URLs. Set to 0 for no limit (Avito allows up to ~5,000 listings per search).", "default": 50 }, "scrapeDetails": { "title": "Scrape listing details", "type": "boolean", "description": "When enabled, each listing's detail page is visited to extract richer data: full description, seller name and type, address, all photos, and complete specifications. Slower and more expensive than the listing-only mode.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Residential proxies from Russia are strongly recommended for reliable access.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "RU" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```