Job Search Theirstack API

Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.

Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.

Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).

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.

Investors of the company. Will return companies for which any of their investors contains any of the substrings passed here. For example, if you pass 'andree', all funds that match it (like 'Andreessen Horowitz', 'Andreessen Horowitz LLC', etc).

Return results from companies that haven't mentioned any of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at GET /v0/catalog/keywords

(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL

Return companies that don't belong to any of the company lists passed here

Return companies whose city matches any of the patterns passed here. Case insensitive. For example, if you pass 'san francisco', it will return companies whose city is 'San Francisco', 'San Francisco Bay Area', etc.

Only return companies that don't match these names exactly, case-sensitively.

Company names. Will return companies whose name doesn't contain any of the the substrings passed here, case-insensitively. For example, if you pass 'google', it will exclude 'Google', 'Google LLC', 'Google Inc', etc.

Return companies that match any of these keywords

Will return jobs from companies that that haven't mentioned any of these technologies in their jobs. Case sensitive. Pass slugs. Check out all the technologies we track at GET /v0/catalog/technologies. Deprecated: use company_keyword_slug_not instead.

Filter by company type.

Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.

If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, 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.

Funding stages of companies returned. Possible values: ['angel', 'convertible_note', 'debt_financing', 'equity_crowdfunding', 'other', 'private_equity', 'seed', 'series_a', 'series_b', 'series_c', 'series_d', 'series_e', 'series_f', 'series_g', 'series_h', 'venture_round_not_specified', 'series_i', 'series_j', 'undisclosed', 'series_unknown', 'pre_seed', 'post_ipo_secondary', 'post_ipo_equity', 'post_ipo_debt', 'non_equity_assistance', 'late_vc', 'initial_coin_offering', 'growth_equity_vc', 'grant', 'early_vc', 'corporate_round', 'secondary_market', 'product_crowdfunding']

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.

Industry codes. You can use any of LinkedIn's Industry Codes V2 or GET /v0/catalog/industries

Names of industries, case-insensitive. Results will only include companies that belong to any of the industries specified in this parameter. Available values: GET /v0/catalog/industries WARNING: Deprecated parameter. Use the industry_id_or field instead.

["US"]

2-letter ISO country code of the location of the job. Can pass more than 1

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.

Deprecated. Use job_description_pattern_or instead, which now behaves identically.

Regex patterns to look for in job descriptions. Case-sensitive. Results will include jobs whose description don't match any of these patterns. Use (?i) at the start of a pattern to make it case-insensitive. Can pass more than one.

Exclude jobs with these IDs.

Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.

Will return jobs where none 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)

Regex patterns to exclude job locations. Case-insensitive. Searches both the location field and the enhanced locations array (using normalized city and state name fields within each location element). Jobs matching ANY of the provided patterns will be EXCLUDED from results. Use this to filter out specific locations.

Will return jobs where the seniority is any of the ones passed here

Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.

Natural language patterns to match job titles. Case-insensitive. Only jobs with title that do not match any of these patterns will be returned. Uses Postgres full text search.

Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.

Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.

Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'

Maximum number of employees in a company

Maximum company funding, in USD

Maximum annual salary in USD. For example, 150000 means $150,000.

Minimum number of employees in a company. If we don't have company size information, we will return it as well.

Minimum company revenue, in USD

Number of results to skip. Required for offset-based pagination.

Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.

List of column objects. You can pass several columns to order by, in order of priority. Only `field` is required, `desc` is True by default.

ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.

14

Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.

Return jobs that have any of these fields not null. For example, if you pass ['final_url'], it will return jobs that have a final_url set. This field also support chaining of fields. For example, if you pass ['company_object.domain', 'company_object.linkedin_url'], it will return jobs that have a company domain or a company linkedin_url set.

Only return jobs where we identified the role the hired person would report to. If True, only return jobs where we identified the role the hired person would report to. If False, only return jobs where we didn't identify the role the hired person would report to. If None, return all jobs.

Exclude jobs if their URL domain (from `url` or `source_url`) is in the provided case-insensitive list. For example, ['greenhouse.io', 'workable.com'] will exclude URLs containing 'greenhouse.io' or 'workable.com'. Refer to our list of sources at https://theirstack.com/en/docs/data/job/sources.