ProblemDetails
typeURI reference identifying the error type. For HTTP-status-only errors this points at https://httpproblems.com/.
titleShort, human-readable summary of the problem type (e.g. Bad Request, Gateway Timeout).
statusHTTP status code, mirrored in the response status line.
detailHuman-readable explanation specific to this occurrence. Safe to surface to end users.
instancePath of the request that produced the error.
Diagnostic trace fields injected by the gateway. Include these when filing a support ticket.
CountResponse
countNumber of listings matching the supplied filters in the selected time_frame.
ActiveAtsJob
idThe job's internal ID. Used for expiration.
titleJob title.
date_createdDate & time of indexing in our database.
urlThe URL of the job.
sourceSource ATS or job board.
source_typeFor ActiveAtsJob, this is always 'ats'.
organizationName of the hiring organization.
organization_urlURL to the organization's page.
date_postedDate & time of posting.
date_valid_throughDate & time of the future expiry date.
Source-supplied location objects per the Google JobPosting schema (e.g. {address: {addressLocality, addressRegion, addressCountry, postalCode}, ...}). Use locations_derived, cities_derived, regions_derived, countries_derived, lats_derived / lngs_derived for normalized, geocoded values.
locations_altFallback location string used when the source ATS doesn't supply structured location data in its Job Posting schema. Populated primarily from HTML scraping; for a small subset of ATS (currently ~4 of 54) it is AI-structured from the listing's free-text content. Null when the schema-supplied locations is sufficient.
Normalized location strings. Geocoded. This is the field used for location search.
location_typeTo identify remote jobs: 'TELECOMMUTE' per the Google JobPosting schema.
location_requirementsLocation requirement to accompany remote (TELECOMMUTE) jobs per the Google JobPosting schema.
salarySource-supplied salary object per the Google JobPosting schema. Often partial or missing. For a normalized numeric breakdown use ai_salary_value, ai_salary_min_value, ai_salary_max_value, ai_salary_currency, and ai_salary_unit_text.
employment_typeTypes like 'Full Time', 'Contract', 'Internship'. Usually a single value. For better accuracy, use ai_employment_type.
source_domainDomain of the career site or job board. Not present for all ATS; use domain_derived instead.
domain_derivedAI-discovered domain of the employer's main website.
description_textPlain text job description. Returned when description_format=text.
description_htmlRaw HTML job description. Returned when description_format=html.
cities_derivedAll cities from locations_derived.
counties_derivedAll counties from locations_derived. Only present when cities_derived is not.
regions_derivedAll regions/states/provinces from locations_derived.
countries_derivedAll countries from locations_derived.
timezones_derivedAll timezones from locations_derived.
lats_derivedLatitudes derived from locations_derived.
lngs_derivedLongitudes derived from locations_derived.
date_modifiedDate and time of the most recent modification of the listing. Only returned when time_frame=6m.
modified_fieldsArray of field names that have changed in the most recent modification of the listing. Only returned when time_frame=6m.
ai_salary_currencySalary currency in ISO 4217 format.
ai_salary_valueSalary value when there is a single salary with no range.
ai_salary_min_valueMinimum salary in a range.
ai_salary_max_valueMaximum salary in a range.
ai_salary_unit_textSalary period: HOUR, DAY, WEEK, MONTH, or YEAR.
ai_benefitsNon-salary benefits mentioned in the job listing.
ai_experience_levelYears of experience required.
ai_work_arrangementRemote Solely (no office), Remote OK (optional office), Hybrid, or On-site.
ai_work_arrangement_office_daysWhen Hybrid, the number of days per week in office.
ai_remote_locationWhen remote but restricted to a certain location, returns that location.
ai_remote_location_derivedDerived remote location data matched with a location database (same as locations_derived).
ai_key_skillsKey skills mentioned in the job listing.
ai_hiring_manager_nameHiring manager name, if present.
ai_hiring_manager_email_addressHiring manager's email address, if present.
ai_core_responsibilitiesA 2-sentence summary of the job's core responsibilities.
ai_requirements_summaryA 2-sentence summary of the job's requirements.
ai_working_hoursRequired working hours. Defaults to 40 if not mentioned.
ai_employment_typeEmployment type as derived from the job description.
ai_job_languageLanguage of the job description.
ai_visa_sponsorshipTrue if the job description mentions visa sponsorship opportunities.
ai_taxonomies_aUp to 5 taxonomies per job ordered by relevancy (e.g., Technology, Healthcare, Finance & Accounting). The first item in the array is the primary taxonomy and is what the ai_taxonomies_a_primary filter matches against.
ai_keywordsImportant keywords: technologies, tools, skills, certifications, industry terms, methodologies, programming languages.
ai_educationExplicitly mentioned educational requirements from the job description.
org_linkedin_slugCompany-specific part of the LinkedIn URL (e.g., 'tesla-motors'). Unique per company. Always returned (regardless of include_basic_organization_details) so jobs can be joined to /organizations-advanced results.
org_linkedin_headcountNumber of employees according to LinkedIn. Returned when include_basic_organization_details=true.
org_linkedin_websiteCompany's main website URL (sourced from LinkedIn). Returned when include_basic_organization_details=true.
org_linkedin_sizeEmployee count range according to the company. Returned when include_basic_organization_details=true.
org_linkedin_sloganCompany's slogan. Returned when include_basic_organization_details=true.
org_linkedin_industryCompany's industry from LinkedIn's fixed list. Returned when include_basic_organization_details=true.
org_linkedin_followersNumber of LinkedIn followers. Not populated for all companies. Returned when include_basic_organization_details=true.
org_linkedin_headquartersCompany's HQ location. Returned when include_basic_organization_details=true.
org_linkedin_typeCompany type (e.g., 'Privately Held', 'Public'). Returned when include_basic_organization_details=true.
org_linkedin_founded_dateCompany's founded date. Returned when include_basic_organization_details=true.
org_linkedin_specialtiesCompany's specialties. Returned when include_basic_organization_details=true.
org_linkedin_locationsFull addresses of the company's locations. Returned when include_basic_organization_details=true.
org_linkedin_descriptionDescription from the company's LinkedIn page. Returned when include_basic_organization_details=true.
org_linkedin_recruitment_agency_derivedTrue if the company is a recruitment agency or job board (AI-identified). Returned when include_basic_organization_details=true.
org_linkedin_nameCompany's full name from LinkedIn. Returned when include_basic_organization_details=true.
org_crunchbase_categoriesList of Crunchbase categories the company is tagged with. Returned when include_basic_organization_details=true.
org_crunchbase_total_investmentTotal investment in USD raised by the company according to Crunchbase. Returned when include_basic_organization_details=true.
org_logo_permalinkStable Crustdata-hosted URL for the company's logo. Returned when include_basic_organization_details=true.
organization_logoDeprecated. ATS-supplied logo URL. Not present for all ATS and the underlying URL can break or expire. Use org_logo_permalink instead - a Crustdata-hosted permanent URL returned when include_basic_organization_details=true (or always present on /organizations-advanced).
ModifiedAtsJob
idThe job's internal ID. Used for expiration.
titleJob title.
date_createdDate & time of indexing in our database.
urlThe URL of the job.
sourceSource ATS or job board.
source_typeFor ModifiedAtsJob, this is always 'ats'.
date_modifiedDate and time of the most recent modification of the listing. Always present.
modified_fieldsArray of field names that have changed in the most recent modification of the listing. Always present.
organizationName of the hiring organization.
organization_urlURL to the organization's page.
date_postedDate & time of posting.
date_valid_throughDate & time of the future expiry date.
Source-supplied location objects per the Google JobPosting schema (e.g. {address: {addressLocality, addressRegion, addressCountry, postalCode}, ...}). Use locations_derived, cities_derived, regions_derived, countries_derived, lats_derived / lngs_derived for normalized, geocoded values.
locations_altFallback location string used when the source ATS doesn't supply structured location data in its Job Posting schema. Populated primarily from HTML scraping; for a small subset of ATS (currently ~4 of 54) it is AI-structured from the listing's free-text content. Null when the schema-supplied locations is sufficient.
Normalized location strings. Geocoded. This is the field used for location search.
location_typeTo identify remote jobs: 'TELECOMMUTE' per the Google JobPosting schema.
location_requirementsLocation requirement to accompany remote (TELECOMMUTE) jobs per the Google JobPosting schema.
salarySource-supplied salary object per the Google JobPosting schema. Often partial or missing. For a normalized numeric breakdown use ai_salary_value, ai_salary_min_value, ai_salary_max_value, ai_salary_currency, and ai_salary_unit_text.
employment_typeTypes like 'Full Time', 'Contract', 'Internship'. Usually a single value. For better accuracy, use ai_employment_type.
source_domainDomain of the career site or job board. Not present for all ATS; use domain_derived instead.
domain_derivedAI-discovered domain of the employer's main website.
description_textPlain text job description. Returned when description_format=text.
description_htmlRaw HTML job description. Returned when description_format=html.
cities_derivedAll cities from locations_derived.
counties_derivedAll counties from locations_derived. Only present when cities_derived is not.
regions_derivedAll regions/states/provinces from locations_derived.
countries_derivedAll countries from locations_derived.
timezones_derivedAll timezones from locations_derived.
lats_derivedLatitudes derived from locations_derived.
lngs_derivedLongitudes derived from locations_derived.
ai_salary_currencySalary currency in ISO 4217 format.
ai_salary_valueSalary value when there is a single salary with no range.
ai_salary_min_valueMinimum salary in a range.
ai_salary_max_valueMaximum salary in a range.
ai_salary_unit_textSalary period: HOUR, DAY, WEEK, MONTH, or YEAR.
ai_benefitsNon-salary benefits mentioned in the job listing.
ai_experience_levelYears of experience required.
ai_work_arrangementRemote Solely (no office), Remote OK (optional office), Hybrid, or On-site.
ai_work_arrangement_office_daysWhen Hybrid, the number of days per week in office.
ai_remote_locationWhen remote but restricted to a certain location, returns that location.
ai_remote_location_derivedDerived remote location data matched with a location database (same as locations_derived).
ai_key_skillsKey skills mentioned in the job listing.
ai_hiring_manager_nameHiring manager name, if present.
ai_hiring_manager_email_addressHiring manager's email address, if present.
ai_core_responsibilitiesA 2-sentence summary of the job's core responsibilities.
ai_requirements_summaryA 2-sentence summary of the job's requirements.
ai_working_hoursRequired working hours. Defaults to 40 if not mentioned.
ai_employment_typeEmployment type as derived from the job description.
ai_job_languageLanguage of the job description.
ai_visa_sponsorshipTrue if the job description mentions visa sponsorship opportunities.
ai_taxonomies_aUp to 5 taxonomies per job ordered by relevancy (e.g., Technology, Healthcare, Finance & Accounting). The first item in the array is the primary taxonomy and is what the ai_taxonomies_a_primary filter matches against.
ai_keywordsImportant keywords: technologies, tools, skills, certifications, industry terms, methodologies, programming languages.
ai_educationExplicitly mentioned educational requirements from the job description.
org_linkedin_slugCompany-specific part of the LinkedIn URL (e.g., 'tesla-motors'). Unique per company. Always returned (regardless of include_basic_organization_details) so jobs can be joined to /organizations-advanced results.
org_linkedin_headcountNumber of employees according to LinkedIn. Returned when include_basic_organization_details=true.
org_linkedin_websiteCompany's main website URL (sourced from LinkedIn). Returned when include_basic_organization_details=true.
org_linkedin_sizeEmployee count range according to the company. Returned when include_basic_organization_details=true.
org_linkedin_sloganCompany's slogan. Returned when include_basic_organization_details=true.
org_linkedin_industryCompany's industry from LinkedIn's fixed list. Returned when include_basic_organization_details=true.
org_linkedin_followersNumber of LinkedIn followers. Not populated for all companies. Returned when include_basic_organization_details=true.
org_linkedin_headquartersCompany's HQ location. Returned when include_basic_organization_details=true.
org_linkedin_typeCompany type (e.g., 'Privately Held', 'Public'). Returned when include_basic_organization_details=true.
org_linkedin_founded_dateCompany's founded date. Returned when include_basic_organization_details=true.
org_linkedin_specialtiesCompany's specialties. Returned when include_basic_organization_details=true.
org_linkedin_locationsFull addresses of the company's locations. Returned when include_basic_organization_details=true.
org_linkedin_descriptionDescription from the company's LinkedIn page. Returned when include_basic_organization_details=true.
org_linkedin_recruitment_agency_derivedTrue if the company is a recruitment agency or job board (AI-identified). Returned when include_basic_organization_details=true.
org_linkedin_nameCompany's full name from LinkedIn. Returned when include_basic_organization_details=true.
org_crunchbase_categoriesList of Crunchbase categories the company is tagged with. Returned when include_basic_organization_details=true.
org_crunchbase_total_investmentTotal investment in USD raised by the company according to Crunchbase. Returned when include_basic_organization_details=true.
org_logo_permalinkStable Crustdata-hosted URL for the company's logo. Returned when include_basic_organization_details=true.
organization_logoDeprecated. ATS-supplied logo URL. Not present for all ATS and the underlying URL can break or expire. Use org_logo_permalink instead - a Crustdata-hosted permanent URL returned when include_basic_organization_details=true (or always present on /organizations-advanced).
ActiveJbJob
idThe job's internal ID. Used for expiration.
titleJob title.
date_createdDate & time of indexing in our database.
urlThe URL of the job.
sourceSource job board.
source_typeFor ActiveJbJob, this is always 'jobboard'.
organizationName of the hiring organization.
organization_urlURL to the organization's page.
organization_logoURL to the organization's logo.
date_postedDate & time of posting.
date_valid_throughDate & time of the future expiry date.
Source-supplied location objects per the Google JobPosting schema (e.g. {address: {addressLocality, addressRegion, addressCountry, postalCode}, ...}). Use locations_derived, cities_derived, regions_derived, countries_derived, lats_derived / lngs_derived for normalized, geocoded values.
Normalized location strings. Geocoded. This is the field used for location search.
location_typeTo identify remote jobs: 'TELECOMMUTE' per the Google JobPosting schema.
location_requirementsLocation requirement to accompany remote (TELECOMMUTE) jobs per the Google JobPosting schema.
salarySource-supplied salary object per the Google JobPosting schema. Often partial or missing. For a normalized numeric breakdown use ai_salary_value, ai_salary_min_value, ai_salary_max_value, ai_salary_currency, and ai_salary_unit_text.
employment_typeTypes like 'Full Time', 'Contract', 'Internship'. Usually a single value. For better accuracy, use ai_employment_type.
source_domainDomain of the job board.
description_textPlain text job description. Returned when description_format=text. Description search returns a 400 error when used with time_frame=6m.
description_htmlRaw HTML job description. Returned when description_format=html. Description search returns a 400 error when used with time_frame=6m.
cities_derivedAll cities from locations_derived.
counties_derivedAll counties from locations_derived. Only present when cities_derived is not.
regions_derivedAll regions/states/provinces from locations_derived.
countries_derivedAll countries from locations_derived.
timezones_derivedAll timezones from locations_derived.
lats_derivedLatitudes derived from locations_derived.
lngs_derivedLongitudes derived from locations_derived.
ai_salary_currencySalary currency in ISO 4217 format.
ai_salary_valueSalary value when there is a single salary with no range.
ai_salary_min_valueMinimum salary in a range.
ai_salary_max_valueMaximum salary in a range.
ai_salary_unit_textSalary period: HOUR, DAY, WEEK, MONTH, or YEAR.
ai_benefitsNon-salary benefits mentioned in the job listing.
ai_experience_levelYears of experience required.
ai_work_arrangementRemote Solely (no office), Remote OK (optional office), Hybrid, or On-site.
ai_work_arrangement_office_daysWhen Hybrid, the number of days per week in office.
ai_remote_locationWhen remote but restricted to a certain location, returns that location.
ai_remote_location_derivedDerived remote location data matched with a location database (same as locations_derived).
ai_key_skillsKey skills mentioned in the job listing.
ai_hiring_manager_nameHiring manager name, if present.
ai_hiring_manager_email_addressHiring manager's email address, if present.
ai_core_responsibilitiesA 2-sentence summary of the job's core responsibilities.
ai_requirements_summaryA 2-sentence summary of the job's requirements.
ai_working_hoursRequired working hours. Defaults to 40 if not mentioned.
ai_employment_typeEmployment type as derived from the job description.
ai_job_languageLanguage of the job description.
ai_visa_sponsorshipTrue if the job description mentions visa sponsorship opportunities.
ai_taxonomies_aUp to 5 taxonomies per job ordered by relevancy (e.g., Technology, Healthcare, Finance & Accounting). The first item in the array is the primary taxonomy and is what the ai_taxonomies_a_primary filter matches against.
ai_keywordsImportant keywords: technologies, tools, skills, certifications, industry terms, methodologies, programming languages.
ai_educationExplicitly mentioned educational requirements from the job description.
org_linkedin_slugCompany-specific part of the LinkedIn URL (e.g., 'tesla-motors'). Unique per company. Always returned so jobs can be joined to /organizations-advanced results.
org_linkedin_headcountNumber of employees according to LinkedIn.
org_linkedin_websiteCompany's main website URL (sourced from LinkedIn).
org_linkedin_sizeEmployee count range according to the company.
org_linkedin_sloganCompany's slogan.
org_linkedin_industryCompany's industry from LinkedIn's fixed list.
org_linkedin_followersNumber of LinkedIn followers. Not populated for all companies.
org_linkedin_headquartersCompany's HQ location.
org_linkedin_typeCompany type (e.g., 'Privately Held', 'Public').
org_linkedin_founded_dateCompany's founded date.
org_linkedin_specialtiesCompany's specialties.
org_linkedin_locationsFull addresses of the company's locations.
org_linkedin_descriptionDescription from the company's LinkedIn page.
org_linkedin_recruitment_agency_derivedTrue if the company is a recruitment agency or job board (AI-identified).
recruiter_nameName of the recruiter who posted the job. Excluded when exclude_recruiter_fields=true.
recruiter_titleTitle of the recruiter. Excluded when exclude_recruiter_fields=true.
recruiter_urlURL to the recruiter's profile. Excluded when exclude_recruiter_fields=true.
senioritySeniority level as listed by the job board.
direct_applyTrue if the job supports direct application on the job board (e.g. LinkedIn Easy Apply).
no_jb_schemaTrue if the job board listing has no structured schema data.
ats_duplicateTrue if this job is a duplicate of an ATS listing.
linkedin_idLinkedIn job posting ID.
ExpiredAtsJobId
Internal ID of an expired ATS job, returned as an item by /expired-ats. Match against ActiveAtsJob.id to expire stale rows in your store.
ExpiredJbJobId
Internal ID of an expired job board listing, returned as an item by /expired-jb. Match against ActiveJbJob.id to expire stale rows in your store. Only LinkedIn (source=linkedin) listings are re-checked for expiration; IDs from other JB sources (wellfound, ycombinator) will never appear in this feed.
Organization
organizationName of the organization as listed in the ATS.
domain_derivedDerived company domain.
org_linkedin_slugCompany-specific part of the LinkedIn URL (e.g., 'tesla-motors'). Unique per company. Used to join organizations against jobs returned by /active-ats, /active-jb, and /modified-ats.
org_linkedin_nameCanonical company name from LinkedIn.
org_linkedin_industryCompany's industry from LinkedIn's fixed list.
org_linkedin_headcountNumber of employees according to LinkedIn.
org_linkedin_headquartersCompany's HQ location.
OrganizationAdvanced
idInternal organization ID.
org_linkedin_nameCanonical company name from LinkedIn.
org_linkedin_urlURL of the company's LinkedIn page.
org_linkedin_slugCompany-specific part of the LinkedIn URL (e.g., 'tesla-motors'). Unique per company. Used to join organizations against jobs returned by /active-ats, /active-jb, and /modified-ats.
org_linkedin_descriptionDescription from the company's LinkedIn page.
org_linkedin_short_descriptionShort tagline or description.
org_linkedin_headcountCurrent number of employees according to LinkedIn.
org_linkedin_followersNumber of LinkedIn followers.
org_linkedin_sizeEmployee count range according to the company (e.g., '1001-5000').
org_linkedin_industryCompany's primary industry from LinkedIn's fixed list.
org_linkedin_headquartersCompany's HQ location.
org_linkedin_typeCompany type (e.g., 'Privately Held', 'Public Company').
org_linkedin_founded_dateCompany's founded date.
org_linkedin_specialtiesCompany's specialties.
org_linkedin_locationsFull addresses of the company's locations.
org_linkedin_sloganCompany's slogan.
org_linkedin_logoURL to the company's LinkedIn logo.
org_linkedin_websiteCompany's main website URL.
org_linkedin_recruitment_agency_derivedTrue if the company is a recruitment agency or job board (AI-identified).
org_linkedin_industriesAll LinkedIn industry tags for the company.
org_linkedin_idLinkedIn's internal company ID. Same numeric type as linkedin_id on /active-jb (which is LinkedIn's job ID), but a different identifier - this one identifies the company, the job-side linkedin_id identifies the posting.
org_linkedin_estimated_revenue_lower_bound_usdLower bound of estimated annual revenue in USD.
org_linkedin_estimated_revenue_higher_bound_usdUpper bound of estimated annual revenue in USD.
org_linkedin_largest_headcount_countryCountry with the most employees.
org_naicsPrimary NAICS industry classification.
org_sicSIC industry classification codes.
org_marketsMarket segments the company operates in.
org_twitter_urlCompany's Twitter/X profile URL.
org_logo_permalinkPermanent URL to the company logo.
org_crunchbase_profile_urlURL to the company's Crunchbase profile.
org_crunchbase_profile_uuidCrunchbase profile UUID.
org_crunchbase_fiscal_year_endMonth the company's fiscal year ends.
org_crunchbase_acquisition_statusAcquisition status (e.g., 'acquired', 'pending').
org_crunchbase_ipo_dateIPO date if applicable.
org_crunchbase_categoriesCrunchbase industry categories.
org_glassdoor_review_countTotal number of Glassdoor reviews.
org_glassdoor_salary_countTotal number of Glassdoor salary reports.
org_glassdoor_interview_countTotal number of Glassdoor interview reports.
org_glassdoor_benefit_countTotal number of Glassdoor benefit reports.
org_glassdoor_primary_industry_namePrimary industry name on Glassdoor.
org_glassdoor_primary_industry_sector_namePrimary industry sector on Glassdoor.
org_glassdoor_culture_and_values_ratingCulture & values rating (0-5).
org_glassdoor_diversity_and_inclusion_ratingDiversity & inclusion rating (0-5).
org_glassdoor_work_life_balance_ratingWork-life balance rating (0-5).
org_glassdoor_senior_management_ratingSenior management rating (0-5).
org_glassdoor_compensation_and_benefits_ratingCompensation & benefits rating (0-5).
org_glassdoor_career_opportunities_ratingCareer opportunities rating (0-5).
org_glassdoor_recommend_to_friend_ratingRecommend to friend rating (0-5).
org_glassdoor_business_outlook_ratingBusiness outlook rating (0-5).
org_glassdoor_profile_urlURL to the company's Glassdoor profile.
Crunchbase funding and investment data. Returned when include_crunchbase_funding_and_investment=true.
LinkedIn headcount data with role, skill, and region breakdowns. Returned when include_linkedin_headcount_timeseries=true. Each *_metrics object is a distribution map: keys are bucket labels (all_roles, 0_to_10_percent, 11_to_30_percent, 31_to_50_percent, 51_to_70_percent, 71_to_100_percent); values are nullable strings listing the roles/skills/regions that fall into that share-of-headcount bucket.
LinkedIn follower data with growth rates. Returned when include_linkedin_followers_timeseries=true.
Monthly estimated revenue over time. Returned when include_linkedin_estimated_revenue_timeseries=true.
Recent news articles mentioning the company. Returned when include_news_articles=true.
Recent Glassdoor employee reviews. Returned when include_glassdoor_reviews=true.