WorkIndia Candidate Scraper

Extract candidate profiles from WorkIndia — India's largest blue & grey collar hiring platform with 300K+ active candidates across delivery, sales, technician, housekeeping, driver, cook, teacher, security and 40+ other categories.

---

How It Works

WorkIndia exposes a candidate search API used by its employer dashboard. This actor calls it directly:

GET https://api.workindia.in/api/employer/view-candidate/search/
    ?search={JSON}&limit=10&offset=0

The search parameter is a JSON object with city, industry, job title and sort options. Pagination uses offset increments.

---

Input

{
  "jobTitles": ["Delivery Executive", "IT Technician/Network Technician"],
  "cities": ["mumbai", "delhi", "bangalore"],
  "industries": [],
  "sortNew": true,
  "maxCandidates": 200,
  "maxPages": 20,
  "pageSize": 10,
  "requestDelay": 400,
  "maxConcurrency": 1
}

Parameters

Parameter	Type	Default	Description
jobTitles	array	[]	Exact job title strings from WorkIndia (see list below)
cities	array	[]	City slugs (lowercase)
industries	array	[]	Industry slugs — auto-inferred from job title if empty
sortNew	boolean	true	Sort by newest candidates first
sortActive	boolean	false	Sort by most recently active
sortLocation	boolean	false	Sort by proximity
maxCandidates	integer	200	Total candidates cap (0 = unlimited)
maxPages	integer	20	Pages per task (each page = 10 candidates)
pageSize	integer	10	Candidates per API call
requestDelay	integer (ms)	400	Delay between requests
maxConcurrency	integer	1	Parallel tasks (keep low)

---

City Slugs

Use these exact lowercase values:

Slug	City
mumbai	Mumbai
delhi	Delhi / NCR
bangalore	Bengaluru
pune	Pune
hyderabad	Hyderabad
chennai	Chennai
kolkata	Kolkata
ahmedabad	Ahmedabad
surat	Surat
jaipur	Jaipur
lucknow	Lucknow
indore	Indore
nagpur	Nagpur
chandigarh	Chandigarh
kochi	Kochi
trivandrum	Trivandrum
vadodara	Vadodara
nashik	Nashik
coimbatore	Coimbatore
bhopal	Bhopal
patna	Patna
gurgaon	Gurgaon
noida	Noida
goa	Goa

---

Job Title List (Selection)

Delivery & Logistics

Delivery Executive, Delivery Boy, Courier Delivery, Food Delivery

Sales

Sales Executive - Field Sales, Field Sales Executive, Medical Representative - Field Sales, Insurance Sales, Real Estate Sales

Technician

IT Technician/Network Technician, Electrician, AC Technician, Mobile Technician, Plumber, CCTV Technician, Elevator Technician

Driver

Car Driver, Cab Driver, Truck Driver, Bus Driver, Ola / Uber Driver

Housekeeping & Hotel

Housekeeping Staff, Housekeeping Executive, Hotel Receptionist, Waiter, Kitchen Helper

Security

Security Guard, Security Guard (Night Shift), Watchman, Bouncer

IT & Software

Software Developer, Python Developer, Web Developer, Full Stack Developer, Android Developer, PHP Developer

Teaching

Teacher, Computer Teacher, English Teacher, Tutor, Maths Teacher

HR & Admin

HR Executive, HR Recruiter, Data Entry Operator, Computer Operator, Office Admin

Telecalling

Telecaller, Customer Care Executive, BPO Executive, Call Center Executive

---

Output

Example record:

{
  "candidateId": "bc8e58428ab06be20e5a7859b03139cba1f1ba761800a4163004e93316050443",
  "fullName": "Ashique Billa",
  "age": 20,
  "gender": "male",
  "location": "Nerul",
  "city": "mumbai",
  "qualification": "< 10th Pass",
  "englishLevel": "No English",
  "totalExperience": "Fresher",
  "yearsOfExperience": null,
  "previousJobTitle": null,
  "previousCompany": null,
  "skills": null,
  "sectors": null,
  "languages": ["Hindi", "Bengali"],
  "assets": ["Bike", "Aadhar Card", "PAN Card"],
  "isLookingUrgently": false,
  "isMobileVerified": true,
  "isUnlocked": false,
  "mobileNo": null,
  "hasResume": false,
  "profilePicUrl": null,
  "matchScore": 86,
  "hotLeadStatus": "old_lead",
  "lastSeen": "2026-04-15T16:52:49Z",
  "joinDate": "2026-04-15",
  "searchJobTitle": "Delivery Executive",
  "searchCity": "mumbai",
  "scrapedAt": "2026-04-16T08:00:00.000Z"
}

Notes

• mobileNo is null for locked candidates — WorkIndia requires an employer account to unlock contact details
• matchScore 0–100 — WorkIndia's internal relevance score
• hotLeadStatus: new_lead = joined recently, old_lead = existing profile
• isUnlocked: only true if viewed via authenticated employer session (this actor scrapes public search)

---

Use Cases

• Talent pipeline building — find and screen candidates before paying to unlock
• Market research — candidate availability and skills distribution by city
• Workforce analytics — experience levels, qualification spread in blue collar market
• Salary benchmarking — understand supply/demand by role and city
• Hiring automation — feed into ATS or internal candidate databases

---

Cost & Performance

~0.004 CU per 100 candidates. No browser overhead — pure API calls.

---

Changelog

Version	Date	Notes
1.0.0	2026-04-16	Initial release — direct API, job title × city search, full candidate parsing