# Jobs Data API (https://www.socialcrawl.dev/platforms/jobs)

> Search open roles on LinkedIn, Indeed, Bing's aggregated listings and Xing, then read the full posting for any id. The search and listing endpoints among the 11 share one job schema with id, title, company and location, and LinkedIn and Indeed rows add a URL. Salary endpoints return min, max, mean and median pay for a job title in a country.

TL;DR: SocialCrawl's Jobs API exposes 11 endpoints, 1 to 10 credits per call, all returning one unified JSON schema with computed fields such as engagement rate, language and content category. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| LinkedIn Search | GET | `/v1/jobs/linkedin/search` | 10 | Search LinkedIn job listings |
| LinkedIn | GET | `/v1/jobs/linkedin` | 5 | Get a LinkedIn job listing by id |
| LinkedIn Organizations | GET | `/v1/jobs/linkedin/organizations` | 1 | Resolve LinkedIn organization ids |
| Indeed Search | GET | `/v1/jobs/indeed/search` | 10 | Search Indeed job listings |
| Indeed | GET | `/v1/jobs/indeed` | 5 | Get an Indeed job listing by id |
| Bing Search | GET | `/v1/jobs/bing/search` | 10 | Search Bing job listings |
| Bing | GET | `/v1/jobs/bing` | 5 | Get a Bing job listing by id |
| Xing Search | GET | `/v1/jobs/xing/search` | 10 | Search Xing job listings |
| Xing | GET | `/v1/jobs/xing` | 5 | Get a Xing job listing by id |
| Salary Titles | GET | `/v1/jobs/salary/titles` | 1 | Suggest job titles for a salary lookup |
| Salary | GET | `/v1/jobs/salary` | 1 | Get salary ranges for a job title and country |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/jobs/linkedin/search" \
  --data-urlencode "query=software engineer" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## FAQ

### Which job boards does the Jobs API cover?

LinkedIn, Indeed, Bing's aggregated listings and Xing, each with a search endpoint and a single-listing endpoint, plus a LinkedIn company lookup and salary endpoints. The search and listing endpoints share one job schema.

### What is the difference between search and single-listing endpoints?

A search endpoint returns a page of listings for a keyword, each with id, title, company and location. LinkedIn and Indeed rows add a URL. Pass a listing id to the matching single-listing endpoint, such as GET /v1/jobs/linkedin, to read the complete description and apply details.

### Does the Jobs API include salary data?

Yes. GET /v1/jobs/salary returns min, max, mean and median pay for a job title in a country, broken out hourly, daily, weekly, monthly and yearly, with the local currency. GET /v1/jobs/salary/titles turns a loose query into a title that salary accepts.

### Which board should I use for the German market?

Xing. Location values work best in German there, and its search endpoint takes location, date, career level, remote and minimum-salary filters. Indeed search takes a required country_code.

### Can I search by employer?

On LinkedIn, yes. GET /v1/jobs/linkedin/organizations turns an employer name into a numeric organization id, and LinkedIn job search accepts those ids as a filter. It matches companies and schools by name, not people.

### How do I page through job results?

Pass the cursor returned with the first page to get the next one. Keep going until a page comes back short or empty. Empty results are not billed, and credits for failed calls are refunded automatically.

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- Is there an API to search job listings across LinkedIn, Indeed and Xing?
- How do I get salary data by job title through an API?
- What is the best API for pulling LinkedIn job postings?