# Emploitic — 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 job listings and company profiles from Emploitic, with the ability to filter by wilayas, sectors, job functions, and experience levels. Access detailed job information and company hiring data to explore career opportunities and research potential employers.

**Category:** Jobs | **Website:** [emploitic.com/](https://emploitic.com/) | **Docs:** [parse.bot/marketplace/9243451b-448c-4cb7-a592-428c6998ee01/emploitic-com-api](https://parse.bot/marketplace/9243451b-448c-4cb7-a592-428c6998ee01/emploitic-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-emploitic-com-api-9243451b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_company_jobs

Get job listings for a specific company by its slug. Returns paginated job results for the given company, sorted by most recently published.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `slug` | string | Yes | Company alias/slug (obtainable from search_companies results via the alias field). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-emploitic-com-api-9243451b/get_company_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","slug":"<string>"}'
```

### get_company_profile

Get detailed profile of a company by its slug. Returns company information including name, sector, size, location, social links, and company site tabs with content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Company alias/slug (obtainable from search_companies results via the alias field). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-emploitic-com-api-9243451b/get_company_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_job_detail

Get full details of a job posting by its slug. Returns the complete job description, requirements, company info, open positions, and all metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Job alias/slug (obtainable from search_jobs or get_company_jobs results via the alias field). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-emploitic-com-api-9243451b/get_job_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### list_job_functions

List available job functions/categories (métiers) used for classifying job postings on Emploitic.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-emploitic-com-api-9243451b/list_job_functions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_job_levels

List available job position/experience levels on Emploitic.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-emploitic-com-api-9243451b/list_job_levels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_sectors

List available industry sectors used for company classification on Emploitic.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-emploitic-com-api-9243451b/list_sectors \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_wilayas

List Algerian wilayas (provinces/locations) with their IDs. Use these IDs as the location parameter in search_jobs. Returns all 58 wilayas.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-emploitic-com-api-9243451b/list_wilayas \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_companies

Search for companies on the Emploitic platform with optional keyword filter and pagination. Returns company name, alias, sector, location, size, and active job count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Company name or keyword to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-emploitic-com-api-9243451b/search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

### search_jobs

Search for job listings on Emploitic with optional keyword and location filters. Returns paginated results sorted by most recently published. Each result includes title, company, location, contract type, work mode, job level, education level, and profession.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location ID for filtering (obtain IDs from list_wilayas endpoint). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword matching job title, company name, or description. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-emploitic-com-api-9243451b/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","query":"<string>"}'
```