Search job postings by title, description keywords, technology, location, salary, seniority, workplace type, posting date and company. Returns matching jobs with id, job title, url, date posted, company, location, salary, seniority, technology slugs and description, plus metadata with result totals. Use search_jobs to find individual job postings. Use search_companies to find companies and get_company_technologies for one company's tech stack. Each job returned uses 1 API credit. At least one of posted_at_max_age_days, posted_at_gte, posted_at_lte, job_id_or, company_domain_or, company_linkedin_url_or, company_name_or, company_name_case_insensitive_or or company_name_partial_match_or must be set, otherwise the request fails.
Parameters
Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.
Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (andrew@stripe.com).
Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (andrew@stripe.com). This filter acts as an OR filter, so if you pass more than one company domain, it will return companies that match any of the domains.
Only return companies that match these IDs exactly. This filter acts as an OR filter, so if you pass more than one company ID, it will return companies that match any of the IDs.
Return companies whose LinkedIn page matches any of the values passed here. Both forms of LinkedIn company URL work, the vanity slug (`https://www.linkedin.com/company/google/`) and the numeric company ID (`https://www.linkedin.com/company/1038`), as do a bare slug (`google`) and a bare numeric ID (`1038`). A numeric value is matched against the company's LinkedIn ID and its slug, so you do not need to know which of the two you are holding. We have a LinkedIn slug for ~26% of companies and a numeric LinkedIn ID for ~14%, so if you have the company's domain, `company_domain_or` matches more often.
company_name_case_insensitive_or
Only return companies that match these names exactly, case-insensitively.
Only return companies that match these names exactly, case-sensitively. This filter acts as an OR filter, so if you pass more than one company name, it will return companies that match any of the names.
company_name_partial_match_or
Company names. Will return companies whose name contains any of the substrings passed here, case-insensitively. For example, if you pass "google", it will return "Google", "Google LLC", "Google Inc", etc.
company_technology_slug_or
Return results from companies that have mentioned any of these technologies in their jobs (in job searches, not necessarily in the jobs returned). Case sensitive. Pass slugs. Check out all the technologies we track at GET /v0/catalog/keywords with `keyword_type=technology`
Filter by company type. One of: `recruiting_agency`, `direct_employer`, `all`.
Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.
Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.
discovered_at_max_age_days
If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.
Filter jobs by employment status. Returns jobs that match any of the specified employment types. If no values are provided or an empty list is sent, all jobs regardless of employment status will be returned.
When enabled, calculates and returns `total_results` and `total_companies` fields in the response. WARNING: This significantly slows down responses as it requires reading the entire dataset. Recommended usage: enable only for the initial request to get totals, then disable for subsequent pagination requests.
If True, only return closed jobs (jobs where TheirStack detected the posting was closed). If False, only return open jobs. If None, return all jobs regardless of closure status.
2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries
2-letter ISO country code of the location of the job. Can pass more than 1
job_description_contains_not
Exclude jobs whose description contains any of these whole words using word boundaries (\b). Case-insensitive by default, except for the patterns that are uppercase - in that case we'll respect it. Only finds complete words (e.g., searching 'quality' won't match 'inequality'). Results will exclude jobs whose description contains any of these words.
job_description_contains_or
Search for whole words in job descriptions using word boundaries (\b). Case-insensitive by default, except for the patterns that are uppercase - in that case we'll respect it. Only finds complete words (e.g., searching 'quality' won't match 'inequality'). Results will include jobs whose description contains any of these words.
job_description_pattern_or
Regex patterns to look for in job descriptions. Case-sensitive. Results will include jobs whose description matches any of these patterns. Use (?i) at the start of a pattern to make it case-insensitive. Can pass more than one.
Get jobs with these IDs only.
Will return jobs where any of these keyword slugs appear. Case sensitive. Check out all the keywords we track at GET /v0/catalog/keywords
Filter jobs by location. Returns jobs whose locations DO NOT match ANY of the specified location criteria. Each location criteria is specified using a JobLocationFilter object. (You can find location IDs using the locations catalog endpoint)
Filter jobs by location. Returns jobs whose locations match ANY of the specified location criteria. Each location criteria is specified using a JobLocationFilter object. (You can find location IDs using the locations catalog endpoint)
Will return jobs where the seniority is any of the ones passed here
Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track at GET /v0/catalog/keywords with `keyword_type=technology`.
Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track at GET /v0/catalog/keywords with `keyword_type=technology`.
Will return jobs where any of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track at GET /v0/catalog/keywords with `keyword_type=technology`. If you pass more than one technology, we will return jobs that mention at least one of them.
Keyword-based patterns to exclude job titles. Case-insensitive. Excludes jobs whose title contains all the words in any of the patterns, in any order. For example, `marketing vp` excludes titles such as `VP of Marketing` or `Marketing VP, EMEA`.
Keyword-based patterns to match job titles. Case-insensitive. Returns jobs whose title contains all the words in any of the patterns, in any order. For example, `marketing vp` matches titles such as `VP of Marketing` or `Marketing VP, EMEA`. Passing `["software engineer", "data scientist"]` returns jobs matching either pattern.
Number of results per page
Maximum number of employees in a company
Maximum annual salary in USD. For example, 150000 means $150,000.
Minimum number of employees in a company
Minimum annual salary in USD. For example, 100000 means $100,000.
Number of results to skip. Required for offset-based pagination.
Page number. Required when using page-based pagination.
ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.
ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.
Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.
Filter jobs by workplace type. Returns jobs that match any of the specified workplace types. `on_site` matches jobs that are neither hybrid nor remote. If no values are provided or an empty list is sent, jobs are not filtered by workplace type.