# Shine — 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 discover job listings on Shine.com with detailed information including job descriptions, categories, locations, and top hiring companies. Find similar job opportunities and explore roles across different industries and geographical areas to match your career goals.

**Category:** Jobs | **Website:** [shine.com/](https://shine.com/) | **Docs:** [parse.bot/marketplace/1503f992-7b04-4236-aa87-d34bbe5795a6/shine-com-api](https://parse.bot/marketplace/1503f992-7b04-4236-aa87-d34bbe5795a6/shine-com-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/shine/`
**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 job categories

Retrieve available job industry/functional categories with current job counts from Shine.com. Category IDs can be used as the 'industry' parameter in search_jobs. Returns all categories sorted by job count descending.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/shine/get-job-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get job details

Get full details of a specific job listing by its slug. Returns structured job data extracted from the page's JSON-LD markup. Returns stale_input with kind 'input_not_found' if the job has expired or been removed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_slug` | string | Yes | Job slug from search_jobs results (format: title-slug/company-slug/numeric-id, e.g. 'software-engineer/acme-corp/12345678'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/shine/get-job-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"job_slug":"<string>"}'
```

### Get locations list

Retrieve list of available locations with current job counts from Shine.com. Location names can be used as the 'location' parameter in search_jobs. Returns locations sorted by job count descending.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/shine/get-locations-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get top searches

Retrieve the most popular job search categories and links currently trending on Shine.com, including work-from-home and location-specific searches. Useful for discovering popular search terms.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/shine/get-top-searches \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search jobs

Search for job listings on Shine.com by keyword, location, experience, salary, industry, or company. Returns paginated results with 20 jobs per page. When no filters are provided, returns all available jobs. The company parameter overrides query when provided.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company` | string | No | Company name to filter by (e.g. 'Capgemini'). Overrides query when provided. |
| `experience` | string | No | Minimum experience in years as a numeric string (e.g. '2', '4'). |
| `industry` | string | No | Industry ID from get_job_categories (e.g. '18' for IT Services & Consulting, '6' for BFSI). |
| `location` | string | No | Location name to filter by (e.g. 'Bangalore', 'Delhi', 'Hyderabad'). Values from get_locations_list. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword (e.g. 'Python Developer', 'data analyst'). Converted to URL slug format internally. |
| `salary` | string | No | Minimum salary ID filter. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/shine/search-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"company":"<string>","experience":"<string>","industry":"<string>","location":"<string>","page":"<integer>","query":"<string>","salary":"<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.