# Hotnigerianjobs — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse Nigerian job listings with detailed company information and job requirements all in one place. Discover employment opportunities by filtering through available positions and accessing comprehensive details about roles and hiring companies.

**Category:** Jobs | **Website:** [hotnigerianjobs.com/](https://hotnigerianjobs.com/) | **Docs:** [parse.bot/marketplace/6d91b22f-6bd3-464e-b7f9-236f0e587dd9/hotnigerianjobs-com-api](https://parse.bot/marketplace/6d91b22f-6bd3-464e-b7f9-236f0e587dd9/hotnigerianjobs-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-hotnigerianjobs-com-api-6d91b22f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_job_details

Get detailed information for a specific job listing including full description, requirements, benefits, location, salary, education requirements, and recruiter information. The url parameter must be a job listing URL obtained from search_jobs or list_jobs results. Single-position pages include structured JSON-LD data; multi-position summary pages return the full text description with sub-position links.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full job listing URL from search_jobs or list_jobs results (e.g. 'https://www.hotnigerianjobs.com/hotjobs/907792/nursing-assistant-at-eastern-western-hospital.html'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hotnigerianjobs-com-api-6d91b22f/get_job_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### list_jobs

List all job listings with pagination. Each page returns a batch of job summaries ordered by recency. Page index is zero-based. Returns job summaries with title, URL, and job_id that can be passed to get_job_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page index (zero-based). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hotnigerianjobs-com-api-6d91b22f/list_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### search_jobs

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword for job listings (e.g. 'engineer', 'accountant', 'data analyst'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hotnigerianjobs-com-api-6d91b22f/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```