Public API

Read jobs, companies, salaries and market figures from ApplyPick as JSON. You can try it without signing up; an API token raises your limits.

Quick start

The base URL is https://applypick.com/api/public/v1. Every response is JSON and every read endpoint is a GET.

curl "https://applypick.com/api/public/v1/jobs?role=python&country=Germany&limit=5"

With an API token (see below), the same call, now with the full job description on the detail route:

curl -H "Authorization: Bearer apk_your_token" "https://applypick.com/api/public/v1/jobs?limit=5"

The machine-readable description is the OpenAPI spec.

Access levels and limits

LevelPer minutePer dayFull job descriptionTools
Guest (no token, by IP)10200NoNo
API token, Free plan301,000YesNo
API token, Pro plan12020,000YesYes
API token, Max plan300100,000YesYes

Only requests that reach the API count: a guest answer we serve from our cache is free. The limits of a token belong to your account, so all your tokens share them. We may change the limits; the response headers always show the ones that apply to you right now.

Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (seconds) for the minute window, and X-RateLimit-Day-Limit and X-RateLimit-Day-Remaining for the day. Over a limit you get 429 with Retry-After (seconds): rate_limited for the minute window, quota_exceeded for the day.

API tokens

Create a token in your account settings (any ApplyPick account, up to 3 tokens). The token is shown once; copy it then. Send it as Authorization: Bearer apk_…. Revoke it any time in the same place; it stops working within a minute.

A token is a password for your quota. Do not put it in a web page, a public repository or a mobile app. A token that is not valid gets 401 invalid_token.

Pagination

Lists use a cursor. Pass limit (1 to 50) and, for the next page, the next_cursor of the previous answer as cursor. next_cursor is null on the last page. There is no total count. Treat the cursor as opaque; it works only with the same filters and sort it came from (otherwise 400 invalid_cursor).

curl "https://applypick.com/api/public/v1/jobs?limit=2"
# {"items":[…2 jobs…],"next_cursor":"eyJ2IjoxLC…"}
curl "https://applypick.com/api/public/v1/jobs?limit=2&cursor=eyJ2IjoxLC…"

Jobs are sorted by sort: recent (newest first), salary_desc or salary_asc (jobs without pay come last). The text in role only filters; it does not change the order.

Errors

StatusdetailMeaning
400invalid_cursorThe cursor is damaged or belongs to another query.
401invalid_tokenThe token is unknown, revoked, or not an API token.
401token_requiredThe tools need an API token.
402plan limit payloadA tool limit of your plan is used up (same answer as on the site).
403plan_requiredYour plan does not include the tools (Pro and Max do).
404job_not_found, company_not_found, …Nothing there: wrong slug, or the job is no longer listed.
422validation listA parameter is out of range or has a wrong value.
429rate_limited, quota_exceededOver a limit; wait for Retry-After seconds.
503tool_disabledA tool is switched off for now.

Errors are JSON, {"detail": "…"}, except 422 which lists the problems.

Endpoints

Everything below is under https://applypick.com. Fields marked | null can be empty.

Jobs

GET/api/public/v1/companies/{company_slug}/jobs/{slug}

One job

Parameters

ParameterInTypeDescription
company_slugrequiredpathstring
slugrequiredpathstring

Response JobDetail

FieldTypeNotes
categoriesstring[]
company_logo_urlstring | null
company_namestring
company_same_asstring[]
company_slugstring | null
countriesstring[]
currencystring | null
date_posteddatetime | null
descriptionstring | null
description_access"api_token" | null
employer_apply_urlstring | null
employment_typestring | null
excerptstring | null
expires_atdatetime | null
is_remoteboolean
locationstring | null
max_amountnumber | null
max_annualnumber | null
min_amountnumber | null
min_annualnumber | null
parent_categoriesstring[]
salary_periodstring | null
senioritystring[]
skillsstring[]
slugstring
titlestring
urlstring | null
utc_offsetsnumber[]

GET/api/public/v1/jobs

List jobs

Parameters

ParameterInTypeDescription
rolequerystring | nullText in the title, company or category Up to 100 characters.
company_slugquerystring | nullUp to 200 characters.
countryquerystring[] | null
seniorityquerystring[] | null
employment_typequerystring[] | null
parentquerystring[] | nullJob category
min_annualqueryinteger | nullMinimum annual pay, USD Range 0 to ….
sortquery"recent" | "salary_desc" | "salary_asc"`recent`: newest first. Salary sorts put jobs without pay last Default "recent".
limitqueryintegerItems per page Default 20. Range 1 to 50.
cursorquerystring | null`next_cursor` of the previous page; omit for the first page Up to 300 characters.

Response JobList

FieldTypeNotes
itemsJob[]
next_cursorstring | null

Companies

GET/api/public/v1/companies

List companies

Parameters

ParameterInTypeDescription
qquerystring | nullText in the name or market Up to 100 characters.
countryquerystring[] | null
marketquerystring[] | null
sortquery"jobs" | "name"`jobs`: most open jobs first. `name`: A to Z Default "jobs".
limitqueryintegerItems per page Default 20. Range 1 to 50.
cursorquerystring | null`next_cursor` of the previous page; omit for the first page Up to 300 characters.

Response CompanyList

FieldTypeNotes
itemsCompany[]
next_cursorstring | null

GET/api/public/v1/companies/{slug}

One company

Parameters

ParameterInTypeDescription
slugrequiredpathstring

Response CompanyDetail

FieldTypeNotes
aboutstring | null
benefits_textstring | null
ceostring | null
countriesstring[]
employee_sizestring | null
facebook_urlstring | null
founded_yearinteger | null
is_globalboolean | null
job_countinteger
linkedin_urlstring | null
logo_urlstring | null
marketsstring[]
namestring
slugstring
tech_stack_textstring | null
twitter_urlstring | null
urlstring
website_urlstring | null

Filters

GET/api/public/v1/filters

Values for the list filters

Response Filters

FieldTypeNotes
companiesCompanyFilters
jobsJobFilters

Market

GET/api/public/v1/market/reports

List market reports

Parameters

ParameterInTypeDescription
typequery("daily" | "weekly" | "monthly")[] | nullReport types; default weekly and monthly
limitqueryintegerDefault 100. Range 1 to 400.

Response MarketReportList

FieldTypeNotes
itemsMarketReport[]

GET/api/public/v1/market/reports/{slug}

One market report

Parameters

ParameterInTypeDescription
slugrequiredpathstring

Response MarketSummary

FieldTypeNotes
by_categoryMarketCount[]
by_countryMarketCount[]
by_seniorityMarketCount[]
computed_atdatetime
deltaMarketDelta | null
flowMarketFlow | null
new_jobsMarketNewJobs
next_slugstring | null
periodMarketPeriod | null
previous_slugstring | null
salaryMarketSalary | null
slugstring
snapshot_typestring
top_companiesMarketCompany[]
top_rolesMarketRole[]
totalsMarketTotals

GET/api/public/v1/market/summary

Current market figures

Response MarketSummary

FieldTypeNotes
by_categoryMarketCount[]
by_countryMarketCount[]
by_seniorityMarketCount[]
computed_atdatetime
deltaMarketDelta | null
flowMarketFlow | null
new_jobsMarketNewJobs
next_slugstring | null
periodMarketPeriod | null
previous_slugstring | null
salaryMarketSalary | null
slugstring
snapshot_typestring
top_companiesMarketCompany[]
top_rolesMarketRole[]
totalsMarketTotals

Salaries

GET/api/public/v1/salaries

Salary overview

Response SalaryOverview

FieldTypeNotes
categoriesSalaryFigures[]
countriesSalaryFigures[]
overallSalaryFigures | null
rolesSalaryFigures[]
senioritySalaryFigures[]

GET/api/public/v1/salaries/{segment}/{slug}

Salary figures of one role, country or category

Parameters

ParameterInTypeDescription
segmentrequiredpathstring
slugrequiredpathstring

Response SalaryFigures

FieldTypeNotes
computed_atdatetime
coverage_pctnumber
currencystring
indexableboolean
jobs_totalinteger
jobs_with_payinteger
kindstring
medianinteger | null
ninteger
namestring
p25integer | null
p5integer | null
p75integer | null
p95integer | null
slugstring

GET/api/public/v1/salaries/{segment}/{slug}/history

How the figures changed between reports

Parameters

ParameterInTypeDescription
segmentrequiredpathstring
slugrequiredpathstring
typequery"daily" | "weekly" | "monthly"Which reports to read Default "weekly".
limitqueryintegerDefault 52. Range 1 to 400.

Response SalaryHistory

FieldTypeNotes
itemsSalaryHistoryPoint[]
snapshot_typestring

Job descriptions: guests get description: null with description_access: "api_token"; a token gets the text. The apply link is employer_apply_url; pass it on unchanged.

Tools (Pro and Max tokens)

The resume and job tools of the site can be called with a Pro or Max token. They are POST requests with form fields (multipart/form-data), run as your account, and use your plan's tool limits; the answer is the same JSON as on the site, in full. A call without a token is 401, with a Free token 403.

curl -H "Authorization: Bearer apk_your_token" \
  -F "[email protected]" \
  "https://applypick.com/api/public/v1/tools/job-seeker/ats-checker"
PathForm fields
/v1/tools/comparejob_file, job_text, resume_file, resume_text
/v1/tools/job-seeker/ats-checkerresume_file, resume_text
/v1/tools/job-seeker/bullet-improver
/v1/tools/job-seeker/find-jobsjob_file, job_text, resume_file, resume_text
/v1/tools/job-seeker/jd-decoderjob_file, job_id, job_text
/v1/tools/job-seeker/should-i-applyjob_file, job_id, job_text, resume_file, resume_text
/v1/tools/recruiter/candidate-match
/v1/tools/recruiter/find-talentjob_file, job_text, resume_file, resume_text
/v1/tools/recruiter/interview-kitjob_file, job_text
/v1/tools/recruiter/jd-optimizerjob_file, job_text

Paths are relative to /api/public. The fields a tool needs are described on its page on the site.

Terms of use

You may use the API for free, within the limits above, in personal, research and commercial projects, if you follow these rules.

  1. Show where the data is from. Wherever you display data from the API, show a visible link “Data from ApplyPick”. When you show one job or company, link it to the url field of that item; otherwise link to https://applypick.com. This applies at every access level.
  2. Do not change apply links. Pass employer_apply_url on as it is: do not replace, wrap or add tracking to it.
  3. Keep it current. Do not show a job after its expires_at, and remove a job from your product when the API answers 404 for it.
  4. No mirroring and no resale. Do not copy the catalog to publish, sell or offer it as a dataset or as a competing job board.
  5. No model training. Do not use data from the API to train or fine-tune machine-learning models without our written permission. Answering a person's question with the data, with the link from rule 1, is fine.
  6. Respect the limits. Do not work around them with several IP addresses, accounts or tokens. Keep your token secret; you are responsible for what is done with it.
  7. Changes and access. We may change limits, slow down or stop access that harms the service or breaks these terms, and revoke tokens. Within version 1 we only add things (new routes, new fields); a breaking change comes as version 2. The API is provided as is, without any warranty, and the data can be wrong or late: the source posting is the authority (see Data sources).

These terms are in addition to our Terms of Service and Privacy Policy. Questions or permission requests: [email protected].