# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/jobz/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/jobz/get-company-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/jobz/get-government-jobs-by-province \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/jobz/get-job-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/jobz/get-jobs-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/jobz/get-jobs-by-city \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/jobz/get-jobs-by-newspaper \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/jobz/get-jobs-by-organization \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/jobz/get-jobs-by-sector \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/jobz/get-latest-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/jobz/get-overseas-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/jobz/search-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.