• discovered_at_max_age_days
    integernullable

    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
    integernullable

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

  • easy_apply
    booleannullable

    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
    array<Commitment>nullable

    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
    booleannullable
    deprecated

    (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
    array<string>
    default: []

    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']

  • hiring_managers_exists
    booleannullable
    deprecated

    (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
    boolean
    default: false

    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
    array<integer>
    default: []

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

  • industry_id_or
    array<integer>
    default: []

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

  • industry_not
    array<string>
    default: []
    deprecated

    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

    WARNING: Deprecated parameter. Use the industry_id_not field instead. 
    
  • industry_or
    array<string>
    default: []
    deprecated

    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. 
    
  • job_country_code_not
    array<string>
    default: []

    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
    array<string>
    default: []

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

  • job_description_contains_not
    array<string>
    default: []

    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
    array<string>
    default: []

    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
    array<string>
    default: []

    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_case_sensitive_or
    array<string>
    default: []
    deprecated

    Deprecated. Use job_description_pattern_or instead, which now behaves identically.

  • job_description_pattern_is_case_insensitive
    booleannullable
    default: true
    deprecated

    Deprecated. Has no effect.

  • job_description_pattern_not
    array<string>
    default: []

    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
    array<string>
    default: []

    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_id_not
    array<integer>
    default: []

    Exclude jobs with these IDs.

  • job_id_or
    array<integer>
    default: []

    Get jobs with these IDs only.

  • job_ids
    array<integer>
    default: []
    deprecated

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

  • job_keyword_slug_and
    array<string>
    default: []

    Will return jobs where all of these keyword slugs appear. Case sensitive. Check out all the keywords we track at GET /v0/catalog/keywords

  • job_keyword_slug_not
    array<string>
    default: []

    Will return jobs where none of these keyword slugs appear. Case sensitive. Check out all the keywords we track at GET /v0/catalog/keywords

  • job_keyword_slug_or
    array<string>
    default: []

    Will return jobs where any of these keyword slugs appear. Case sensitive. Check out all the keywords we track at GET /v0/catalog/keywords

  • job_location_not
    array<JobLocationFilter>
    default: []

    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)

  • job_location_or
    array<JobLocationFilter>
    default: []

    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)

  • job_location_pattern_not
    array<string>
    default: []
    deprecated

    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, which is more precise, supports hierarchical (country/region/city) and multi-language searches, has fewer false positives, and benefits from indexed lookups and recent accuracy fixes.

  • job_location_pattern_or
    array<string>
    default: []
    deprecated

    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, which is more precise, supports hierarchical (country/region/city) and multi-language searches, has fewer false positives, and benefits from indexed lookups and recent accuracy fixes.

  • job_seniority_or
    array<string>
    default: []

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

  • job_technology_slug_and
    array<string>
    default: []

    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
    array<string>
    default: []

    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
    array<string>
    default: []

    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
    array<string>
    default: []

    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
    array<string>
    default: []

    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
    array<string>
    default: []

    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
    array<string>
    default: []

    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
    array<string>
    default: []

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

  • last_funding_round_date_gte
    stringnullable
    date

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

  • last_funding_round_date_lte
    stringnullable
    date

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

  • limit
    integer
    1 <= valuedefault: 25

    Number of results per page

  • max_employee_count
    integernullable

    Maximum number of employees in a company

  • max_employee_count_or_null
    integernullable

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

  • max_funding_usd
    integernullable

    Maximum company funding, in USD

  • max_revenue_usd
    integernullable

    Maximum company revenue, in USD

  • max_salary_usd
    numbernullable

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

  • min_employee_count
    integernullable

    Minimum number of employees in a company

  • min_employee_count_or_null
    integernullable

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

  • min_funding_usd
    integernullable

    Minimum company funding, in USD

  • min_revenue_usd
    integernullable

    Minimum company revenue, in USD

  • min_salary_usd
    numbernullable

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

  • offset
    integer
    0 <= valuedefault: 0

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

  • only_jobs_with_hiring_managers
    booleannullable
    deprecated

    Only return jobs with a hiring manager. If True, only return jobs with a hiring manager. If False, only return jobs without a hiring manager. If None, return all jobs.

  • only_jobs_with_reports_to
    booleannullable
    deprecated

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

  • only_yc_companies
    booleannullable
    default: false

    Only return YC companies

  • order_by
    array<ColumnSortJobSearch>
    default: [{"desc":true,"field":"date_posted"},{"desc":true,"field":"discovered_at"}]
    deprecated

    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
    integer
    0 <= valuedefault: 0

    Page number. Required when using page-based pagination.

  • posted_at_gte
    stringnullable
    date

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

  • posted_at_lte
    stringnullable
    date

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

  • posted_at_max_age_days
    integernullable

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

  • property_exists_and
    array<string>
    default: []
  • property_exists_or
    array<string>
    default: []

    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
    booleannullable

    True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.

  • reports_to_exists
    booleannullable
    deprecated

    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
    booleannullable
    deprecated

    This field is deprecated and has no effect.

  • scraper_name_pattern_or
    array<string>
    default: []
    deprecated

    Regex patterns to match job sources. Case-insensitive.

  • url_domain_not
    array<string>
    default: []

    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
    array<string>
    default: []

    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.

  • [key: string]
    never
  • Response Body

    application/json

    application/json

    application/json

    application/json

    application/json

    curl -X POST "https://api.theirstack.com/v1/jobs/search" \  -H "Content-Type: application/json" \  -d '{    "job_description_pattern_or": [      "analytics"    ],    "limit": 25,    "page": 0,    "posted_at_max_age_days": 30  }'
    {
      "data": [
        {
          "avg_annual_salary_usd": 100000,
          "cities": [
            "New York",
            "San Francisco",
            "London",
            "Paris",
            "Sydney"
          ],
          "closed_at": "2024-06-15T12:30:00Z",
          "company": "Google",
          "company_domain": "acme.com",
          "company_object": {
            "alexa_ranking": 1,
            "annual_revenue_usd": 189000000,
            "annual_revenue_usd_readable": "189M",
            "apollo_id": "5b839bd0324d4445051f9a5a",
            "city": "Mountain View",
            "company_keywords": [
              "string"
            ],
            "company_tags": [],
            "country": "United States",
            "country_code": "string",
            "domain": "google.com",
            "employee_count": 7543,
            "employee_count_range": "1001-5000",
            "founded_year": 2019,
            "funding_stage": "angel",
            "has_blurred_data": false,
            "id": "google",
            "industry": "internet",
            "industry_id": 0,
            "investors": [
              "string"
            ],
            "is_recruiting_agency": true,
            "keyword_slugs": [
              "kafka",
              "elasticsearch",
              "lead-generation"
            ],
            "last_funding_round_amount_readable": "$1.2M",
            "last_funding_round_date": "2020-01-01",
            "linkedin_id": "string",
            "linkedin_url": "http://www.linkedin.com/company/google",
            "logo": "https://example.com/logo.png",
            "long_description": "Google is a California-based multinational technology company that offers internet-related services such as a search engine, online advertising and cloud computing.",
            "name": "Google",
            "num_buying_intent_topics": 0,
            "num_jobs": 746,
            "num_jobs_found": 23,
            "num_jobs_last_30_days": 34,
            "num_keywords": 0,
            "num_technologies": 746,
            "possible_domains": [],
            "postal_code": "28040",
            "publicly_traded_exchange": "NASDAQ",
            "publicly_traded_symbol": "GOOG",
            "seo_description": "string",
            "technology_names": [
              "Kafka",
              "Elasticsearch"
            ],
            "technology_slugs": [
              "kafka",
              "elasticsearch"
            ],
            "total_funding_usd": 500000,
            "url": "google.com",
            "url_source": "string",
            "yc_batch": "W21"
          },
          "continents": [
            "North America",
            "Europe",
            "Asia",
            "Australia",
            "South America"
          ],
          "countries": [
            "United States",
            "Canada",
            "Spain",
            "France",
            "Australia"
          ],
          "country": "United States",
          "country_code": "US",
          "country_codes": [
            "US",
            "CA",
            "ES",
            "FR",
            "AU"
          ],
          "date_posted": "2021-01-01",
          "date_reposted": "2024-01-01",
          "description": "## About the Role\nWe are looking for a Senior Data Engineer with 5+ years of experience in data engineering to join our growing data team. You will be responsible for designing and implementing scalable data pipelines, data models, and data warehouses that support our business intelligence and analytics initiatives.\n\n## Key Responsibilities\n- Design, build, and maintain robust, scalable data pipelines using modern data engineering tools and frameworks\n- Develop and optimize data models and schemas for data warehouses and data lakes\n- Collaborate with data scientists, analysts, and product teams to understand data requirements and deliver solutions\n- Implement data quality monitoring and validation processes to ensure data accuracy and reliability\n- Optimize query performance and data processing workflows for large-scale datasets\n- Build and maintain ETL/ELT processes using tools like Apache Airflow, dbt, or similar\n- Work with cloud data platforms (AWS, GCP, or Azure) and their native data services\n- Establish data governance practices and ensure compliance with data privacy regulations\n- Mentor junior data engineers and contribute to technical documentation\n\n## Required Qualifications\n- Bachelor's degree in Computer Science, Engineering, or related technical field\n- 5+ years of experience in data engineering or related roles\n- Strong proficiency in Python and SQL\n- Experience with big data technologies (Spark, Kafka, Hadoop ecosystem)\n- Hands-on experience with cloud data platforms (AWS Redshift, GCP BigQuery, Azure Synapse, etc.)\n- Experience with data orchestration tools (Airflow, Prefect, or similar)\n- Knowledge of data modeling concepts and best practices\n- Experience with version control systems (Git) and CI/CD pipelines\n- Strong problem-solving skills and attention to detail\n\n## Preferred Qualifications\n- Experience with real-time data processing and streaming analytics\n- Knowledge of data visualization tools (Tableau, Looker, PowerBI)\n- Experience with containerization (Docker, Kubernetes)\n- Familiarity with machine learning workflows and MLOps practices\n- Experience with data governance and cataloging tools\n\n## What We Offer\n- Competitive salary and equity package\n- Comprehensive health, dental, and vision insurance\n- Flexible work arrangements and remote-friendly culture\n- Professional development budget for conferences and training\n- State-of-the-art equipment and technology stack\n- Collaborative and inclusive work environment\n- Opportunity to work with cutting-edge data technologies",
          "discovered_at": "2024-01-01T00:00:00",
          "easy_apply": true,
          "employment_statuses": [
            "full_time"
          ],
          "final_url": "https://carecrafterhealth.com/careers/job-details/MFC286442-4",
          "has_blurred_data": false,
          "hiring_team": [
            {
              "first_name": "John Doe",
              "full_name": "John Doe",
              "image_url": "https://media.licdn.com/dms1234567890",
              "linkedin_url": "https://www.linkedin.com/in/john-doe-1234567890",
              "role": "CEO",
              "thumbnail_url": "https://media.licdn.com/dms1234567890"
            }
          ],
          "hybrid": true,
          "id": 1234,
          "job_title": "Senior Data Engineer",
          "keyword_slugs": [
            "google-firebase",
            "postgresql",
            "lead-generation"
          ],
          "latitude": 37.774929,
          "location": "New York",
          "locations": [
            {
              "admin1_code": "CA",
              "admin1_name": "California",
              "admin2_code": "101",
              "admin2_name": "Sutter",
              "continent": "NA",
              "country_code": "US",
              "country_name": "United States",
              "display_name": "Live Oak, California, United States",
              "feature_code": "PPL",
              "id": 5367315,
              "latitude": 37,
              "longitude": -122,
              "name": "Live Oak",
              "state": "California",
              "state_code": "CA",
              "type": "city"
            }
          ],
          "long_location": "Methuen, MA 01844",
          "longitude": -96.726486,
          "manager_roles": [
            "string"
          ],
          "matching_phrases": [],
          "matching_words": [],
          "max_annual_salary": 100000,
          "max_annual_salary_usd": 100000,
          "min_annual_salary": 100000,
          "min_annual_salary_usd": 100000,
          "normalized_title": "string",
          "postal_code": "01844",
          "remote": true,
          "reposted": true,
          "salary_currency": "USD",
          "salary_string": "$100,000 - $120,000",
          "seniority": "c_level",
          "short_location": "Tulsa, OK",
          "source_url": "https://www.linkedin.com/jobs/view/1234567890",
          "state_code": "OK",
          "technology_slugs": [
            "google-firebase",
            "postgresql",
            "jira"
          ],
          "url": "https://example.com/job/1234"
        }
      ],
      "metadata": {
        "total_companies": 1045,
        "total_results": 2034,
        "truncated_companies": 0,
        "truncated_results": 0
      }
    }
    {
      "error": {
        "code": "E-001",
        "description": "string",
        "title": "Not allowed exception"
      },
      "request_id": null
    }
    {
      "error": {
        "code": "E-001",
        "description": "string",
        "title": "Not allowed exception"
      },
      "request_id": null
    }
    {
      "error": {
        "code": "E-001",
        "description": "string",
        "title": "Not allowed exception"
      },
      "request_id": null
    }
    {
      "error": {
        "code": "E-001",
        "description": "string",
        "title": "Not allowed exception"
      },
      "request_id": null
    }

    How is this guide?

    Last updated on

    Avoiding getting the same job twice

    Discover how to use discovered_at_gte and job_id_not filters to avoid getting duplicate jobs in the Job Search API and save credits on every call.

    Company Search POST

    This endpoint lets you search for companies by technology stack, hiring signals, and firmographics. It returns a list of companies that match the search criteria, along with the jobs and technology objects for each company that match the filters you've passed.