Products / Job Search API

Available

Job listings.
Ready for your application.

View Markdown

Collect documented records from supported job boards. Keep the source, collection time and coverage visible alongside your results.

Record format

See what you will receive.

Current records include stable record/source IDs and nullable job, company, salary and contact fields. postedDate is a source posting date; processedAt records processing. Missing values remain null.

The saved capture shows historical listing metadata from a verified three-record validation task before the current schema adoption. Its original provenance and fields are retained. Your own query, source selection and collection time determine your results.

Tasks, results and source outcomes →

Job Search API · Historical captured output

Three real listing records.

Verified capture

Arbeitnow · · verified staging validation task before the Job Search rename and schema adoption. These are historical saved listing fields in their original schema, not a live search; listings may have changed.

Input

Configure once in Playground.

Choose a keyword, country, compatible platforms, a per-platform record limit and a credit budget. Review a quote, then submit its price version with your canonical command key.

Unsubmitted inputs stay in memory. Save explicitly to your account when you want to keep a configuration across refreshes or devices.

Configure a request →

Illustrative request body · this page does not execute it

{
  "productId": "job-search",
  "input": {
    "keyword": "Software engineer",
    "country": "Germany",
    "maxResults": 3,
    "maxCredits": 3,
    "allowPartial": false,
    "platforms": [
      "arbeitnow"
    ]
  },
  "expectedPricingVersion": "<version returned by quote>"
}

Always obtain the current quote and price version. Supply a fresh canonical Idempotency-Key for a new command; recover the original key when its outcome is uncertain.

Source coverage

Check the source before you run.

SourceSupported country scopeLimits and availability
ArbeitnowDEInspect the current source registry and quote; read reported notices for filters that were ignored.
LinkedInAll supported countriesInspect the current source registry and quote; read reported notices for filters that were ignored.
Job BankCAInspect the current source registry and quote; read reported notices for filters that were ignored.

Coverage means the selected, supported collection scope. It is not a complete or continuously refreshed database of every vacancy. Source outages and exclusions remain explicit.

Read detailed source limits →

Current input fields

FieldTypeMeaning and constraints
maxResults (required)integerMaximum job rows to return from each selected job platform Minimum: 1. Maximum: 100.
keyword (required)stringJob title, skill, or company query to search across selected job platforms
country (required)stringCountry used to select compatible job platforms and regional endpoints
98 supported valuesAlgeria, Angola, Argentina, Australia, Austria, Azerbaijan, Bahrain, Bangladesh, Belgium, Bosnia and Herzegovina, Brazil, Bulgaria, Cameroon, Canada, Chile, China, Colombia, Costa Rica, Croatia, Cyprus, Czechia, Denmark, Dominican Republic, Ecuador, Egypt, El Salvador, Estonia, Finland, France, Germany, Ghana, Greece, Guatemala, Hong Kong, Hungary, India, Indonesia, Iraq, Ireland, Israel, Italy, Ivory Coast, Japan, Jordan, Kazakhstan, Kenya, Kuwait, Latvia, Lebanon, Libya, Lithuania, Luxembourg, Malaysia, Malta, Mexico, Morocco, Mozambique, Netherlands, New Zealand, Nigeria, Norway, Oman, Pakistan, Panama, Peru, Philippines, Poland, Portugal, Puerto Rico, Qatar, Romania, Russia, Saudi Arabia, Senegal, Serbia, Singapore, Slovakia, Slovenia, South Africa, South Korea, Spain, Sweden, Switzerland, Taiwan, Thailand, Tunisia, Turkey, Uganda, Ukraine, United Arab Emirates, United Kingdom, United States, Uruguay, Uzbekistan, Venezuela, Vietnam, Yemen, Zambia
locationstringOptional city, area, or postal code sent only to job platforms that support location
platformsarrayOptional job platforms to search; leave empty to use every compatible platform for the country
postedSincestringOptional earliest posting date applied only by job platforms that support it
remoteOnlybooleanOptional remote-only filter applied only by job platforms that support it
distanceintegerOptional search radius in miles applied only by job platforms that support it Minimum: 50. Maximum: 10000.
jobTypestringOptional employment type applied only by job platforms that support it; `all` disables this filter
5 supported valuesall, fulltime, parttime, internship, contract
currencystringOptional target currency for normalized salary conversion across selected job platforms
166 supported valuesAED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLF, CLP, CNH, CNY, COP, CRC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, FOK, GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, IMP, INR, IQD, IRR, ISK, JEP, JMD, JOD, JPY, KES, KGS, KHR, KID, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLE, SLL, SOS, SRD, SSP, STN, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TVD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VES, VND, VUV, WST, XAF, XCD, XCG, XDR, XOF, XPF, YER, ZAR, ZMW, ZWG, ZWL

TrueFetch adds maxCredits and allowPartial for budget and partial-delivery decisions.

Current record fields

FieldTypeMeaning and constraints
recordId (required)stringStable identity of this job: source ID and a hash of its source URL
sourceId (required)stringKey of the job board the record came from
platform (required)string or nullJob board or platform name (e.g. LinkedIn)
platformUrl (required)string or nullJob listing URL on the source platform
officialUrl (required)string or nullDirect URL to the original job posting
title (required)string or nullJob position or role title
postedDate (required)string or nullDate the job was originally posted
validThrough (required)string or nullDate when the job posting expires or closes
location (required)object or nullStructured job location. raw contains the source location text; standardized fields contain locality, region, postal code, country, country code, and coordinates when available.
applicantCount (required)integer or nullNumber of applicants or applications reported by the source platform
isRemote (required)boolean or nullTrue if the position allows remote work
description (required)string or nullFull job description and requirements text
jobType (required)string or nullEmployment type (full-time, part-time, contract)
jobLevel (required)string or nullSeniority level (junior, mid, senior, manager)
jobFunction (required)string or nullJob category or department (e.g. Engineering)
listingType (required)string or nullType of job listing (standard, featured, etc.)
skills (required)string or nullRequired skills and technologies for the role
workMode (required)string or nullRemote or hybrid work arrangement details
vacancyCount (required)integer or nullNumber of open positions for this role
experienceRange (required)string or nullRequired years of experience for the role
salaryPeriod (required)string or nullPay frequency (yearly, monthly, or hourly)
salaryMinimum (required)number or nullMinimum salary offered for the position
salaryMaximum (required)number or nullMaximum salary offered for the position
salaryCurrency (required)string or nullISO currency code for the salary (e.g. USD)
easyApply (required)boolean or nullTrue if the job can be applied to directly on the platform
companyName (required)string or nullName of the company offering the job
companyType (required)string or nullOwnership type of the company (e.g. Public, Private, Nonprofit)
companyFounded (required)integer or nullYear the company was founded
companyIndustry (required)string or nullIndustry or sector the company operates in
companyUrl (required)string or nullCompany profile URL on the job platform
companyWebsite (required)string or nullOfficial website URL of the company
companyLogo (required)string or nullURL of the company's logo image
companyAddresses (required)string or nullPhysical office address of the company
companyRevenue (required)string or nullEstimated annual revenue range of the company
companyDescription (required)string or nullBrief overview or about section of the company
companyRating (required)number or nullOverall company rating score (e.g. out of 5)
employeeCount (required)string or nullApproximate number of employees at the company
reviewCount (required)integer or nullTotal number of employee reviews for the company
emails (required)array or nullContact email addresses for the job or company
phones (required)array or nullContact phone numbers for the job or company
socialLinks (required)object or nullCompany social media URLs grouped by platform (linkedIns, twitters, facebooks, instagrams, etc.)
processedAt (required)string or nullUTC timestamp when this record was processed

Collection schema digest: a3c7225585da25da7b624bb7a4ba9b591355293e7d2a2d2237c3bbe9ddb4ba83.

A clear delivery price.

1 credit per verified delivered record. Credits are reserved on acceptance and settled against delivery. A failed or empty task has no collection charge; partial delivery is used only when explicitly permitted.

See pricing and refund rules →

Keep your results.

Preview and download authorized JSONL or CSV for seven days after the task reaches its terminal result. Expiry does not change the task’s settlement history. Download the files you need before the actual expiry shown on the task.

Result formats and retention →

Use the records in your workflow.

Call REST directly, use a documented integration, or evaluate listings through the Jev BYOK example. Every integration declares its actual support state and limits.