hotnigerianjobs.com APIhotnigerianjobs.com ↗
Access Nigerian job listings via 3 endpoints. Search by keyword, paginate all jobs, and fetch full details including salary, requirements, and recruiter info.
curl -X GET 'https://api.parse.bot/scraper/d41feb62-afc3-401a-a12e-3bf6c0b5cf31/search_jobs?query=engineer' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for job listings by keyword on hotnigerianjobs.com. Returns a list of matching job summaries with titles, URLs, and IDs.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword for job listings (e.g. 'engineer', 'accountant', 'data analyst'). |
{
"type": "object",
"fields": {
"jobs": "array of job summary objects each containing title, url, and job_id",
"query": "string, the search keyword used"
},
"sample": {
"data": {
"jobs": [
{
"url": "https://www.hotnigerianjobs.com/hotjobs/897418/vaste-holdings-limited-job-recruitment-6-positions.html",
"title": "Vaste Holdings Limited Job Recruitment (6 Positions)",
"job_id": "897418"
}
],
"query": "engineer"
},
"status": "success"
}
}About the hotnigerianjobs.com API
The HotNigerianJobs.com API exposes 3 endpoints for searching and retrieving job listings from one of Nigeria's active job boards. The search_jobs endpoint accepts a keyword and returns matching job titles with their URLs and IDs, while get_job_details pulls structured data including salary, location, experience level, requirements, benefits, and recruiter name, logo, and website for any listing URL.
Endpoints and What They Return
The API covers three operations against the HotNigerianJobs.com job board. search_jobs takes a query string — such as 'engineer', 'accountant', or 'data analyst' — and returns an array of job summary objects, each with a title, url, and job_id. list_jobs accepts an optional page integer (starting at 0) and returns a paginated batch of the same summary structure ordered by recency. Both endpoints are designed as entry points to get the url values needed for the detail call.
Detailed Job Data
get_job_details takes a full job listing URL obtained from either search_jobs or list_jobs and returns the complete record for that listing. Response fields include title, level (experience level), location, salary, description (full text), requirements (as an array of strings), and benefits (also an array). The recruiter object provides the hiring organization's name, logo_url, and website, making it straightforward to associate listings with specific employers.
Pagination and Search Scope
list_jobs pages are zero-indexed. Passing no page parameter returns the first page. Each page returns a batch of the most recently posted listings, so incrementing the page value steps through the full job board inventory. There is no built-in filter by location, job category, or salary range within list_jobs — filtering by those dimensions requires fetching details per listing or using search_jobs with targeted keywords.
- Aggregate Nigerian job listings into a regional employment dashboard using
list_jobsfor broad coverage - Build a keyword-based job alert tool using
search_jobsto monitor new postings for roles like 'data analyst' or 'nurse' - Extract recruiter details (name, website, logo) from
get_job_detailsto build a directory of Nigerian hiring companies - Parse the
requirementsarray fromget_job_detailsto analyze the most common skills demanded across Nigerian job postings - Compare salary fields across listings fetched via
get_job_detailsto track compensation trends by role or location - Feed job
benefitsarrays into an HR research tool to benchmark what Nigerian employers offer
| 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.
Does HotNigerianJobs.com have an official developer API?+
What does `get_job_details` return for recruiter information?+
recruiter object contains three fields: name (the hiring organization's name), logo_url (a URL pointing to the organization's logo image), and website (the recruiter's web address). This data comes directly from the listing page for that job.Can I filter `list_jobs` by location, job category, or salary range?+
list_jobs returns listings ordered by recency and supports only page-based pagination — it does not accept location, category, or salary filters. Filtering by those dimensions requires calling get_job_details on individual listings to inspect the location and salary fields, or using targeted keywords in search_jobs. You can fork this API on Parse and revise it to add a filtered listing endpoint.Does the API cover job listings outside Nigeria?+
What does the `applicants` field in `get_job_details` contain?+
applicants field is returned as an array in the response schema. The content depends on what the specific listing exposes — not all listings populate this field. Fields like requirements, benefits, salary, and description are more consistently populated across listings.