ScraperCity logo

Job Scraper API Documentation

Job Scraper

Every job post for a job title and a location from LinkedIn Jobs and Indeed, one row per job: the job title, company, location, date posted and job link, the company's website, LinkedIn page, size and industry, and the company's decision maker from the Lead Database (name, title, email, mobile and LinkedIn) where one matches. A job posted on both boards comes once. For one row per company hiring for a role, use Signals with type hiring.

$0.0009 per job post, decision maker included; minimum charge per searchPOST /api/v1/scrape/job-scraper

Parameters

NameTypeRequiredDescription
jobTitlestringRequiredThe job title to search, as you would type it on a job boardExample: Controller
locationstringOptionalCity, state or region the jobs are in (default: anywhere in the country)Example: Austin, TX
countrystringOptionalTwo-letter country codeDefault: USExample: US
postedWithinstringOptional24h, 7d or 30dDefault: 7dExample: 7d
sourcesstring[]OptionalJob boards: linkedin and/or indeed (default: both)Default: ["linkedin","indeed"]Example: ["linkedin", "indeed"]
maxResultsnumberOptionalThe most job posts to return (default 100, up to 20,000)Default: 100Example: 500

Examples

Every Controller job in Texas posted this week, with decision makers

curl -X POST https://app.scrapercity.com/api/v1/scrape/job-scraper \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jobTitle": "Controller",
    "location": "Texas",
    "postedWithin": "7d",
    "maxResults": 500
  }'

Indeed jobs only, last 24 hours, in the United Kingdom

curl -X POST https://app.scrapercity.com/api/v1/scrape/job-scraper \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jobTitle": "Bookkeeper",
    "country": "GB",
    "postedWithin": "24h",
    "sources": ["indeed"],
    "maxResults": 200
  }'

Check status and download

curl -X GET https://app.scrapercity.com/api/v1/scrape/status/{runId} \
  -H "Authorization: Bearer YOUR_API_KEY"

# When status is SUCCEEDED, download the CSV
curl -L https://app.scrapercity.com/api/downloads/{runId} -o job-posts.csv

Use Cases

  • •Staffing and recruiting agencies: every open role in your niche, with the hiring manager's contact
  • •Sales teams selling to companies that are growing the team their product serves
  • •Job boards and market research: fresh job posts by title, place and date across two boards in one file
  • •Outreach timed to a hire: reach the decision maker while the job is open

Best Practices

  • •Use the title the way companies write it in job posts (Controller, Registered Nurse, Account Executive)
  • •Add a city or state for local roles; leave location empty to search nationwide
  • •Searches usually take 2-10 minutes; big searches (several thousand jobs) take up to an hour
  • •Charged per job post returned. A search that costs more to run than its job posts at the price is charged the minimum for the search
  • •CSV columns: job_title, company_name, job_location, posted_at, job_url, source, domain, company_linkedin_url, company_size, industry and contact_* columns (the company's decision maker)

Every scrape returns a runId. Poll GET /api/v1/scrape/status/{runId} until it completes, then download via GET /api/downloads/{runId}?format=csv.

Authenticate every request with Authorization: Bearer YOUR_API_KEY. See the full API reference for authentication, rate limits and error codes.