REST API / Scrape

Scrape open roles

Open roles from a company's careers page, on its own site or a job board it links to: title, link, team, location and posted date when the page shows them.

POST/v1/scrape/jobsMCP: scrape_jobs

Scrape units

1 per page read

Plans

Paid plans with scrape units

No careers page

0 units

Body parameters

domainstring

Company domain, e.g. "northwind.io".

urlstring

The careers page or job board, if you know it. Overrides domain.

max_pagesinteger

1–10. Default 3.

How roles are found

The careers page is found from the site map (paths like /careers or /jobs, shortest first) or from a Greenhouse, Lever, Ashby or Workable board. If it links to a board, the board is read too. When roles are spread over several pages, pages below the careers path are read, up to max_pages.

Response

domain, careers_url, jobs (each with title, url, team, location, posted, source and found_on), count, units_used and scraped_at. Then usage with scrape_units_counted and scrape_units_left, and request_id.

team, location and posted are null when the page doesn't show them. source is where the role is listed: greenhouse, lever, ashby, workable, recruitee, smartrecruiters, bamboohr or site.

Errors

Status	type	Meaning
`400`	`invalid_request`	A value isn't valid. The message names the field in `param`.
`401`	`unauthorized`	Missing, invalid, expired or revoked key. See Authentication.
`402`	`scrape_units_exhausted`	No scrape units left. Add a pack in Billing.
`403`	`forbidden`	Free plan: scraping isn't included, and the body has `upgrade_url`. Also returned for read-only keys.
`404`	`not_found`	No careers page found. Nothing was counted.
`503`	`unavailable`	Scraping is busy or down. Nothing was counted. See Retry-After.

Previous
← scrape_companyNext
GET /jobs/{id} →

Was this page useful? Tell us

cURLTypeScriptPython

curl https://api.leadsets.ai/v1/scrape/jobs \
  -H "Authorization: Bearer $LEADSETS_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3d9f…" \
  -d '{
    "domain": "northwind.io"
  }'

import { Leadsets } from "@leadsetsai/sdk";

const ls = new Leadsets(process.env.LEADSETS_KEY);
const res = await ls.scrape.jobs({
  domain: "northwind.io",
});

import os
from leadsets import Leadsets

ls = Leadsets(os.environ["LEADSETS_KEY"])
res = ls.scrape.jobs(
    domain="northwind.io",
)

Response200 OK

{
  "domain": "northwind.io",
  "careers_url": "https://northwind.io/careers",
  "jobs": [
    { "title": "Senior Account Executive",
      "url": "https://boards.greenhouse.io/northwind/jobs/4821930",
      "team": "Sales", "location": "New York, NY", "posted": null,
      "source": "greenhouse",
      "found_on": "https://boards.greenhouse.io/northwind" }
  ],
  "count": 1,
  "units_used": 2,
  "scraped_at": "2026-11-11T09:41:17Z",
  "usage": { "scrape_units_counted": 2, "scrape_units_left": 995 },
  "request_id": "req_b71c3e0a9d52"
}