We’re releasing a new version of the Job Search endpoint with significant changes for more consistency and easiness of use. Majorly:
_exclude and others would end in _not. Now this is fixed.The path of the new endpoint is /v1/jobs/search (the old one was /v0/jobs/search)
API docs are available at https://api.theirstack.com/openapi#/Jobs/search_jobs_v1_jobs_search_post
| Old parameter name | New parameter name | Deprecated in v1 | New in v1 | Moved from query parameters to body | New structure |
|---|---|---|---|---|---|
| page | yes | ||||
| limit | yes | ||||
| order_by | yes | Yes. Before it was a string, now it’s an array of objects. See more details in the API docs. | |||
| include_total_results | yes | ||||
| companies | company_name_or | ||||
| companies_urls | company_domain_or | ||||
| companies_exclude | company_name_not | ||||
| companies_partial_names | company_name_partial_match_or | ||||
| companies_partial_names_exclude | company_name_partial_match_not | ||||
| company_description_patterns_or | company_description_pattern_or | yes | |||
| company_description_patterns_exclude | company_description_pattern_not | yes | |||
| company_descriptions_accent_insensitive | company_description_pattern_accent_insensitive | yes | |||
| min_employee_count | yes | ||||
| max_employee_count | yes | ||||
| min_funding_usd | yes | ||||
| max_funding_usd | yes | ||||
| funding_stages | funding_stage_or | ||||
| industries | industry_or | yes | |||
| industries_exclude | industry_not | yes | |||
| keywords_or | company_tags_or | yes | |||
| include_only_companies_from_lists | yes | ||||
| company_list_id_or | yes | ||||
| exclude_companies_from_lists | yes | ||||
| company_list_id_not | yes | ||||
| company_type | yes | ||||
| investors | company_investors_or | ||||
| investors_substrings | company_investors_partial_match_or | ||||
| company_technologies | yes | ||||
| company_technology_slug_or | yes | ||||
| only_yc_companies | yes | ||||
| job_title_natural_language_patterns_or | job_title_or | ||||
| job_title_natural_language_patterns_not | job_title_not | ||||
| job_title_patterns_or | job_title_pattern_or | ||||
| job_title_patterns | job_title_pattern_and | ||||
| job_title_patterns_not | job_title_pattern_not | ||||
| country_codes | job_country_code_or | yes | |||
| country_codes_exclude | job_country_code_not | yes | |||
| fromage | posted_at_max_age_days | yes | |||
| max_age_days_created_at | created_at_max_age_days | yes | |||
| since | posted_at_gte | ||||
| until | posted_at_lte | ||||
| job_description_patterns | job_description_pattern_or | ||||
| job_description_patterns_not | job_description_pattern_not | ||||
| job_description_pattern_is_case_insensitive | yes | ||||
| remote | yes | ||||
| only_jobs_with_reports_to | yes | ||||
| only_jobs_with_hiring_managers | |||||
| job_ids | |||||
| min_salary_usd | yes | ||||
| max_salary_usd | yes | ||||
| technologies_or | yes | yes | |||
| job_technology_slug_or | yes | ||||
| technologies_and | yes | yes | |||
| job_technology_slug_and | yes | ||||
| location_patterns | job_location_pattern_or | yes | |||
| location_patterns_exclude | job_location_pattern_not | yes | |||
| scraper_name_patterns | scraper_name_pattern_or | yes | |||
| countries | yes | ||||
| company_country_code_or | yes |
Still to be migrated