jobs.lk APIjobs.lk ↗
Search Sri Lanka job vacancies, retrieve detailed listings, and browse categories via the TopJobs.lk API. Includes employer email, closing dates, and apply links.
curl -X POST 'https://api.parse.bot/scraper/38dde6af-0fbb-4015-b446-25b7b99f9fea/search_jobs' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{}'Search for open job vacancies by keyword and/or job category. Returns a paginated list of job listings with position title, employer, dates, and location. At least one of keyword or category must be provided.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| keyword | string | Search keyword to find jobs (e.g. 'engineer', 'accountant', 'marketing'). At least one of keyword or category must be provided. |
| category | string | Job category code to filter results. Use list_categories endpoint to get valid codes. Examples: SDQ (IT-Sware/DB/QA/Web/Graphics/GIS), HNS (IT-HWare/Networks/Systems), ACA (Accounting/Auditing/Finance), BAF (Banking & Finance/Insurance), SMM (Sales/Marketing/Merchandising), HAT (HR/Training), COM (Corporate Management/Analysts), OAS (Office Admin/Secretary/Receptionist), CCE (Civil Eng/Interior Design/Architecture), ITT (IT-Telecoms), CUR (Customer Relations/Public Relations), LWT (Logistics/Warehouse/Transport), MAE (Eng-Mech/Auto/Elec), POS (Manufacturing/Operations), MAC (Media/Advert/Communication), HRF (Hotel/Restaurant/Hospitality), HOT (Travel/Tourism), SRF (Sports/Fitness/Recreation), MHN (Medical/Nursing/Healthcare), LEL (Legal/Law), SQC (Supervision/Quality Control), APC (Apparel/Clothing), AIM (Ticketing/Airline/Marine), TAL (Education), RLT (R&D/Science/Research), AGD (Agriculture/Dairy/Environment), SEC (Security), BEC (Fashion/Design/Beauty), IDV (International Development), KPO (KPO/BPO), IME (Imports/Exports). At least one of keyword or category must be provided. |
{
"type": "object",
"fields": {
"jobs": "array of job listing objects with job_ref_no, position, employer, job_description, opening_date, closing_date, town, job_code",
"total_jobs": "integer",
"total_pages": "integer",
"current_page": "integer"
},
"sample": {
"jobs": [
{
"town": "Colombo",
"employer": "Commercial Bank",
"job_code": "0001512058",
"position": "AIOps & Automation Engineer",
"job_ref_no": "1512058",
"closing_date": "Sat Jun 27 2026",
"opening_date": "Sun Jun 14 2026",
"job_description": "Please refer the vacancy"
}
],
"total_jobs": 453,
"total_pages": 1,
"current_page": 1
}
}About the jobs.lk API
The jobs.lk API provides access to job vacancy data from TopJobs.lk, Sri Lanka's primary online job portal, through 3 endpoints. Use search_jobs to query openings by keyword or category code, get_job_details to retrieve employer contact email, apply links, and closing dates for a specific vacancy, and list_categories to enumerate all valid category codes for filtered searches.
Search and Filter Job Listings
The search_jobs endpoint accepts a keyword (e.g. "engineer", "accountant") and/or a category code to return a paginated list of matching vacancies. At least one of the two parameters is required. Each result object includes job_ref_no, position, employer, job_description, opening_date, closing_date, town, and job_code. Pagination is controlled via the page parameter, with total_jobs, total_pages, and current_page returned alongside the results so you can iterate through large result sets.
Job Detail and Employer Contact
Passing a job_ref_no — obtained from search_jobs results — to get_job_details returns the full record for that vacancy: employer, position, job_type, location, locations (array for multi-location roles), date_posted, closing_date, company_email, and apply_links. The company_email field is particularly useful for direct outreach or recruiter contact workflows, and apply_links provides direct application URLs where the employer has listed them.
Category Codes
The list_categories endpoint takes no inputs and returns an array of objects, each with a code and name. Category codes like SDQ (IT/Software) are passed as the category parameter in search_jobs. Fetching this list first is the recommended approach before running category-filtered searches, since codes are not human-readable.
- Build a Sri Lanka-focused job aggregator that surfaces new TopJobs.lk listings by keyword each day.
- Track closing dates across multiple job categories to alert candidates before deadlines pass.
- Extract company_email fields to build a recruiter contact database segmented by industry category.
- Monitor specific employer names in search_jobs results to watch hiring activity over time.
- Power a category-browse UI by pre-loading all codes and names from list_categories.
- Identify multi-location roles by checking the locations array in get_job_details for vacancies that appear in search results.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.