# Ol — 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 from Ashiq Oman, a leading Arabic job board in Oman, and access detailed information about specific job postings including requirements, salary, and company details. Find your next career opportunity by searching across multiple job categories and positions available in the Omani job market.

**Category:** Jobs | **Website:** [ol.om/jobs](https://ol.om/jobs) | **Docs:** [parse.bot/marketplace/e37d5844-5b33-42af-9bee-75376cb0969e/ol-om-api](https://parse.bot/marketplace/e37d5844-5b33-42af-9bee-75376cb0969e/ol-om-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-ol-om-api-e37d5844/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_job_details

Get full details of a specific job post by its numeric post ID. Returns the complete job posting content including title, publication date (with English month name translation), category, full text and HTML content, featured image URL, and tags.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `post_id` | string | Yes | Numeric post ID from search_jobs results. Found in search_jobs response as jobs[*].post_id field. |

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

### search_jobs

Search or browse job postings on ol.om. When a query is provided, performs a site-wide keyword search. When no query is provided, browses the jobs/training category. Returns paginated results with up to 20 posts per page. Content is in Arabic.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword to filter job posts. When empty, browses all jobs in the jobs/training category. |

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