# Jobs (/docs/jobs)

Search job listings across LinkedIn, Indeed, Bing, and Xing, plus salary ranges, through one unified API

Search job listings across LinkedIn, Indeed, Bing, and Xing, plus salary ranges for a title and country. Every listing is normalised to the same Job shape, so one parser covers every board.

Base URL: `/v1/jobs/...`

## Quickstart

### Search LinkedIn openings

```bash
curl "https://www.socialcrawl.dev/v1/jobs/linkedin/search?query=software%20engineer&location=United%20States&date_posted=week" \
  -H "x-api-key: YOUR_API_KEY"
```

Each row has a job id, title, company, location, posting date, and listing URL. Pass `cursor` from the response to get the next page.

### Read the full description

```bash
curl "https://www.socialcrawl.dev/v1/jobs/linkedin?id=4460359588" \
  -H "x-api-key: YOUR_API_KEY"
```

The detail call adds the description, employment type, seniority, and applicant count.

### Search Indeed, Bing, or Xing the same way

Indeed requires `country_code` on page 1 (ISO 3166-1 alpha-2). Bing requires `location` on page 1. Xing prefers German place names. Salary lookups take a title plus `country_code`; call `salary/titles` first if the title is uncertain.

## Endpoints

## Notes

- Job search is 10 credits per call. Detail is 5. Organization lookup and salary are 1.
- Empty lists and missing jobs are refunded.
- Bing list rows do not include an apply URL. Call `GET /v1/jobs/bing` with the id for the description and apply link.
- This surface does not replace `/v1/linkedin/search/jobs`. That LinkedIn-native search still exists for Easy Apply, company job lists, and company ids.