# Quikr Product Scraper 🛍️ (`shahidirfan/quikr-product-scraper`) Actor Scrape live product listings from India's Quikr marketplace instantly. Extract prices, seller details, descriptions & images. Ideal for price intelligence, competitive monitoring, inventory tracking, ecommerce research & AI datasets. Fully structured output. - **URL**: https://apify.com/shahidirfan/quikr-product-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** E-commerce, Developer tools, Automation - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Quikr Product Scraper Extract comprehensive furniture listings and product details from Quikr with ease. Collect detailed data including titles, prices, conditions, and locations at scale. Perfect for market research, price monitoring, and competitive analysis. --- ### Features - **Flexible inputs** — Scrape data using direct categories, custom search keywords, or specific cities. - **Detailed data extraction** — Capture prices, images, condition ratings, and seller descriptions. - **Sponsored listing detection** — Differentiate regular ads from promoted listings automatically. - **Data deduplication** — Cleanse duplicate ads to guarantee a unique and accurate dataset. --- ### Use Cases #### Competitive Pricing Monitor competitor pricing trends in real-time. Optimize your own pricing strategies by matching current market values. #### Product Sourcing Identify high-demand furniture types and popular products. Source items that align with current buyer preferences. #### Location Analysis Compare regional supply and demand across cities. Uncover geographical opportunities and market gaps. --- ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `url` | String | No | — | Quikr category or browse URL | | `keyword` | String | No | — | Custom search term to filter listings | | `location` | String | No | `"India"` | Location or city to filter by | | `results_wanted` | Integer | No | `50` | Maximum number of listings to retrieve | | `max_pages` | Integer | No | `1` | Maximum pages of results to scrape | | `proxyConfiguration` | Object | No | `{"useApifyProxy": false}` | Network proxy settings | --- ### Output Data Each scraped listing includes: | Field | Type | Description | |-------|------|-------------| | `ad_id` | String | Unique listing identifier | | `title` | String | Title of the product | | `url` | String | Direct link to the listing | | `price` | Number | Numeric price value | | `condition` | String | Item condition state | | `city` | String | City where listed | | `is_sponsored` | Boolean | If the ad is sponsored | --- ### Usage Examples #### Category Scrape Retrieve furniture listings from a specific category: ```json { "url": "https://www.quikr.com/home-lifestyle/Home-Office-Furniture+India+y56f", "results_wanted": 20 } ```` #### Search by Keyword Extract items matching a specific search term: ```json { "keyword": "Sofa Sets", "location": "Delhi", "results_wanted": 15 } ``` #### High-Volume Extraction Extract multiple pages of listings with proxies enabled: ```json { "keyword": "Office Chair", "results_wanted": 100, "max_pages": 3, "proxyConfiguration": { "useApifyProxy": true } } ``` *** ### Sample Output ```json { "ad_id": "374829103", "title": "Modern Wooden Sofa Set 5 Seater", "url": "https://www.quikr.com/home-lifestyle/modern-wooden-sofa-set...", "price": 15000, "condition": "Like New", "city": "Delhi", "is_sponsored": false } ``` *** ### Tips for Best Results #### Specify Precise Locations - Provide city names for localized results. - Leave location default to search nationwide. #### Manage Scrape Limits - Start with lower result counts to test. - Adjust max pages according to available items. #### Use Direct Browse URLs - Input category URLs for maximum scraping accuracy. - Filter category views directly before starting the scraper. *** ### Integrations Connect your data with: - **Google Sheets** — Export directly to spreadsheets - **Airtable** — Build searchable custom databases - **Slack** — Send automated alerts and updates #### Export Formats - **JSON** — Developer-friendly data feeds - **CSV** — Spreadsheet analysis and reporting *** ### Frequently Asked Questions #### How many listings can I scrape? You can scrape all matching listings up to your specified target count. #### Do I need a proxy? Proxies are optional but recommended for high-volume scrapes to prevent rate limits. #### Can I scrape multiple pages? Yes, specify higher page limits to scrape past the first page. #### What fields are captured? Titles, prices, locations, conditions, image URLs, and other key details. #### Can I filter by category? Yes, use a category URL to target specific product groups. *** ### Support For issues or feature requests, contact support through the Apify Console. #### Resources - [Apify Documentation](https://docs.apify.com/) - [API Reference](https://docs.apify.com/api/v2) *** ### Legal Notice This tool is for legitimate data collection. Users are responsible for complying with terms of service and applicable local laws. # Actor input Schema ## `url` (type: `string`): Any supported Quikr URL, including category, tag, search, and location-specific URLs. ## `results_wanted` (type: `integer`): Maximum number of products to save to the dataset. ## `max_pages` (type: `integer`): Best-effort page limit. Quikr does not always expose pagination URLs in its API payloads. ## `proxyConfiguration` (type: `object`): Optional Apify proxy settings. Use proxies if Quikr starts throttling your requests. ## Actor input object example ```json { "url": "https://www.quikr.com/home-lifestyle/Home-Office-Furniture+India+y56f", "results_wanted": 20, "max_pages": 1, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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 = { "url": "https://www.quikr.com/home-lifestyle/Home-Office-Furniture+India+y56f", "results_wanted": 20, "max_pages": 1 }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/quikr-product-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 = { "url": "https://www.quikr.com/home-lifestyle/Home-Office-Furniture+India+y56f", "results_wanted": 20, "max_pages": 1, } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/quikr-product-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 '{ "url": "https://www.quikr.com/home-lifestyle/Home-Office-Furniture+India+y56f", "results_wanted": 20, "max_pages": 1 }' | apify call shahidirfan/quikr-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/quikr-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Quikr Product Scraper 🛍️", "description": "Scrape live product listings from India's Quikr marketplace instantly. Extract prices, seller details, descriptions & images. Ideal for price intelligence, competitive monitoring, inventory tracking, ecommerce research & AI datasets. Fully structured output.", "version": "0.0", "x-build-id": "yQgdqnIargjXxaOKb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~quikr-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-quikr-product-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/shahidirfan~quikr-product-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-quikr-product-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/shahidirfan~quikr-product-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-quikr-product-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": { "url": { "title": "Quikr URL", "type": "string", "description": "Any supported Quikr URL, including category, tag, search, and location-specific URLs." }, "results_wanted": { "title": "Results wanted", "minimum": 1, "type": "integer", "description": "Maximum number of products to save to the dataset.", "default": 20 }, "max_pages": { "title": "Max pages", "minimum": 1, "type": "integer", "description": "Best-effort page limit. Quikr does not always expose pagination URLs in its API payloads.", "default": 1 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify proxy settings. Use proxies if Quikr starts throttling your requests.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```