TheirStack / Search job postings

Request parameters

• blur_company_data body · optional

  Enable preview mode to return blurred data without consuming credits in the TheirStack app. Through the API it works by default only on paid workspaces created before August 11, 2026; on any other workspace, including free ones, it is available only upon request; contact support@theirstack.com to request access. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. Not available when filtering by company identifiers...

• closed_at_gte body · optional

  ISO 8601 date string (yyyy-mm-dd). Only return jobs closed on this date or after.

• closed_at_lte body · optional

  ISO 8601 date string (yyyy-mm-dd). Only return jobs closed on this date or before.

• company_country_code_not body · optional

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

• company_country_code_or body · optional

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

• company_domain_not body · optional

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

• company_domain_or body · optional

  Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (jane.doe@example.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.

• company_id_not body · optional

  Exclude companies that match these IDs. This filter acts as a NOT filter, so if you pass more than one company ID, it will exclude companies that match any of the IDs.

• company_id_or body · optional

  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.

• company_investors_or body · optional

  Investors of the company

• company_keyword_slug_and body · optional

  Return results from companies that have mentioned all of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)

• company_keyword_slug_not body · optional

  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](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)

• company_keyword_slug_or body · optional

  Return results from companies that have mentioned any of these keywords in their jobs. Case sensitive. Pass slugs. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)

• company_linkedin_url_exists body · optional

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

• company_linkedin_url_or body · optional

  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...

• company_list_id_not body · optional

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

• company_list_id_or body · optional

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

• company_location_pattern_or body · optional

  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.

• company_name_not body · optional

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

• company_name_or body · optional

  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 body · optional

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

• company_tags_or body · optional

  Return companies that match any of these keywords

• company_technology_slug_and body · optional

  Will return jobs from companies that that have mentioned all of these technologies in their jobs (not necessarily in the jobs returned). Case sensitive. Pass slugs. Check out all the technologies we track at [GET /v0/catalog/technologies](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0)

• company_technology_slug_not body · optional

  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](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0)

• company_technology_slug_or body · optional

  Will return jobs from companies that that have mentioned any of these technologies in their jobs (not necessarily in the jobs returned). Case sensitive. Pass slugs. Check out all the technologies we track at [GET /v0/catalog/technologies](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0)

• company_type body · optional

  Filter by company type.

• cursor body · optional

  Cursor for pagination

• discovered_at_gte body · optional

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

• discovered_at_lte body · optional

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

• discovered_at_max_age_days body · optional

  If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.

• discovered_at_min_age_days body · optional

  If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.

• easy_apply body · optional

  If True, only return jobs that can be applied directly through the job board. If False, only return jobs that require redirecting to the company's website.

• employment_statuses_or body · optional

  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.

• final_url_exists body · optional

  (Use `property_exists_or / property_exists_and` instead) Only return jobs with a final URL. Typically jobs that were originally posted on an ATS. If True, only return jobs with a final URL. If False, only return jobs without a final URL. If None, return all jobs.

• funding_stage_or body · optional

  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', '...

• hiring_managers_exists body · optional

  (Use `property_exists_or / property_exists_and` instead) If True, only return jobs with a hiring manager. If False, only return jobs without a hiring manager. If None, return all jobs.

• include_total_results body · optional

  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_id_not body · optional

  Industry ids to exclude.You can use any of [LinkedIn's Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2) or [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)

• industry_id_not_or_null body · optional

  Industry ids to exclude. Companies whose industry we don't know are returned as well. You can use any of [LinkedIn's Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2) or [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)

• industry_id_or body · optional

  Industry codes. You can use any of [LinkedIn's Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2) or [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0)

• industry_not body · optional

  Names of industries, case-insensitive. Results will exclude companies that belong to any of the industries specified in this parameter. Available values: [GET /v0/catalog/industries](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0) WARNING: Deprecated parameter. Use the industry_id_not field instead.

• industry_or body · optional

  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](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0) WARNING: Deprecated parameter. Use the industry_id_or field instead.

• is_closed body · optional

  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.

• job_country_code_not body · optional

  2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries

• job_country_code_or body · optional

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

• job_description_contains_not body · optional

  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 body · optional

  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_and body · optional

  Regex patterns that must ALL match the job description (AND logic). Use (?i) at the start of a pattern to make it case-insensitive. Results will only include jobs whose description matches every pattern in this list.

• job_description_pattern_not body · optional

  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.

• job_description_pattern_or body · optional

  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.

• job_export_key_or body · optional

  Internal export lookup keys for fetching a materialized job batch.

• job_id_not body · optional

  Exclude jobs with these IDs.

• job_id_or body · optional

  Get jobs with these IDs only.

• job_ids body · optional

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

• job_keyword_slug_and body · optional

  Will return jobs where all of these keyword slugs appear. Case sensitive. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)

• job_keyword_slug_not body · optional

  Will return jobs where none of these keyword slugs appear. Case sensitive. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)

• job_keyword_slug_or body · optional

  Will return jobs where any of these keyword slugs appear. Case sensitive. Check out all the keywords we track at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)

• job_location_not body · optional

  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](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0))

• job_location_or body · optional

  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](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0))

• job_location_pattern_not body · optional

  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. WARNING: Deprecated parameter. Use the `job_location_not` filter instead — it uses structured location IDs from the [locations catalog](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0), which...

• job_location_pattern_or body · optional

  Regex patterns to match 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 returned. WARNING: Deprecated parameter. Use the `job_location_or` filter instead — it uses structured location IDs from the [locations catalog](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0), which is more precise,...

• job_seniority_or body · optional

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

• job_technology_slug_and body · optional

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

• job_technology_slug_not body · optional

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

• job_technology_slug_or body · optional

  Will return jobs where any of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint. If you pass more than one technology, we will return jobs that mentnion all of the technologies.

• job_title_not body · optional

  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`.

• job_title_or body · optional

  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.

• job_title_pattern_and body · optional

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

• job_title_pattern_not body · optional

  Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.

• job_title_pattern_or body · optional

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

• last_funding_round_date_gte body · optional

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

• last_funding_round_date_lte body · optional

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

• limit body · required

  Number of results per page Bounded 1-25 by looot; required, see endpoint description. Example: 1

• max_employee_count body · optional

  Maximum number of employees in a company

• max_employee_count_or_null body · optional

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

• max_funding_usd body · optional

  Maximum company funding, in USD

• max_revenue_usd body · optional

  Maximum company revenue, in USD

• max_salary_usd body · optional

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

• min_employee_count body · optional

  Minimum number of employees in a company

• min_employee_count_or_null body · optional

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

• min_funding_usd body · optional

  Minimum company funding, in USD

• min_revenue_usd body · optional

  Minimum company revenue, in USD

• min_salary_usd body · optional

  Minimum annual salary in USD. For example, 100000 means $100,000.

• offset body · optional

  Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination). Example: 0

• only_jobs_with_reports_to body · optional

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

• only_yc_companies body · optional

  Only return YC companies

• order_by body · optional

  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.

• page body · optional

  Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination). Example: 0

• posted_at_gte body · optional

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

• posted_at_lte body · optional

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

• posted_at_max_age_days body · optional

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

• property_exists_and body · optional
• property_exists_or body · optional

  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.

• remote body · optional

  Deprecated. Use workplace_types_or instead. True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.

• reports_to_exists body · optional

  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.

• revealed_company_data body · optional

  This field is deprecated and has no effect.

• scraper_name_pattern_or body · optional

  Regex patterns to match job sources. Case-insensitive.

• url_domain_not body · optional

  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.

• url_domain_or body · optional

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

• workplace_types_or body · optional

  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.