Job feed API (v1) · New Jobs

Active jobs

Open postings first indexed within the time window, from company career sites, hiring platforms and public employment services, with filtering, full-text search, date ranges, pagination and field selection.

GET /api/v1/active-jobs

Query parameters

Window

time_framestring · enumrequired

1h (hourly polling), 24h (daily, the default), 7d (a week), 6m (every open posting, for a backfill). Counts also accept 1m: everything indexed in 31 days, closed or not. No ingestion delay: a posting is in the window the moment it is indexed. Every window holds only postings their source still lists; roles first posted more than 12 months ago are left out.

Enum values: 1h24h7d6m

Default: 24h

Pagination

limitinteger · int32

Postings per response, 1 to 1000. Default 100.

Default: 100

offsetinteger · int32

Postings to skip, up to 100,000. Keep adding limit until a page comes back shorter than limit.

Default: 0

cursorinteger · int64

The last id you received; returns the next postings by id ascending. Best for backfills; every response also carries it in the X-Last-Id header. Wins over offset.

Response

description_formatstring · enum

text or html to include the full description (and requirements). Left out by default because it is large.

Enum values: texthtml

include_page_textboolean

true: also the complete text read from the original posting page.

Enum values: truefalse

Default: false

formatstring · enum

json (an array, the default), jsonl, csv, or md (Markdown for language models; chars limits text per posting).

Enum values: jsonjsonlcsvmd

Default: json

fieldsstring · comma-separated

Comma-separated list of the fields to return, e.g. id,title,url.

schemastring · enum

The output layout. Default: the universal job-feed layout (ai_* names for derived fields, salary / employment_type as the source states them), so code written for other job feeds works unchanged; the values are still derived by rules from the posting. native: this index's own names (no ai_ prefix).

Enum values: fantasticnative

Default: fantastic

include_basic_organization_detailsboolean

true: the employer's profile inline (industry, headcount, headquarters, legal entity id, open and new postings).

Enum values: truefalse

Default: false

include_betaboolean

true: also the standard occupation of each posting, classification_onet (O*NET-SOC 2019), classification_soc (SOC 2018) and classification_isco (ISCO-08), each {id, name}, matched by rules against O*NET's official title lists (English titles; null when no title matches), and locations_derived_structured (each place as lat, lon, locality, county, region, country, country_code, continent, timezone).

Enum values: truefalse

Default: false

order_bystring · enum

date_created (default, newest first), date_posted or salary.

Enum values: date_createddate_postedsalary

Default: date_created

include_duplicatesboolean

true: also the same opening found on a second channel.

Enum values: truefalse

Default: false

Text search

titlestring

Google-style search of the title: software engineer (both words), "software engineer" (phrase), python OR rust, -senior (exclude).

descriptionstring

The same syntax over the title and the complete description.

locationstring

The same syntax over the location, raw and normalised: Munich also finds München; "London, England, United Kingdom"; "United States" OR Canada.

title_advancedstring

Boolean: & and, | or, ! not, <-> followed by, <N> within N words, 'exact phrase', manag:* prefix, parentheses. E.g. (python | rust) & senior & !staff.

description_advancedstring

Boolean expression over title and description.

location_advancedstring

Boolean expression over the location: Germany & !(Berlin | Munich).

organization_advancedstring

Boolean expression over the employer's name.

skillstring

Comma-separated skills, all required: Python,SQL.

Dates

date_posted_gtestring · date-time

Posted on or after (ISO 8601, UTC).

date_posted_ltstring · date-time

Posted before.

date_created_gtestring · date-time

First indexed on or after: the safe cursor for incremental syncs.

date_created_ltstring · date-time

First indexed before.

Source

sourcestring

Comma-separated sources: greenhouse, lever (or lever.co), ashby, workday, oracle, smartrecruiters, workable, recruitee, personio, bamboohr, teamtailor, breezy, adp, arbeitsagentur, eures, career_site. See Supported sources.

exclude_sourcestring

Sources to leave out.

source_typestring · enum · comma-separated

ats, career_site, public_employment_service.

Enum values: atscareer_sitepublic_employment_service

Employer

organizationstring

Exact employer names, comma-separated.

exclude_organizationstring

Employers to leave out.

domainstring

Employer domains: nvidia.com,microsoft.com.

exclude_domainstring

Domains to leave out.

organization_agencystring · enum

only staffing / placement agencies, or exclude them (direct employers only).

Enum values: onlyexclude

organization_industrystring

Sector, e.g. technology, finance, healthcare.

organization_sizestring · enum · comma-separated

Company size buckets, comma-separated: 1, 2-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.

Enum values: 12-1011-5051-200201-500501-10001001-50005001-1000010001+

organization_headcount_gteinteger

At least this many employees.

organization_headcount_ltinteger

Fewer than this many employees.

company_countrystring

Employer's home country (ISO code).

Derived

experience_levelstring · enum · comma-separated

0-2, 2-5, 5-10, 10+ years (also as ai_experience_level).

Enum values: 0-22-55-1010+

work_arrangementstring · enum · comma-separated

On-site, Hybrid, Remote OK, Remote Solely.

Enum values: On-siteHybridRemote OKRemote Solely

employment_typestring · enum · comma-separated

FULL_TIME, PART_TIME, CONTRACTOR, TEMPORARY, INTERN, VOLUNTEER.

Enum values: FULL_TIMEPART_TIMECONTRACTORTEMPORARYINTERNVOLUNTEER

languagestring

Language the posting is written in: English, German, French, Spanish…

educationstring · enum · comma-separated

high school, associate degree, bachelor degree, postgraduate degree.

Enum values: high schoolassociate degreebachelor degreepostgraduate degree

taxonomiesstring

Job function, e.g. Software Engineering, Data & AI, Sales (also ai_taxonomies_a, function).

exclude_taxonomiesstring

Functions to leave out.

visa_sponsorshipstring · enum

only postings that offer sponsorship, or exclude them.

Enum values: onlyexclude

senioritystring · enum · comma-separated

internship, entry, mid, senior, lead, manager, director, executive.

Enum values: internshipentrymidseniorleadmanagerdirectorexecutive

Other

has_salaryboolean

true: only postings that state pay.

Enum values: truefalse

Default: false

salary_mininteger · per year

Minimum yearly pay (hourly, daily, weekly and monthly pay are converted).

currencystring

USD, EUR, GBP…

countrystring

ISO country codes of the job's location: US,CA.

has_no_locationboolean

true: only postings without a recognisable place.

Enum values: truefalse

Default: false

full_text_onlyboolean

true: only postings whose complete text is stored.

Enum values: truefalse

Default: false

idinteger · comma-separated

Posting ids, comma-separated.

no_collectstring

true: a search with few results does not trigger an automatic collection.

Response 200 · application/json

Default layout. With schema=native the ai_ prefix is dropped and salary_raw / employment_type_raw hold the source's own text. Employer profile fields (org_industry, org_headcount…) come with include_basic_organization_details=true.

Field	Type	Description
`id`	integer	Stable posting id.
`date_posted`	string · date-time	When the source says it was posted.
`date_created`	string · date-time	When it was first indexed. Monotonic: use it for incremental syncs.
`date_last_seen`	string · date-time	When it was last confirmed open.
`title`	string	Title as posted.
`organization`	string	Employer.
`organization_url`	string · uri \| null	Employer's website.
`date_valid_through`	string \| null	Closing date, when the source states one.
`locations`	array<Place> \| null	Raw location, JobPosting-style.
`location_type`	string \| null	TELECOMMUTE when remote.
`salary`	string \| null	Pay as the posting states it.
`employment_type`	string \| null	Employment type as the source states it.
`url`	string · uri	The exact original posting.
`apply_url`	string · uri	Where to apply.
`source_type`	string · enum	ats, career_site or public_employment_service.
`source`	string	Platform or service.
`source_domain`	string	Host of the posting URL.
`source_slug`	string \| null	The employer's board on that platform.
`cities_derived`	array<string> \| null	Normalised cities.
`counties_derived`	array<string> \| null	Counties.
`regions_derived`	array<string> \| null	Regions / states.
`countries_derived`	array<string> \| null	Countries.
`country_codes_derived`	array<string> \| null	ISO country codes.
`locations_derived`	array<string> \| null	"City, Region, Country" in English.
`timezones_derived`	array<string> \| null	IANA time zones.
`lats_derived`	array<number> \| null	Latitudes.
`lngs_derived`	array<number> \| null	Longitudes.
`domain_derived`	string \| null	Employer domain.
`ai_salary_currency`	string \| null	ISO currency.
`ai_salary_value`	number \| null	A single amount.
`ai_salary_min_value`	number \| null	Lower end of a range.
`ai_salary_max_value`	number \| null	Upper end.
`ai_salary_unit_text`	string · enum \| null	HOUR, DAY, WEEK, MONTH, YEAR.
`ai_benefits`	array<string> \| null	Benefits the posting names.
`ai_experience_level`	string · enum \| null	0-2, 2-5, 5-10, 10+.
`years_experience`	integer \| null	Years asked for.
`seniority`	string \| null	internship … executive.
`ai_work_arrangement`	string · enum \| null	On-site, Hybrid, Remote OK, Remote Solely.
`ai_work_arrangement_office_days`	integer \| null	Office days a week (hybrid), when stated.
`ai_remote_location`	array<string> \| null	Countries a remote role is open to.
`ai_key_skills`	array<string> \| null	Skills the posting names.
`ai_core_responsibilities`	string \| null	The posting's own duties section, verbatim.
`ai_requirements_summary`	string \| null	The posting's own requirements section, verbatim.
`ai_working_hours`	number \| null	Hours a week, when stated.
`ai_employment_type`	array<string> \| null	FULL_TIME, PART_TIME, CONTRACTOR, TEMPORARY, INTERN, VOLUNTEER.
`ai_job_language`	string \| null	Language of the posting.
`ai_visa_sponsorship`	boolean \| null	Whether the posting offers sponsorship, when it says.
`ai_keywords`	array<string> \| null	Title words, function, department and skills.
`ai_taxonomies_a`	array<string> \| null	Job function.
`ai_education`	array<string> \| null	Degree level asked for.
`department`	string \| null	Department.
`apply_effort`	string · enum \| null	quick or lengthy.
`full_text`	boolean	The complete text is stored.
`details`	object \| null	Every other fact the source gave.
`org_id`	integer	Employer id.
`org_slug`	string	Slug for /api/company/{slug}.
`org_industry`	string \| null	Sector.
`org_headcount`	integer \| null	Employees.
`org_headquarters_country`	string \| null	HQ country.
`org_headquarters_city`	string \| null	HQ city.
`org_lei`	string \| null	Legal Entity Identifier.
`org_open_jobs`	integer	Employer's open postings.
`org_new_jobs_7d`	integer	New this week.
`org_recruitment_agency_derived`	boolean	Staffing / placement agency.
`date_modified`	string · date-time \| null	When a tracked field changed upstream.
`modified_fields`	array<string> \| null	Which fields changed.
`description_text`	string	Full description (description_format=text).
`description_html`	string	Description as HTML (description_format=html).
`requirements_text`	string \| null	Requirements section.
`page_text`	string \| null	Full text of the original page (include_page_text).
`locations_derived_structured`	array<object> \| null	Each place as lat, lon, locality, county, region, country, country_code, continent, timezone (include_beta).
`classification_onet`	object \| null	O*NET-SOC 2019 occupation {id, name}, e.g. {"id": "15-1252.00", "name": "Software Developers"} (include_beta; rule-matched from the title).
`classification_soc`	object \| null	SOC 2018 detailed occupation {id, name} (include_beta).
`classification_isco`	object \| null	ISCO-08 unit group {id, name}, e.g. {"id": "2512", "name": "Software developers"} (include_beta).
`org_size`	string \| null	Company size bucket: 1, 2-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ (include_basic_organization_details).
`locations_alt`	array \| null	Always null (kept for layout compatibility).
`location_requirements`	array \| null	Always null (kept for layout compatibility).
`organization_logo`	string \| null	Always null (kept for layout compatibility).
`ai_hiring_manager_name`	string \| null	Always null: not collected.
`ai_hiring_manager_email_address`	string \| null	Always null: not collected.

Errors

400 a parameter is not understood (the message names it) · 404 no such endpoint · 429 slow down · 503 the query would scan too much: add a filter or a shorter window.

GET /api/v1/active-jobs

Example responses

[
  {
    "id": 7419257,
    "date_posted": "2026-03-27T20:14:12Z",
    "date_created": "2026-10-07T02:11:44Z",
    "title": "Detailer Part Time",
    "organization": "34F25E52 A6C4 4D5B Bde5 46A425506C7B",
    "organization_url": null,
    "date_valid_through": null,
    "locations": [
      {
        "@type": "Place",
        "address": {
          "@type": "PostalAddress",
          "addressLocality": "Menomonie, WI, USA"
        }
      }
    ],
    "locations_alt": null,
    "location_type": null,
    "location_requirements": null,
    "salary": "15.0-16.0 USD / HOUR",
    "employment_type": null,
    "url": "https://recruiting.paylocity.com/Recruiting/Jobs/Details/4038978",
    "source_type": "ats",
    "source": "paylocity",
    "source_domain": "recruiting.paylocity.com",
    "source_slug": "34f25e52-a6c4-4d5b-bde5-46a425506c7b",
    "organization_logo": null,
    "cities_derived": [
      "Menomonie"
    ],
    "counties_derived": [
      "Dunn County"
    ],
    "regions_derived": [
      "Wisconsin"
    ],
    "countries_derived": [
      "United States"
    ],
    "locations_derived": [
      "Menomonie, Wisconsin, United States"
    ],
    "timezones_derived": [
      "America/Chicago"
    ],
    "lats_derived": [
      44.87552
    ],
    "lngs_derived": [
      -91.91934
    ],
    "domain_derived": null,
    "ai_salary_currency": "USD",
    "ai_salary_value": null,
    "ai_salary_min_value": 15.0,
    "ai_salary_max_value": 16.0,
    "ai_salary_unit_text": "HOUR",
    "ai_benefits": [
      "Employee discounts"
    ],
    "ai_experience_level": null,
    "ai_work_arrangement": null,
    "ai_work_arrangement_office_days": null,
    "ai_remote_location": null,
    "ai_remote_location_derived": null,
    "ai_key_skills": [
      "Customer Service",
      "Communication"
    ],
    "ai_hiring_manager_name": null,
    "ai_hiring_manager_email_address": null,
    "ai_core_responsibilities": null,
    "ai_requirements_summary": "Automotive Detailer Qualifications:\nMust be detail oriented.\nMust have excellent communication skills.\nMust be an active listener and exercise sound judgment.\nGood critical thinking and problem solving skills are essential.\nMust be a good time manager and multi-tasker.\nMust have the ability to effectively manage material resources and keep track of an inventory of supplies.\nShould have ample knowledge of safety precautions.\nBe available to work 3-6 weekdays.\nMust be able to work on Saturday.",
    "ai_working_hours": null,
    "ai_employment_type": [
      "PART_TIME"
    ],
    "ai_job_language": "English",
    "ai_visa_sponsorship": null,
    "ai_keywords": [
      "Detailer",
      "Part",
      "Time",
      "Customer Service",
      "Communication"
    ],
    "ai_taxonomies_a": null,
    "ai_education": null,
    "description_text": "Description\nAutomotive Detailer\nJohnson Motors of Menomonie, Inc. is looking to add a part time automotive detailer to our team in Menomonie, WI. This is an excellent opportunity to be a part of a thriving family-owned company that values customer service and takes pride in their work!\nAutomotive Detailer Responsibilities:\nA car detailer cleans most parts of a car including small cracks and crevices that are not normally cleaned with an automatic washing system.\nThe Detailer’s job is to restore a vehicle to factory showroom condition under the direction of the Sales Management team’s standards.\nAutomotive Detailer Benefits:\nEmployee discounts on vehicle purchases, parts, and service\nClosed on Sundays\nRequirements\nAutomotive Detailer Qualifications:\nMust be detail oriented.\nMust have excellent communication skills.\nMust be an active listener and exercise sound judgment.\nGood critical thinking and problem solving skills are essential.\nMust be a good time manager and multi-tasker.\nMust have the ability to effectively manage material resources and keep track of an inventory of supplies.\nShould have ample knowledge of safety precautions.\nBe available to work 3-6 weekdays.\nMust be able to work on Saturday.",
    "date_last_seen": "2026-10-07T02:11:44Z",
    "apply_url": "https://recruiting.paylocity.com/Recruiting/Jobs/Details/4038978",
    "country_codes_derived": [
      "US"
    ],
    "years_experience": null,
    "seniority": null,
    "department": null,
    "apply_effort": null,
    "full_text": false,
    "details": {
      "address": "1603 US Highway 12 W, 54751",
      "datePosted": "2026-03-27T20:14:17-05:00",
      "hiringOrganization": "Johnson Motors of Menomonie Inc",
      "baseSalary": "15.0-16.0 USD / HOUR"
    },
    "org_slug": "board-597214",
    "org_recruitment_agency_derived": false,
    "requirements_text": "Automotive Detailer Qualifications:\nMust be detail oriented.\nMust have excellent communication skills.\nMust be an active listener and exercise sound judgment.\nGood critical thinking and problem solving skills are essential.\nMust be a good time manager and multi-tasker.\nMust have the ability to effectively manage material resources and keep track of an inventory of supplies.\nShould have ample knowledge of safety precautions.\nBe available to work 3-6 weekdays.\nMust be able to work on Saturday.",
    "locations_derived_structured": [
      {
        "lat": 44.87552,
        "lon": -91.91934,
        "locality": "Menomonie",
        "county": "Dunn County",
        "region": "Wisconsin",
        "country": "United States",
        "country_code": "US",
        "continent": "North America",
        "timezone": "America/Chicago"
      }
    ]
  },
  {
    "id": 7419256,
    "date_posted": "2026-07-22T14:10:43Z",
    "date_created": "2026-10-07T02:11:44Z",
    "title": "Certified Automotive Technician",
    "organization": "34F25E52 A6C4 4D5B Bde5 46A425506C7B",
    "organization_url": null,
    "date_valid_through": null,
    "locations": [
      {
        "@type": "Place",
        "address": {
          "@type": "PostalAddress",
          "addressLocality": "Menomonie, WI, USA"
        }
      }
    ],
    "locations_alt": null,
    "location_type": null,
    "location_requirements": null,
    "salary": "60000.0-150000.0 USD / YEAR",
    "employment_type": null,
    "url": "https://recruiting.paylocity.com/Recruiting/Jobs/Details/2262282",
    "source_type": "ats",
    "source": "paylocity",
    "source_domain": "recruiting.paylocity.com",
    "source_slug": "34f25e52-a6c4-4d5b-bde5-46a425506c7b",
    "organization_logo": null,
    "cities_derived": [
      "Menomonie"
    ],
    "counties_derived": [
      "Dunn County"
    ],
    "regions_derived": [
      "Wisconsin"
    ],
    "countries_derived": [
      "United States"
    ],
    "locations_derived": [
      "Menomonie, Wisconsin, United States"
    ],
    "timezones_derived": [
      "America/Chicago"
    ],
    "lats_derived": [
      44.87552
    ],
    "lngs_derived": [
      -91.91934
    ],
    "domain_derived": null,
    "ai_salary_currency": "USD",
    "ai_salary_value": null,
    "ai_salary_min_value": 60000.0,
    "ai_salary_max_value": 150000.0,
    "ai_salary_unit_text": "YEAR",
    "ai_benefits": [
      "Dental insurance",
      "Vision insurance",
      "Retirement plan",
      "Paid time off",
      "Bonus"
    ],
    "ai_experience_level": null,
    "ai_work_arrangement": null,
    "ai_work_arrangement_office_days": null,
    "ai_remote_location": null,
    "ai_remote_location_derived": null,
    "ai_key_skills": null,
    "ai_hiring_manager_name": null,
    "ai_hiring_manager_email_address": null,
    "ai_core_responsibilities": null,
    "ai_requirements_summary": "· Experienced: You bring a strong background in diagnosis, repair, and shop procedures\n· Certified: You hold current ASE or manufacturer certifications (Ford, GM, etc.)\n· Independent but team-minded: You take ownership of your work and support your team\n· Detail-driven: You believe the little things make a big difference\n· Professional: You treat coworkers and guests with respect and integrity",
    "ai_working_hours": null,
    "ai_employment_type": [
      "INTERN"
    ],
    "ai_job_language": "English",
    "ai_visa_sponsorship": null,
    "ai_keywords": [
      "Certified",
      "Automotive",
      "Technician",
      "Hardware & Engineering"
    ],
    "ai_taxonomies_a": [
      "Hardware & Engineering"
    ],
    "ai_education": null,
    "description_text": "Description\nCertified Automotive Technician – Johnson Motors of Menomonie, Inc\nMenomonie, WI\nCompensation: $60,000-150,000 annually (Flat Rate + Performance Bonus)\nFull-Time\nCelebrating 100 Years of Excellence – Work Where Your Skills Are Valued.\nAt Johnson Motors, we do things differently—and proudly so. For 100 years, we’ve built our reputation on trust, integrity, and delivering a better experience for guests and employees alike. As we grow into our next century of service, we’re looking for skilled and motivated technicians to help lead the way.\nIf you're a certified technician who values quality work, a clean shop, and a team that truly has your back, you’ve found your next home.\nWhat You’ll Do – A Day in the Life\nAs a Main Shop Technician, you’ll diagnose and repair a wide range of vehicles with precision and pride. Whether you're doing a complex drivability diagnosis or routine brake work, you’ll be part of a shop that values craftsmanship, communication, and continuous improvement. Your day might include:\n· Perform advanced diagnostics using factory scan tools and equipment\n· Complete repairs on engines, transmissions, electrical systems, and drivetrains\n· Collaborate with service advisors to ensure guest concerns are clearly addressed\n· Conduct comprehensive multipoint inspections and document findings\n· Conduct video multi point inspections, creating transparency for our guests\n· Stay current with factory bulletins and technical training\n· Mentor apprentice and express techs as needed\n· Maintain a clean, organized work area and follow all safety protocols\n· Deliver every vehicle with quality work and confidence\n· Highest level of work ethic and integrity\nWho You Are\n· Experienced: You bring a strong background in diagnosis, repair, and shop procedures\n· Certified: You hold current ASE or manufacturer certifications (Ford, GM, etc.)\n· Independent but team-minded: You take ownership of your work and support your team\n· Detail-driven: You believe the little things make a big difference\n· Professional: You treat coworkers and guests with respect and integrity\nCompensation & Benefits\n· Annual earnings: $60,000-$150,000, based on experience and productivity\n· Flat-rate compensation with performance bonuses\n· Tool allowance and ongoing training support\n· 401(k) with company match\n· Health, dental, and vision insurance\n· Paid time off and holidays\n· Access to OEM training and ASE prep\n· A shop culture built on respect, growth, and teamwork\nWhy Johnson Motors?\nWe’re not just another dealership—we’re a workplace built around people. As a Certified Technician at Johnson Motors, you’ll get the hours you need, the support you deserve, and a long-term path for advancement. We invest in our techs because we know they’re the heart of what we do.\nRequirements\nExperience as a main shop or certified technician\nCurrent ASE or OEM certifications preferred (we’ll help you get more)\nValid driver’s license and clean driving record\nAbility to lift 50+ lbs. and work in a physically active environment\nStrong diagnostic, mechanical, and electrical skills\nExperience with digital MPI tools and service diagnostics tools",
    "date_last_seen": "2026-10-07T02:11:44Z",
    "apply_url": "https://recruiting.paylocity.com/Recruiting/Jobs/Details/2262282",
    "country_codes_derived": [
      "US"
    ],
    "years_experience": null,
    "seniority": null,
    "department": null,
    "apply_effort": null,
    "full_text": false,
    "details": {
      "address": "1603 US Highway 12 W, 54751",
      "datePosted": "2026-07-22T14:10:
…

{
  "error": "time_frame must be 1h, 24h, 7d or 6m"
}

application/json