Skip to content
Scrappa Get API key
Lever Jobs API 1 credit/request

Lever Company Jobs API Documentation

GET https://scrappa.co/api/lever/jobs

Lever Company Jobs API Documentation List the open postings of one public Lever company. Each job has the id, title, location, all locations, country, workplace type, remote flag, team, department, commitment (employment type), salary range, posted date, apply link and the full description in HTML and plain text, with the lists (responsibilities, requirements) in extras. Filter by location, team, department and commitment. The filters match a category value exactly and are checked on every returned job. Page with skip and limit (up to 100). The answer has has_more and next_skip. Lever can answer slowly: a call takes 1 to 25 seconds. Cost: 1 credit per successful request. Failed requests and empty answers from a missing board cost nothing.

Lever Company Jobs API Documentation 1 credit/request

Endpoint

Request preview
GET
https://scrappa.co/api/lever/jobs
Auth header
x-api-key
Cost
1 credit/request
company = example
Response preview
200 OK
{
    "data": {
        "jobs": [
            {
                "id": "lever:6ed76ce8-4156-4b60-b120-403538bd66cd",
                "team": "Administrative",
                "title": "Administrative Business Partner",
                "remote": false,
                "salary": null,
                "company": {
                    "name": null,
                    "slug": "palantir"
                },
                "location": {
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

6 optional filters available.

company string Required

Lever company slug, e.g. palantir (from jobs.lever.co/palantir).

Example value example
skip integer Optional

Number of postings to skip, 0 to 10000. Default: 0.

Example value 10
limit integer Optional

Postings per page, 1 to 100. Default: 20.

Example value 10
location string Optional

Exact location value, e.g. Singapore, Singapore.

Example value Austin, Texas
team string Optional

Exact team value.

Example value example
department string Optional

Exact department value.

Example value example
commitment string Optional

Exact commitment value, e.g. Full-time.

Example value example

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "jobs": [
            {
                "id": "lever:6ed76ce8-4156-4b60-b120-403538bd66cd",
                "team": "Administrative",
                "title": "Administrative Business Partner",
                "remote": false,
                "salary": null,
                "company": {
                    "name": null,
                    "slug": "palantir"
                },
                "location": {
                    "raw": "Singapore, Singapore",
                    "country": "SG"
                },
                "workplace_type": "hybrid",
                "employment_type": "full_time"
            }
        ],
        "company": "palantir",
        "pagination": {
            "skip": 0,
            "count": 1,
            "limit": 20,
            "has_more": false,
            "next_skip": null
        }
    },
    "meta": {
        "credits": 1,
        "billable": true
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A required query parameter is missing or invalid. This response is not billable.

{
    "errors": {
        "param": [
            "A Lever company slug is required, e.g. palantir (from jobs.lever.co/palantir)."
        ]
    },
    "message": "The request validation failed"
}
404

Not Found

The board, company or job does not exist. This response is not billable.

{
    "error": {
        "code": "not_found",
        "message": "No Lever company found for 'unknown-company'."
    },
    "success": false
}
503

Upstream Error

The job board did not answer. Try again shortly. This response is not billable.

{
    "error": {
        "code": "upstream_error",
        "message": "The job board did not answer. Try again shortly."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.