HotNigerianJobs 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.
What is the HotNigerianJobs 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.
curl -X GET 'https://api.parse.bot/scraper/d41feb62-afc3-401a-a12e-3bf6c0b5cf31/search_jobs?query=engineer' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace hotnigerianjobs-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: HotNigerianJobs SDK — search, list, and drill into job details."""
from parse_apis.hotnigerianjobs_api import HotNigerianJobs, JobNotFound
client = HotNigerianJobs()
# Search for engineering jobs — limit caps total items fetched.
for job in client.jobsummaries.search(query="engineer", limit=5):
print(job.title, job.job_id)
# List recent jobs, take the first one, then drill into its full details.
summary = client.jobsummaries.list(limit=1).first()
if summary:
detail = summary.details()
print(detail.title, detail.location, detail.salary)
print("Requirements:", detail.requirements)
print("Recruiter:", detail.recruiter.name)
# Typed error handling when a job URL is no longer valid.
try:
stale = client.jobsummaries.list(limit=1).first()
if stale:
stale.details()
except JobNotFound as exc:
print(f"Job gone: {exc.url}")
print("exercised: jobsummaries.search / jobsummaries.list / details / JobNotFound")
Full-text search for job listings by keyword. Returns job summaries matching the query, ordered by relevance. Each result contains a title, URL, and job_id. The URL can be passed to get_job_details for full information. Pagination is not supported; all matches for the query are returned in a single page.
| 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/907795/eastern-western-hospital-job-recruitment-5-positio.html",
"title": "Eastern & Western Hospital Job Recruitment (5 Positions)",
"job_id": "907795"
}
],
"query": "engineer"
},
"status": "success"
}
}About the HotNigerianJobs API
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.
The HotNigerianJobs API is a managed, monitored endpoint for hotnigerianjobs.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when hotnigerianjobs.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official hotnigerianjobs.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.