🧠 Quikr Product Scraper - API Based

This Apify actor retrieves product listings from Quikr classifieds through the Quikr search API. Search by category, brand, product type, and city to collect structured product information including name, price, condition, and contact details. Perfect for market research, price comparison, and product intelligence.

✅ Use Cases

• 📇 Gather product listings with pricing data
• 💬 Build product catalogs for comparison platforms
• 🏙️ Conduct market research by location and category
• 🧭 Perform competitive analysis in your niche
• 📊 Gather structured product intelligence from Quikr

📥 Input Configuration

You can customize the actor using the following input fields:

{
    "category": "mobiles-tablets",
    "brands": ["Samsung", "Apple"],
    "productType": "Mobile-Phones",
    "city": "Dindigul",
    "cityId": "w1098473fd",
    "maxRequests": 5
}

🧾 Fields Explained

Field	Type	Description
category	string	Product category on Quikr (e.g., 'mobiles-tablets', 'electronics-appliances')
brands	array	Array of brand names to search for (e.g., ['Samsung', 'Apple'])
productType	string	Type of product (e.g., 'Mobile-Phones', 'Laptops')
city	string	City name for location-based search
cityId	string	Quikr city ID (found in URL)
maxRequests	number	Maximum number of API requests to make

📤 Output

The actor returns a dataset containing structured product records from Quikr. Each record includes comprehensive details about the product, suitable for price analysis, market research, and product intelligence.

🧩 Sample Output

{
    "entityId": "15471",
    "title": "Apple iPhone X",
    "brand": "Apple",
    "model": "Apple iPhone X",
    "description": "- 3GB RAM | 64GB ROM\n- 5.8 inch HD Display\n- 12MP Primary Camera | 7MP Front",
    "price": 7999,
    "displayPrice": 45541,
    "currency": "INR",
    "condition": "Used",
    "numberOfAds": 310,
    "imageUrl": "https://teja10.kuikr.com/i6/20171228/VB201705171774173-ak_LWBP77997365-1514461008.jpeg",
    "productUrl": "https://www.quikr.com/mobiles-tablets/Apple+iPhone-X+Mobile-Phones+Dindigul+EntityIdZ15471fde",
    "category": "Mobile Phones"
}

📋 Output Fields

Field	Type	Description
entityId	string	Unique Quikr product entity identifier
title	string	Product title/name
brand	string	Product brand name
model	string	Product model name
description	string	Product description with specs
price	number	Starting price in INR
displayPrice	number	Display/market price in INR
currency	string	Currency code (INR)
condition	string	Product condition (Used/New)
numberOfAds	integer	Number of listings available
imageUrl	string	Product image URL
productUrl	string	Direct link to Quikr product page
category	string	Product category

🔍 Data Source

• ✓ Data fetched exclusively via Quikr search API (HTTP POST requests)
• ✓ JSON response parsing with HTML content extraction
• ✓ Verified product information directly from Quikr
• ✓ Automatic filtering and deduplication

🔒 Proxy Configuration

This actor uses standard HTTP headers with optional proxy support for:

• Avoiding IP-based rate limiting or bans
• Accessing location-specific data
• Ensuring stable data retrieval at scale

Configure proxy settings in Apify:

{
  "useApifyProxy": true,
  "apifyProxyGroups": ["RESIDENTIAL"],
  "apifyProxyCountry": "IN"
}

🚀 How to Use

1. Open the actor in Apify Console
2. Click "Try actor" or create a new task
3. Enter your search parameters (category, brands, city)
4. Configure maximum requests
5. Run the actor
6. Download results in JSON, CSV, or Excel format

⚙️ Advanced Input Example

{
    "category": "mobiles-tablets",
    "brands": ["Samsung", "Apple", "OnePlus"],
    "productType": "Mobile-Phones",
    "city": "Mumbai",
    "cityId": "w1098463fd",
    "maxRequests": 10
}

🛠️ Tech Stack

• Apify SDK — actor orchestration and data handling
• Node.js 18+ — runtime environment with native fetch API
• Quikr Search API — exclusive data source for product information

📊 Data Processing Features

• ✓ Automatic duplicate detection using Entity IDs
• ✓ Structured data parsing from HTML responses
• ✓ Comprehensive logging and error handling
• ✓ Schema validation for all output records

🔧 Local Development

Installation

$npm install

Running the Actor

$npm start

Validation

Validate all generated datasets against the schema:

$node validate-datasets.js

Code Quality

Format code:

$npm run format

Check linting:

$npm run lint

📂 Project Structure

.
├── .actor/                          # Actor configuration
│   ├── actor.json                  # Actor metadata
│   ├── input_schema.json           # Input parameters schema
│   ├── dataset_schema.json         # Output dataset schema
│   ├── input.json                  # Default input
│   ├── input-local.json            # Local development input
│   └── input-production.json       # Production input
├── src/
│   └── main.js                     # Main actor script
├── storage/
│   └── datasets/default/           # Generated datasets
├── package.json                    # Dependencies
├── validate-datasets.js            # Dataset validator
└── README.md                       # This file

🤝 Support

For issues, questions, or feature requests, please refer to the Apify documentation or contact support.