# Jobz — 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.

> Access real-time job listings from jobz.pk and filter by category, city, organization, newspaper, province, and sector to find positions that match your needs. Get detailed job information, browse government and overseas opportunities, and explore company profiles all in one place.

**Category:** Jobs | **Website:** [jobz.pk/](https://jobz.pk/) | **Docs:** [parse.bot/marketplace/03cfccfe-f817-4a3b-aa86-6035d10e1dba/jobz-pk-api](https://parse.bot/marketplace/03cfccfe-f817-4a3b-aa86-6035d10e1dba/jobz-pk-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-jobz-pk-api-03cfccfe/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_company_list

Get a list of companies that have posted jobs on jobz.pk. Returns company names and profile URLs.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobz-pk-api-03cfccfe/get_company_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_government_jobs_by_province

Get government jobs filtered by province. Returns paginated job listings for the specified province.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `province` | string | Yes | Province name in lowercase |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobz-pk-api-03cfccfe/get_government_jobs_by_province \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","province":"<string>"}'
```

### get_job_detail

Get full details for a specific job by its URL. Returns structured metadata including title, organization, location, education requirements, industry, expected last date, and other fields available on the job detail page. Fields vary per listing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full job detail URL from jobz.pk (e.g. https://www.jobz.pk/some-job_jobs-123456.html) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobz-pk-api-03cfccfe/get_job_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_jobs_by_category

Get jobs filtered by category. Returns paginated job listings for the specified category. Categories map to URL paths on jobz.pk.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category name used in the URL path |
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobz-pk-api-03cfccfe/get_jobs_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### get_jobs_by_city

Get jobs filtered by city. Returns paginated job listings for the specified city.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name in lowercase (e.g. karachi, lahore, islamabad, peshawar, rawalpindi) |
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobz-pk-api-03cfccfe/get_jobs_by_city \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","page":"<integer>"}'
```

### get_jobs_by_newspaper

Get jobs filtered by newspaper source. Returns paginated job listings from the specified newspaper.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `newspaper` | string | Yes | Newspaper name in lowercase (e.g. jang, express, dawn, nawaiwaqt) |
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobz-pk-api-03cfccfe/get_jobs_by_newspaper \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"newspaper":"<string>","page":"<integer>"}'
```

### get_jobs_by_organization

Get jobs filtered by organization. Returns paginated job listings for the specified organization.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `org` | string | Yes | Organization name or acronym in lowercase (e.g. fpsc, ppsc, paf, police, nts, army) |
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobz-pk-api-03cfccfe/get_jobs_by_organization \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"org":"<string>","page":"<integer>"}'
```

### get_jobs_by_sector

Get jobs filtered by industry sector. Returns paginated job listings for the specified sector.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `sector` | string | Yes | Sector name in lowercase (e.g. engineering, medical, bank, teaching, it) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobz-pk-api-03cfccfe/get_jobs_by_sector \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","sector":"<string>"}'
```

### get_latest_jobs

Extract latest job listings from the jobz.pk homepage. Returns all currently displayed jobs with title, URL, industry, city, date posted, and vacant positions. No filtering or pagination — returns whatever the homepage currently shows.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobz-pk-api-03cfccfe/get_latest_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_overseas_jobs

Get overseas job listings, optionally filtered by country. Returns paginated results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country name in lowercase with hyphens (e.g. saudi-arabia, uae, qatar, oman). Omitting returns all overseas jobs. |
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobz-pk-api-03cfccfe/get_overseas_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","page":"<integer>"}'
```

### search_jobs

Search for jobs by keyword. Submits a search query and returns matching job listings with title, URL, industry, city, date posted, and vacant positions. Results are not paginated — returns the first page of results from the site's search.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword such as job title, organization name, or skill |

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