# OLX India Listings Scraper (`fetch_cat/olx-india-listings-scraper`) Actor Scrape public OLX India classified listings by keyword, category, location, or listing URL for prices, sellers, images, and attributes. - **URL**: https://apify.com/fetch\_cat/olx-india-listings-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** E-commerce, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.07 / 1,000 result extracteds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## OLX India Listings Scraper Export public OLX India classified listings into clean datasets. Search by keyword or run exact OLX India category/search URLs, then download listing prices, locations, seller labels, images, and product attributes as CSV, JSON, Excel, XML, or through the Apify API. ### What does this actor do? OLX India Listings Scraper turns public OLX India search results and category URLs into structured marketplace data. It collects listing titles, prices, locations, seller labels, images, attributes, posting timestamps, and source URLs so you can analyze classifieds without manually copying results. ### What you can do - Monitor used-car, property, electronics, furniture, jobs, services, and other OLX India categories. - Track asking prices and fresh inventory for resale, marketplace research, and local lead generation. - Export public seller/location signals without opening chat, contact, or login-only flows. - Build alerts and dashboards from repeatable keyword or URL inputs. ### Who is it for - Marketplace analysts comparing prices and listing supply across OLX India categories. - Resellers and dealerships tracking public inventory and seller/location signals. - Real estate, vehicle, electronics, and local-services teams building lead lists from public classifieds. - Data teams that need repeatable OLX India exports for dashboards, alerts, or research workflows. ### Example input ```json { "queries": ["car", "iphone"], "locationId": "1000001", "maxItems": 25, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "IN" } } ```` You can also pass exact OLX India URLs: ```json { "startUrls": [ { "url": "https://www.olx.in/items/q-car" }, { "url": "https://www.olx.in/cars_c84" } ], "maxItems": 50 } ``` ### Example output ```json { "url": "https://www.olx.in/item/maruti-suzuki-swift-dzire-iid-1678692832", "adId": "1678692832", "title": "New Maruti Suzuki swift Dzire T-Permit CNG CARS", "descriptionSnippet": "Get your commercial vehicle with minimal documents!", "price": 185000, "priceDisplay": "₹ 1,85,000", "currency": "INR", "location": { "country": "India", "state": "Maharashtra", "city": "Mumbai", "locality": "Vakola", "latitude": 19.079, "longitude": 72.849 }, "categoryId": "85", "postedAt": "2026-07-08T08:46:13+0000", "createdAt": "2025-04-01T16:45:57+05:30", "sellerName": "Carmitra", "sellerType": "Regular", "sellerId": "248018633", "isBusiness": true, "isKycVerifiedUser": false, "favoriteCount": 11, "imageUrls": ["https://apollo.olx.in:443/v1/files/example-IN/image;s=1080x810"], "attributes": { "Brand": "Maruti Suzuki", "Year": "2025", "KM driven": "0 km" }, "sourceUrl": "car", "scrapedAt": "2026-07-08T09:00:00.000Z" } ``` ### Input settings | Field | Type | Description | |---|---:|---| | `queries` | string\[] | Keywords to search on OLX India, for example `car`, `iphone`, or `flat for rent`. | | `startUrls` | array | OLX India search, category, filtered search, or listing URLs. Use this when you already have the exact OLX URL. | | `locationId` | string | OLX numeric location ID for keyword searches. Default `1000001` searches all India. | | `maxItems` | integer | Maximum number of listings to save across all inputs. | | `includeDetails` | boolean | Reserved for future detail-page enrichment. Current output uses public listing/search fields. | | `proxyConfiguration` | object | Residential India proxy is recommended because OLX commonly blocks datacenter traffic. | ### Output fields - `url`, `adId`, `title`, `descriptionSnippet` - `price`, `priceDisplay`, `currency` - `location` with country, state, city, locality, latitude, and longitude - `categoryId`, `postedAt`, `createdAt` - `sellerName`, `sellerType`, `sellerId`, `isBusiness`, `isKycVerifiedUser` - `favoriteCount` - `imageUrls`, `images` - `attributes`, `rawAttributes` - `sourceUrl`, `scrapedAt` ### Pricing This Actor uses Apify pay-per-event pricing. The prices below come from the current Actor pricing configuration. Apify public plans map to Store discount tiers, so the table shows both the user-facing plan context and the pricing tier name. The final price shown in Apify depends on the user account plan and any custom agreement. | Event | What is charged | Price | | --- | --- | ---: | | `start` | One-time fee charged when a run starts. Covers fixed startup cost (init, proxy warmup, first HTTP setup). | $0.005 | | Event | What is charged | Free / no discount | Starter / Bronze | Scale / Silver | Business / Gold | Custom / Platinum | Custom / Diamond | | --- | --- | ---: | ---: | ---: | ---: | ---: | ---: | | `result` | Charged per OLX India listing extracted. | $0.12824 / 1,000 | $0.11151 / 1,000 | $0.08698 / 1,000 | $0.06691 / 1,000 | $0.04461 / 1,000 | $0.03122 / 1,000 | Apify may also charge platform usage for compute, storage, proxies, or data transfer outside this Actor pricing. Check the Actor run and the Apify Pricing tab for the exact cost shown to your account. ### Tips and limits - Keep first runs small, such as `maxItems: 25`, while you validate your keywords. - Use exact `startUrls` for city/category/filter combinations copied from OLX India. - Contact details, chat messages, private account pages, and login-only data are not collected. - Public pages may change or block datacenter traffic; keep Apify Residential proxy enabled for reliable runs. ### API usage Run the actor with cURL: ```bash curl "https://api.apify.com/v2/acts/fetch_cat~olx-india-listings-scraper/runs?token=$APIFY_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"queries":["car"],"maxItems":25}' ``` Run it with Node.js: ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('fetch_cat/olx-india-listings-scraper').call({ queries: ['car'], maxItems: 25, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items.slice(0, 3)); ``` Run it with Python: ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ['APIFY_TOKEN']) run = client.actor('fetch_cat/olx-india-listings-scraper').call(run_input={ 'queries': ['car'], 'maxItems': 25, }) items = client.dataset(run['defaultDatasetId']).list_items().items print(items[:3]) ``` Fetch results from the default dataset after the run succeeds: ```bash curl "https://api.apify.com/v2/datasets/DATASET_ID/items?format=json&clean=true" ``` ### MCP and agent usage Use this actor from Apify MCP-compatible agents with: ```text https://mcp.apify.com/?tools=fetch_cat/olx-india-listings-scraper ``` Claude CLI example: ```bash claude mcp add apify-olx-india "https://mcp.apify.com/?tools=fetch_cat/olx-india-listings-scraper" ``` MCP JSON configuration example: ```json { "mcpServers": { "apify-olx-india": { "url": "https://mcp.apify.com/?tools=fetch_cat/olx-india-listings-scraper" } } } ``` Example prompts: - "Find 25 OLX India car listings and summarize asking prices by city." - "Export public iPhone listings from OLX India and return seller names, prices, and image URLs." - "Monitor this OLX India category URL and identify newly posted listings." ### Related actors - [Craigslist Classifieds Scraper](https://apify.com/fetch_cat/craigslist-classifieds-scraper) - [AutoScout24 Car Listings Scraper](https://apify.com/fetch_cat/autoscout24-car-listings-scraper) - [Google Shopping Results Scraper](https://apify.com/fetch_cat/google-shopping-results-scraper) ### Legality This actor collects publicly visible OLX India listing data. Do not use it to collect private account data, reveal contact details, bypass login-only flows, spam sellers, or violate OLX India terms or applicable law. Review your use case and retention policy before running large recurring jobs. ### FAQ **Does this actor require an OLX account?** No. It exports public listing data visible without logging in. **Can it reveal phone numbers or chat messages?** No. Contact/chat flows are login-only or user-action flows and are intentionally out of scope. **Why is Residential proxy enabled by default?** OLX India often blocks datacenter requests. Residential India proxy improves reliability for public listing pages. **What should I include when asking for support?** Share the run ID or run URL, your input JSON, expected output, and actual output so the issue can be reproduced. ### Support Open an issue on the actor page or contact Apify support with: - the run ID or run URL, - the input JSON you used, - a reproducible public URL, such as `https://www.olx.in/items/q-car`, - the expected output, and - the actual output you received. # Actor input Schema ## `queries` (type: `array`): Keywords to search on OLX India, such as car, iPhone, flat for rent, or sofa. ## `startUrls` (type: `array`): OLX India search, category, filtered search, or listing URLs to scrape. Use this for exact OLX URLs such as https://www.olx.in/items/q-car or https://www.olx.in/cars\_c84. ## `locationId` (type: `string`): Numeric OLX location ID used for keyword searches. Leave 1000001 for all India, or use a location URL in Start URLs for a specific city/locality. ## `maxItems` (type: `integer`): Maximum number of classified listings to save across all queries and start URLs. ## `includeDetails` (type: `boolean`): Reserved for future detail-page enrichment. Public listing search fields are exported in the current version without opening seller chat or contact flows. ## `proxyConfiguration` (type: `object`): Residential India proxy is recommended because OLX often blocks datacenter traffic. ## Actor input object example ```json { "queries": [ "car" ], "startUrls": [ { "url": "https://www.olx.in/items/q-car" } ], "locationId": "1000001", "maxItems": 20, "includeDetails": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IN" } } ``` # Actor output Schema ## `overview` (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 = { "queries": [ "car" ], "startUrls": [ { "url": "https://www.olx.in/items/q-car" } ], "locationId": "1000001", "maxItems": 20, "includeDetails": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IN" } }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/olx-india-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 = { "queries": ["car"], "startUrls": [{ "url": "https://www.olx.in/items/q-car" }], "locationId": "1000001", "maxItems": 20, "includeDetails": False, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "IN", }, } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/olx-india-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 '{ "queries": [ "car" ], "startUrls": [ { "url": "https://www.olx.in/items/q-car" } ], "locationId": "1000001", "maxItems": 20, "includeDetails": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IN" } }' | apify call fetch_cat/olx-india-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/olx-india-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "OLX India Listings Scraper", "description": "Scrape public OLX India classified listings by keyword, category, location, or listing URL for prices, sellers, images, and attributes.", "version": "0.1", "x-build-id": "DVCkaJJUBYplLgVdR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~olx-india-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-olx-india-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/fetch_cat~olx-india-listings-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-olx-india-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/fetch_cat~olx-india-listings-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-olx-india-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", "properties": { "queries": { "title": "Search queries", "type": "array", "description": "Keywords to search on OLX India, such as car, iPhone, flat for rent, or sofa.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "OLX India search, category, filtered search, or listing URLs to scrape. Use this for exact OLX URLs such as https://www.olx.in/items/q-car or https://www.olx.in/cars_c84.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "locationId": { "title": "OLX location ID", "type": "string", "description": "Numeric OLX location ID used for keyword searches. Leave 1000001 for all India, or use a location URL in Start URLs for a specific city/locality.", "default": "1000001" }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of classified listings to save across all queries and start URLs.", "default": 20 }, "includeDetails": { "title": "Include detail-page enrichment", "type": "boolean", "description": "Reserved for future detail-page enrichment. Public listing search fields are exported in the current version without opening seller chat or contact flows.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential India proxy is recommended because OLX often blocks datacenter traffic.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IN" } } } }, "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 } } } } } } } } } } ```