--- title: Users and Teams description: Learn about users and teams in TheirStack. url: https://theirstack.com/en/docs/teams --- What is a team? [#what-is-a-team] A team is a group of users who share the same workspace. They will share the same billing plans, saved searches, company lists, and more. We don't charge for the number of users in a team. You can invite as many users as you want. Team roles and permissions [#team-roles-and-permissions] There are 2 roles in a team: * **Member**: Can do everything except what admins can do. * **Owner**: * Can add and remove team members. * Can change other members' roles. * Receives consumption alerts. Eg: when 75% of the credits are used. FAQs [#faqs] How do I add a team member? [#how-do-i-add-a-team-member] To add a team member: 1. Go to the [team page](https://app.theirstack.com/settings/team). 2. Click on the "Invite member" button. 3. Enter the email address of the person you want to add. 4. Click on the "Invite" button. Your new member will receive an email to join the team. --- title: What is TheirStack description: url: https://theirstack.com/en/docs/what-is-theirstack --- TheirStack is the largest job posting and technographics database, empowering sales teams to uncover opportunities through real-time technographic and hiring signals. We process over 316k jobs per day from 312k sources and track 32k technologies across 10M companies. We continuously gather job listings from a variety of job boards, ATSs, and company websites. Our goal isn't to assist individuals in finding jobs or companies in recruiting talent. Instead, we view job postings as a gold mine of information. When a company posts a job, it signals a need to address a problem or seize an opportunity. Job postings reveal the technologies they use, the tasks they need help with, their working methods, and organizational structure—offering the perfect timing to reach out to your lead. We transform job postings into buying intent signals, helping sales and marketing teams make informed decisions for higher ROI. * **Hiring Signals:** Discover companies that are hiring for specific positions. * **Technographic Signals:** Discover companies by the technology they use. * **Painpoint Signals:** Discover companies that have a specific pain point: digitalize invoices, automate onboarding, back up data, etc. You can consume our data through [#you-can-consume-our-data-through] } href="/en/docs/app" title="App"> Effortlessly explore, search, and analyze our data with an intuitive, user-friendly interface—no coding required. } href="/en/docs/api-reference" title="API"> Instantly integrate our data into your own applications, workflows, or dashboards with flexible, high-performance endpoints. } href="/en/docs/webhooks" title="Webhooks"> Receive real-time notifications when events occur (e.g., new job postings, tech changes, etc.) and trigger actions in your external tools like N8N, Zapier, etc. } href="/en/docs/datasets" title="Dataset"> Access the complete, raw dataset for maximum flexibility—ideal for advanced analytics, machine learning, or custom research. Learn more about our data [#learn-more-about-our-data] } href="/en/docs/data/job" title="Job data"> Get access to millions of job listings aggregated from multiple global sources, including major job boards like Indeed, LinkedIn, Workable, Greenhouse, Lever, InfoJobs, Otta, StartupJobs... offering a complete view of the job market across 195 countries. } href="/en/docs/data/technographic" title="Technographic data"> We infer technology usage from millions of jobs worldwide. Our catalog of more than 32k{' '} technologies and 10M companies is the largest in the world. Start for free [#start-for-free] * [Sign up and get 50 free company credits and 200 free API credits](https://app.theirstack.com/signup) * [Get your API key](https://app.theirstack.com/settings/api-key) --- title: Accessing your datasets description: Learn the different mechanisms to access the datasets url: https://theirstack.com/en/docs/datasets/accessing-datasets --- There are two ways to access your datasets: * **Direct download URL** — Quick access to individual dataset files * **S3 Bucket access** — Full access to explore the entire bucket and historical datasets **Looking for** information about dataset types and what's available? Learn more about our [Jobs and Technographics datasets](/en/docs/datasets). Direct download URL [#direct-download-url] Use direct download URLs when you need quick access to a specific dataset file without setting up programmatic access. This is the most common and straightforward way to access your datasets. In the [TheirStack App](https://app.theirstack.com/dataset), you can see the list of available datasets in the datasets section. There you'll find all the different datasets available for you, along with a direct download button for each one. Datasets page This is the simplest way to get a specific dataset file. Just click the download button, and you'll get a direct link to download the file. S3 bucket access [#s3-bucket-access] If you want to explore the entire bucket of datasets available and access the historical archive of published datasets, you can gain direct access to our S3 bucket. This gives you more flexibility to browse, list, and download multiple files programmatically. This process consists of three steps: 1. Get temporary credentials 2. List files 3. Download files There are many ways to access files on S3. Below we explain three common options: * **Python (boto3)** — Using the [`boto3` SDK](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html) to list and download files * **AWS CLI** — Using [`aws s3`](https://docs.aws.amazon.com/AmazonS3/latest/userguide/download-objects.html) to list and download files * **ClickHouse** — Using the [`s3` table function](https://clickhouse.com/docs/sql-reference/table-functions/s3) to list files and query its content Obtaining temporary S3 credentials [#obtaining-temporary-s3-credentials] To get access to the datasets bucket, you need to make a request to the [POST /v1/datasets/credentials](/en/docs/api-reference/datasets/post_datasets_credentials_v1) endpoint. ```bash curl -X POST "https://api.theirstack.com/v1/datasets/credentials" \ -H "accept: application/json" \ -H "Authorization: Bearer " ``` Response fields [#response-fields] This endpoint returns a JSON object with the following fields: * `access_key_id` — The access key ID for the temporary credentials * `secret_access_key` — The secret access key for the temporary credentials * `session_token` — The session token for the temporary credentials * `expiration` — The expiration date and time of the temporary credentials (in ISO 8601 format) * `storage` — Storage configuration object containing: * `bucket_name` — The S3 bucket name where the datasets are stored * `endpoint_url` — The S3-compatible endpoint URL to use for accessing the bucket * `prefixes` — One or more prefixes you must include when accessing objects Example response: ```json { "access_key_id": "a3f8b2c9d1e4f5a6b7c8d9e0f1a2b3c4", "secret_access_key": "7e9a2b4c6d8e0f1a3b5c7d9e1f3a5b7c9d1e3f5a", "session_token": "ZXlKaGJHY2lPaUpTVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5LmV5SmlkV05yWlhRa", "expiration": "2026-01-15T14:30:00Z", "storage": { "bucket_name": "datasets", "endpoint_url": "https://example-datasets-url.com", "prefixes": [ "v1_0_0/data/jobs/daily/2025/12/19/", "v1_0_0/data/jobs/daily/2025/12/20/", "v1_0_0/data/jobs/daily/2025/12/21/", ... ] } } ``` **Note:** These credentials are temporary and will expire at the time specified in the `expiration` field. You'll need to request new credentials once they expire. Use the credentials in Python [#use-the-credentials-in-python] Once you have the temporary credentials, you can connect to the S3 bucket using the AWS S3-compatible API. The response includes the `endpoint_url`, `bucket_name`, and the allowed `prefixes` in the `storage` object, which you should use when configuring your client and building object keys. Because the files are stored in Cloudflare R2, you must pass the `endpoint_url` in your client or CLI commands. Here is how to set up a client using the values from the API response: ```python import boto3 import requests # Get credentials from the API response = requests.post( "https://api.theirstack.com/v1/datasets/credentials", headers={"Authorization": "Bearer "} ) response.raise_for_status() credentials = response.json() # Use the endpoint_url and bucket_name from the response client = boto3.client( "s3", endpoint_url=credentials["storage"]["endpoint_url"], aws_access_key_id=credentials["access_key_id"], aws_secret_access_key=credentials["secret_access_key"], aws_session_token=credentials["session_token"], ) ``` Export credentials as environment variables [#export-credentials-as-environment-variables] Running these will let you use the credentials for the AWS CLI to list and download files, as explained in the next sections. ```bash eval "$(curl --location --request POST 'https://api.theirstack.com/v1/datasets/credentials' \ --header 'accept: application/json' \ --header 'Authorization: Bearer ' \ | jq -r ' "export AWS_ACCESS_KEY_ID=\(.access_key_id)", "export AWS_SECRET_ACCESS_KEY=\(.secret_access_key)", "export AWS_SESSION_TOKEN=\(.session_token)", "export S3_ENDPOINT_URL=\(.storage.endpoint_url)", "export S3_BUCKET_NAME=\(.storage.bucket_name)" ')" ``` Listing files [#listing-files] With Python [#with-python] The credentials response includes one or more allowed prefixes. Always include one of those prefixes in every S3 key you access (for example, `customer-1234/`). First, list objects for each allowed prefix, then download the keys you need: ```python for prefix in credentials["storage"]["prefixes"]: response = client.list_objects_v2( Bucket=credentials["storage"]["bucket_name"], Prefix=prefix, ) for obj in response.get('Contents', []): print(f"Key: {obj['Key']}, Size: {obj['Size']}") ``` With the AWS CLI [#with-the-aws-cli] First, export the temporary credentials as environment variables (shown above). Then run `aws s3 ls` with the same endpoint: ```bash aws s3 ls "datasets/v1_0_0/data/jobs/daily/2026/01/22/" \ --endpoint-url "$S3_ENDPOINT_URL" ``` If you don't want to save them as environment variables, you can inline them for a single command: ```bash AWS_ACCESS_KEY_ID="" \ AWS_SECRET_ACCESS_KEY="" \ AWS_SESSION_TOKEN="" \ aws s3 ls "datasets/v1_0_0/data/jobs/daily/2026/01/22/" \ --endpoint-url "https://80063c3fbf855b628e8167cf2831ce60.r2.cloudflarestorage.com" ``` With ClickHouse [#with-clickhouse] Once you have the temporary credentials, you can list the full filenames using the `s3` table function. For additional options, see the [ClickHouse `s3` table function docs](https://clickhouse.com/docs/sql-reference/table-functions/s3). Replace the values with your own credentials and session token: ```sql SELECT _path, _file, _size, _time FROM s3( 'https://80063c3fbf855b628e8167cf2831ce60.r2.cloudflarestorage.com/datasets/v1_0_0/data/jobs/daily/2026/01/22/data.parquet', '', '', '', 'One' ) ``` Downloading files [#downloading-files] After you identify the object you want to download, include one of the allowed prefixes in the `Key`: With Python [#with-python-1] ```python prefix = credentials["storage"]["prefixes"][0] # choose one allowed prefix key_to_download = f"{prefix}path/to/your/file" client.download_file( Bucket=credentials["storage"]["bucket_name"], Key=key_to_download, Filename="local_file.csv", # update to your desired local path ) ``` With the AWS CLI [#with-the-aws-cli-1] Download an object by bucket and key, and provide a local filename: ```bash aws s3api get-object \ --bucket "$S3_BUCKET_NAME" \ --key "v1_0_0/data/jobs/daily/2026/01/22/data.parquet" \ "data.parquet" \ --endpoint-url "$S3_ENDPOINT_URL" ``` You can also download files directly with the AWS CLI without listing them first. To copy every object in the bucket to your current directory: ```bash aws s3 cp "s3://$S3_BUCKET_NAME" . \ --recursive \ --endpoint-url "$S3_ENDPOINT_URL" ``` For more download patterns and examples, see the [AWS S3 download objects guide](https://docs.aws.amazon.com/AmazonS3/latest/userguide/download-objects.html). With ClickHouse [#with-clickhouse-1] You can query the data directly once you have the temporary credentials: ```sql SELECT count(*) FROM s3( 'https://80063c3fbf855b628e8167cf2831ce60.r2.cloudflarestorage.com/datasets/v1_0_0/data/jobs/daily/2026/01/22/data.parquet', '', '', '' ) ``` To inspect the schema: ```sql DESCRIBE TABLE s3( 'https://80063c3fbf855b628e8167cf2831ce60.r2.cloudflarestorage.com/datasets/v1_0_0/data/jobs/daily/2026/01/22/data.parquet', '', '', '' ) ``` To fetch a single row: ```sql SELECT * FROM s3( 'https://80063c3fbf855b628e8167cf2831ce60.r2.cloudflarestorage.com/datasets/v1_0_0/data/jobs/daily/2026/01/22/data.parquet', '', '', '' ) LIMIT 1 ``` --- title: Datasets description: Access complete jobs, technographics, and company datasets — delivered as CSV or Parquet, with historical coverage and optional daily updates via S3. url: https://theirstack.com/en/docs/datasets --- Datasets page What are datasets? [#what-are-datasets] Datasets give you direct access to our complete database of jobs, technology usage, and company information. Think of them as your raw data goldmine – perfect when you need maximum flexibility for advanced analytics, machine learning projects, or custom analysis. We've got two powerful datasets ready for you: * **[Jobs Dataset](/en/jobs-dataset)**: Access our complete collection of 166M job postings from 195 countries, dating back to 2021. Each job record includes essential details like job title, description, salary, location, company name, company URL, company industry, company size... Check out the complete [data dictionary](https://app.theirstack.com/dataset) for all available fields. * **[Technographics Dataset](/en/technographics-api)**: Dive into 47M technology usage signals across 10M companies using 32k different technologies. This isn't just one file – you'll get three comprehensive datasets: the main technographics data (company\_id, technology\_slug, confidence\_score, n\_jobs...), detailed company profiles (including domain, country, revenue, and employee count), and a complete technology catalog with descriptions and categories. Check out the complete [data dictionary](https://app.theirstack.com/dataset) for all available fields. Frequency of updates [#frequency-of-updates] TheirStack offers three flexible dataset access options to meet your data needs: * **Historical Access**: Receive a one-time download link containing all available records at the time of purchase. * **Daily Updates**: Get daily download links with new records added to the dataset, including delta files for incremental updates. * **Complete Access**: Combine both historical and daily updates for comprehensive data coverage. Delivery format [#delivery-format] All datasets are delivered with a link to a S3 bucket. The format of the dataset can be CSV or Parquet. Data structure [#data-structure] * [Jobs dictionary](/en/docs/datasets/options/job) * [Companies dictionary](/en/docs/datasets/options/company) * [Technographics dictionary](/en/docs/datasets/options/technographic) * [Technologies dictionary](/en/docs/datasets/options/technographic) How to get lastest dataset link [#how-to-get-lastest-dataset-link] In order to get the latest dataset link to download, you need to do a /GET request to the [dataset endpoint](/en/docs/api-reference/datasets/get_datasets_v1). Frequently Asked Questions [#frequently-asked-questions] The dataset is refreshed daily with new records added to the dataset. Delta files are available for each day. The dataset has the same quality as the data in the [app](https://app.theirstack.com) or the API. All the data delivery options comes from the same database. So you can use our app.theirstack.com or the API to validate the data. Datasets are the right choice if you need to get data for more than 10M records / month. If you need less, the API is the best option. --- title: How to set up a webhook description: Learn how to set up a webhook to get notified when events occur (new jobs, tech changes, etc) in TheirStack and trigger actions in your external systems like N8N, Zapier, Make, Airtable, etc url: https://theirstack.com/en/docs/webhooks/how-to-set-up-a-webhook --- Setting up webhooks manually [#setting-up-webhooks-manually] Follow these steps to set up a [webhook](/en/docs/webhooks): **Open a new job or company search with the criteria you are interested in.**
**Click on the "Save" button to save the search.** The search has to be saved to be used in the webhook. **Click on the "Webhooks" button on the top right corner.** Saved search **Click on the "Create Webhook" button.** **Fill the form** New webhook modal * **Saved search**: This search's filters determine which records will trigger the webhook. * **Trigger once per company**: When enabled, the webhook will fire only once for each company. This is helpful for sales workflows where you want to act on the first job posted (e.g., send an email, add to a CRM) without triggering the workflow for every subsequent job from the same company. Eg: If active, Company A with 5 jobs → 1 event triggered. If deactivated, Company A with 5 jobs → 5 events triggered. * **Choose where to start**: Choose which events to include based on when they occurred. * **From now on**: Only events that occur after you create the webhook will trigger notifications. * **All time**: You'll get both historical events (that already occurred and match your search) plus all future events. * **Webhook URL**: The URL of the webhook endpoint you want to send the data to. You can click on "Send test event" to send a sample of the data to your webhook URL and verify that it is working. **Wait for new events to be triggered** Webhook details page * If you choose to start from the start of the search, you will receive all events that have occurred since the search was created in a few seconds. If you choose to start from the current date, you will receive events in real time. * You can click on the button "Send test event" to send a sample of the data to your webhook URL and verify that it is working. Setting up webhooks programmatically [#setting-up-webhooks-programmatically] You can manage programmatically your webhooks by using the [Webhooks API](/en/docs/api-reference/webhooks/get_webhooks_v0). This is specially useful if you want to integrate webhooks with your own application. FAQs [#faqs] No, you won't receive duplicate notifications. Our webhooks intelligently track what they've already sent you, so you only get fresh, new results. Each job or company is only notified about once, even if it matches your search criteria multiple times. Webhooks trigger in real-time as soon as new results match your search criteria. There's no delay or batching - you'll get notified immediately when relevant events occur. --- title: Webhooks description: Learn how to use webhooks to get notified when events occur (new jobs, tech changes, etc) in TheirStack and trigger actions in your external systems like N8N, Zapier, Make, Airtable, etc url: https://theirstack.com/en/docs/webhooks --- Webhooks details page What are webhooks? [#what-are-webhooks] Webhooks allow you to send data when specific events occur (new jobs, tech changes, etc) to external systems like N8N, Zapier, Make, Airtable, your own webhook endpoint, etc. For instance, you can configure a webhook to alert you when a new job is listed in a particular location, company, or technology sector. Webhooks are dependent on a search, which defines the criteria for triggering the webhook. Any type of searches (job, company, technology, etc) can be used to trigger a webhook. Webhooks Applications [#webhooks-applications] * Initiate a workflow in an automation tool like Zapier, Make, N8N when a new job is posted or a company adopts a new technology (e.g., Snowflake, Hubspot, Python). * Send a Slack notification to your team when a new job is found or a company adopts a new technology (e.g., Snowflake, Hubspot, Python). * Automatically update a Google Sheet with new job or company data. * Trigger an email alert to a specific distribution list when a new job matches certain criteria. * Create a table in Airtable to store job listings. * Integrate with a CRM system to add new company information as leads. Webhook types [#webhook-types] There are three types of webhooks: * **`job.new`**: Fires whenever we discover a new job posting that matches your search criteria. [Data Schema](/en/docs/webhooks/event-type/job_newjob_new_post). * **`company.new`**: Fires whenever we discover a new company that matches your search criteria. [Data Schema](/en/docs/webhooks/event-type/company_newcompany_new_post). * **`tech.new`**: Triggered when company adopts a new technology (request access to this) Pricing [#pricing] Webhooks and API requests share the same pricing. When an event is triggered, it consumes 1 (`job.new`) or 3 (`company.new`, `tech.new`) API credits based on the type of event. Learn more about our credit system [here](/en/docs/pricing/credits). FAQs [#faqs] When you run out of API credits, webhook event monitoring is temporarily paused. During this period, no new events will appear in your webhook history. Monitoring automatically resumes once you purchase additional API credits. Whether you miss events during the pause depends on your search criteria. For example, if your webhook tracks jobs posted within the last 60 days and you lack credits for 2 days, you won't miss anything - when credits are restored, all jobs discovered during the pause will still trigger your webhook as they match your search parameters. If the webhook event fails, it will be automatically retried every hour for 48 hours. Webhook events are billed at the same rate as API requests. They consume 1 API credit per event. --- title: Monitor your webhooks description: Track your webhook performance with detailed analytics. Learn how to view webhook usage statistics, understand event statuses, and troubleshoot webhook delivery issues using TheirStack's built-in monitoring dashboard. url: https://theirstack.com/en/docs/webhooks/monitor-your-webhooks --- You can monitor all your webhooks usage in the [Usage page](https://app.theirstack.com/usage). In the "Webhooks events" section you can see the total number of events triggered by your webhooks. You can see the breakdown of the webhook events by event status or webhook. * **Event Status**: success, in progress, failed, not\_triggered. Learn more about the [webhook events statuses](#webhook-events-statuses). * **Webhook**: name of the webhook that triggered the event. Webhook usage Webhook events statuses [#webhook-events-statuses] Webhook events have the following statuses: * **`success`**: The webhook event was processed successfully. The endpoint returned a 200 status code. * **`in progress`**: The webhook event is being processed, it could take a few minutes to be processed. * **`failed`**: The webhook event failed to be processed. The endpoint returned a non-200 status code. Don't worry, it will be retried every hour for 48 hours. * **`not_triggered`**: The webhook event was detected but not triggered because you run out of API credits. How to manually resend a failed webhook event? [#how-to-manually-resend-a-failed-webhook-event] You can manually resend a failed webhook event by clicking on the "Resend" button in the webhook details page. Resend webhook event FAQs [#faqs] When you run out of API credits, webhook event monitoring is temporarily paused. During this period, no new events will appear in your webhook history. Monitoring automatically resumes once you purchase additional API credits. Whether you miss events during the pause depends on your search criteria. For example, if your webhook tracks jobs posted within the last 60 days and you lack credits for 2 days, you won't miss anything - when credits are restored, all jobs discovered during the pause will still trigger your webhook as they match your search parameters. If the webhook event fails, it will be automatically retried every hour for 48 hours. --- title: Receive TheirStack events in your webhook endpoint description: Learn the essential technical requirements for building webhook endpoints that receive TheirStack job and company data. Covers status codes, retry logic, concurrency handling, and duplicate prevention. url: https://theirstack.com/en/docs/webhooks/receive-theirstack-events-in-your-webhook-endpoint --- If you are builing your own webhook endpoint, please take into account the following: * Return a 2xx status code to indicate that the webhook event was received and processed successfully. Failed webhook events are retried every hour for 48 hours. * Your webhook endpoint has to be prepared to handle at least 2 concurrent requests. * Your webhook endpoint has to be prepared to handle duplicates. Our system is designed to not send the same job twice to your webhook URL. However, this could happen in some edge cases (e.g: you listen to two searches with not exclusive jobs). You can use the `id` field to deduplicate jobs. * When a webhook sends data, it uses an HTTP POST request, with a JSON payload. Each webhook event contains only one record (job or company). * No need to learn new data formats - webhook events use the same schemas as our API responses ([Job schema](/en/docs/api-reference/jobs/search_jobs_v1) | [Company schema](/en/docs/api-reference/companies/search_companies_v1)). --- title: Authentication description: Learn how to authenticate API requests using your API key from account settings with the Bearer token in the Authorization header url: https://theirstack.com/en/docs/api-reference/authentication --- Authentication is done via the API key which you can find in [your account settings](https://app.theirstack.com/settings/api). When making a call, you'll have to specify this API key with the Authorization header. Here's an example: ```sh Authorization: Bearer ``` --- title: Introduction description: Access to the largest database of jobs and technographics. url: https://theirstack.com/en/docs/api-reference --- Welcome to the TheirStack API - the largest database of jobs and technographics. You can download the OpenAPI specification as a [JSON file](https://api.theirstack.com/openapi.json) or [YAML file](https://api.theirstack.com/openapi.yaml). Overview [#overview] } href="/en/docs/api-reference/jobs/search_jobs_v1" title="Job Search"> Search and filter real-time and historical job postings from more than 100 countries with flexible query parameters. } href="/en/docs/api-reference/companies/search_companies_v1" title="Company Search"> Find companies by the technology they use or by the roles they are hiring for. } href="/en/docs/api-reference/companies/technographics_v1" title="Technographics"> Get the list of technologies used by any company in our database. --- title: Pagination description: Learn how to paginate API responses using page-based or offset-based methods for both GET and POST requests url: https://theirstack.com/en/docs/api-reference/pagination --- Responses that return a list of items are paginated. We offer two different pagination strategies: * **Page-based**: This method allows you to navigate through paginated data by specifying the `page` and `limit` parameters. The `page` parameter indicates the page number you wish to retrieve, while the `limit` parameter specifies the maximum number of items to return per page. For POST requests, include these parameters in the request body. For GET requests, use them as query parameters. * **Offset-based**: This method allows you to navigate through paginated data by specifying the `offset` and `limit` parameters. The `offset` parameter indicates the starting point within the collection of results, while the `limit` parameter specifies the maximum number of items to return. For POST requests, include these parameters in the request body. For GET requests, use them as query parameters. Some of these endpoints also support the `include_total_results` body or query parameter. If you set it to `false`, the responses will be faster, and the field `total_results` of the response will be `null`. --- title: Quickstart description: Learn how to build a job or company search in the app, then copy the exact cURL to run the same query with the Job Search API in minutes. url: https://theirstack.com/en/docs/api-reference/quickstart --- The easiest way to get started with our API is to build a search in our [app](https://app.theirstack.com/search/jobs/new). You can explore filters, preview results, and copy the exact cURL you’ll need to run the same search via the API. Create a new [job](https://app.theirstack.com/search/jobs/new) or [company](https://app.theirstack.com/search/companies/new) search. Use our 30+ filters to narrow down your search and preview the result. In the top-right corner of the results, click **API**. This opens a modal where you can copy the cURL needed to replicate the same search with the API. API button on job search page From this modal, you can: * Copy the cURL to your clipboard and paste it into your terminal (or an HTTP client like Postman). * Copy a Make.com HTTP module and paste it directly into a scenario (see the [Make.com integration documentation](/en/docs/integrations/make)). * Copy an n8n module and paste it into an n8n workflow. API modal --- title: Rate Limit description: Learn how API rate limits work with tiered endpoints, sliding windows, IETF-compliant RateLimit headers, and HTTP 429 responses url: https://theirstack.com/en/docs/api-reference/rate-limit --- All API endpoints are rate limited to ensure reliability and fair usage. When a limit is exceeded, the API returns **HTTP 429 Too Many Requests**. Limits are applied **per user** (or per API key) with sliding windows; multiple windows may apply simultaneously. Tiered endpoints and limits [#tiered-endpoints-and-limits] Endpoints covered by tier-based limits: * POST `/v1/jobs/search` (Jobs Search) * POST `/v1/companies/search` (Companies Search) * POST `/v1/companies/technologies` (Technographics) Shared limits across all three endpoints: | Tier | API limits | | ---- | ------------------------------------- | | Free | 4/second, 10/minute, 50/hour, 400/day | | Paid | 4/second | * **Paid tier** applies to users who have made at least one payment. * **Free tier** applies to all other users (users who have never paid or users without any payments done). Multiple limits are applied simultaneously. A request is rejected if it exceeds **any** active window. Rate limit headers [#rate-limit-headers] The API returns rate limit information in every response. We follow the **IETF HTTPAPI draft** for RateLimit headers: [RateLimit header fields for HTTP](https://datatracker.ietf.org/doc/draft-ietf-httpapi-ratelimit-headers/). When multiple rate limits apply, header items are comma-separated and ordered consistently across headers. IETF compliant headers [#ietf-compliant-headers] * `RateLimit`: Current quota status per policy. Format: `""; r=; t=; pk=`. * `RateLimit-Policy`: Applied policy definition. Format: `""; q=; w=`. Other headers [#other-headers] These are included for client convenience: * `RateLimit-Limit`: Total allowed requests for each window * `RateLimit-Remaining`: Requests remaining in each window * `RateLimit-Reset`: Seconds until the current window resets The order of values in legacy headers **matches the order of `RateLimit` items**. Example response headers: ``` RateLimit: "per-second";r=3;t=1;pk="dXNlcjoxMjM0", "per-minute";r=9;t=60;pk="dXNlcjoxMjM0", "per-hour";r=49;t=3600;pk="dXNlcjoxMjM0", "per-day";r=399;t=86400;pk="dXNlcjoxMjM0" RateLimit-Policy: "per-second";q=4;w=1, "per-minute";q=10;w=60, "per-hour";q=50;w=3600, "per-day";q=400;w=86400 RateLimit-Limit: 4, 10, 50, 400 RateLimit-Remaining: 3, 9, 49, 399 RateLimit-Reset: 1, 60, 3600, 86400 ``` Exceeding limits and best practices [#exceeding-limits-and-best-practices] * Retry with **exponential backoff** on HTTP 429 responses. * Monitor `RateLimit` or `RateLimit-Remaining` and `RateLimit-Reset` to avoid hitting limits. * Prefer batching and caching to reduce request counts. * Avoid concurrent bursts that violate per-second limits. --- title: Affiliate Program description: Earn 30% commission for every new customer you refer successfully. Discover the commission structure, how payouts work, and how to get started. url: https://theirstack.com/en/docs/affiliate-program --- What is the TheirStack Affiliate Program? [#what-is-the-theirstack-affiliate-program] Rewarding our partners and brand ambassadors for bringing in new customers is a core part of our growth strategy. Our Affiliate Program lets you earn money by referring people to TheirStack who become paying customers. You'll earn 30% commission for every successful referral you send our way. How does it work? [#how-does-it-work] * **30% commission** on all subscriptions and one-time purchases from your referrals during their first 12 months * **Flexible payouts** - Request your earnings anytime with a minimum payout of $10 * **Payment timing** - You'll receive commission when your referrals are charged (monthly for monthly plans, yearly for yearly plans). Each referred purchase has a 60-day hold to prevent fraud and account for refunds or disputes. After the 60-day hold, that purchase is confirmed, counts toward your reward, and becomes available for payout. This hold applies per purchase; previously confirmed purchases are unaffected. * **Payment methods** - Choose between bank transfer (via Wise) or PayPal How affiliate links and attribution work? [#how-affiliate-links-and-attribution-work] * **120-day attribution window (last-click)**: When someone clicks your unique affiliate link, we set a cookie. If they sign up within 120 days of that click, they're credited to you. * **You can see who signed up**: Once they create an account, their email appears in your Affiliate Portal so you can track conversions. * **First purchase can happen later**: If the person signs up within the 120-day window but only buys later (even years later), you’ll still receive commission when they start paying. * **Commission period**: You earn **30%** on all subscriptions and one‑time purchases from that customer during their first 12 months as a paying customer (the 12 months start from their first purchase date). How to get my affiliate link? [#how-to-get-my-affiliate-link] Everything happens in the [Affiliate Portal](https://affiliate.theirstack.com). There you can: * Copy your unique affiliate link and share it anywhere * Track signups and conversions credited to you * Choose your payout method (Wise or PayPal), request payouts and view payout history Affiliate Portal FAQs [#faqs] You can enroll in the program by signing up at [affiliate.theirstack.com](https://affiliate.theirstack.com). You can find your affiliate link in the [affiliate dashboard](https://affiliate.theirstack.com). Yes, it's free to join the program. While our best affiliates tend to be customers who love our software, you don't need to be a TheirStack customer to become an approved affiliate. The program offers last-click attribution and 120 days of cookie life. If someone clicks your affiliate link and signs up within the specified time frame (120 days), you should receive credit for the referral’s first purchase, even if they don't buy immediately. When a customer signs up and purchases a subscription, the commission is not immediately credited to your account. Instead, it's held in review for 60 days. This hold ensures that the purchase is confirmed and counts toward your reward. After the 60-day hold, the purchase is confirmed, counts toward your reward, and becomes available for payout. This is a security measure to prevent fraud and ensure that the purchase is valid. Reward in review --- title: Company lookup description: Easily search for any company name or website on TheirStack. View their technologies and job listings with a simple click. url: https://theirstack.com/en/docs/app/company-lookup --- There is a search box in the header of TheirStack where you can look for any company or its domain. When you click on one of them, a modal will open on the right side of your screen. Let's take Deutsche Bank for example: For every company, you'll see that there are 3 tabs: * **Overview** to see firmographic data about the company: industry, size, location, etc. * **Technologies** where you can see the technologies that the company uses * **Jobs** where you can see the jobs from this company Technology tab [#technology-tab] When you click on Technology Category, you can type one to see only technologies from that category. For example, in the case of the Big Data as a Service category, we see that this company has mentioned BigQuery 35 times, and 75% of the mentions in this category are of BigQuery, whereas Snowflake was only mentioned 5 times: Technology tab This is why the confidence assigned to this company using Snowflake was low, while the confidence to them using BigQuery was high. 💡 Useful resource: [How we source tech stack data](/en/docs/data/technographic/how-we-source-tech-stack-data) --- title: Find companies by technology stack description: How to generate a report of companies using a technology or group of technologies. url: https://theirstack.com/en/docs/app/company-search --- Finding companies ready to buy your product is one of the biggest challenges sales teams face. Often your Ideal Customer Profile (ICP) is strongly linked to a technology or group of technologies. TheirStack is a sales tool designed to discover purchase intent signals through job postings. It helps SaaS companies, recruiting agencies and consulting firms to find their next customer by analyzing 40+ million job listings across 100+ countries. Get a list of companies by the technology they use [#get-a-list-of-companies-by-the-technology-they-use] Step 1. Open a new company search [#step-1-open-a-new-company-search] Go to your app and click on "Search Companies" Open company search Step 2. Filter companies by technology [#step-2-filter-companies-by-technology] On the Company Technology filter, start typing a technology and select one or more. Company technology filter add more filters like Company Country, Industry, Company Employees... More filters Here is what each one of the columns shows: * **Category**: each technology belongs to a category. One category groups more than one technology, typically related to the same field. * **Jobs**: the number of jobs where each company has mentioned each technology * **Ocurrence within category**: shows how common one technology is compared to other technologies in the same category, for each company * **Theirstack Score**: a metric that combines jobs and relative occurrance within category. The idea is that the more jobs a company has mentioning a technology, and the more one technology is mentioned VS similar ones in the same category, the more likely is that the company uses this technology. * **Rank within category**: if a company mentions 3 technologies of a category in their jobs, the most frequent one will have rank 1, and the least frequent one in their jobs rank 3 Besides these, there are other columns whose names are self-explanatory: Company size, Company Industry, Company Country and more Step 3. Seeing the sources of our data [#step-3-seeing-the-sources-of-our-data] By clicking on the number of jobs found mentioning that technology, you will be able to check the job postings were this technology was mentioned Technology usage card 💡 Useful resource: [How we source our technographic data](/en/docs/data/technographic/how-we-source-tech-stack-data) 💡 Useful resource: [How to get people from this companies](/en/docs/app/contact-data/find-people) Step 4. Columns visibility [#step-4-columns-visibility] Want to customize what you see in your table? You can easily add or remove columns. Just look for the "Columns" button in the table header on the right side and click it. When you filter by technology, we'll automatically add a column for each technology you're filtering by. But you're not limited to just those! You can add technology columns even without filtering by them. This is perfect when you want to enrich your company data with technographic insights. Hide column Step 5. Export data [#step-5-export-data] You can export companies to a CSV, Excel file or to any external system through webhooks. Follow the steps below to export companies: **Click on the "Export" button in the top right corner of your screen.** Export button **Select the number of companies you want to export and the format** **Number of companies**: * You can export only the current page, only companies from revealed companies, all companies or a custom number of companies. * Each option will have on their right the cost of the operation in company credits. Example: **Format**: * You can export to a CSV, Excel file or to any external system through webhooks. Export Modal Next steps [#next-steps] * You can click on the "Export" button to export the data to a CSV or Excel file. * You can use the [Find people](/en/docs/app/contact-data/find-people) feature to find people working at the companies you're interested in. * You can use [webhooks](/en/docs/webhooks) to move the data to other systems: Airtable, Google Sheets, Hubspot, etc. Faqs [#faqs] Here's how to check the exact cost for your export: 1. Open a [new search](https://app.theirstack.com/search/companies/new) and apply your desired filters 2. Click the "Export" button in the top right corner 3. Choose how many companies you want to export and your preferred format 4. You'll see the cost displayed next to each option with a credits icon like this: 5. Go to the [pricing page](https://www.theirstack.com/en/pricing) and select the plan in the APP tab (Company credits) that covers the number of credits you need. There is two ways to avoid revealing again a company you revealed in the past: **Method 1: Using Company Lists (Recommended)** 1. Go to your ["Company seen" list](https://app.theirstack.com/company-list) where we automatically store companies you've revealed 2. Duplicate this list and rename the copy to "Company seen until \[current date]" (e.g., "Company seen until 15/01/25") 3. When setting up your new company search, apply your desired filters as usual 4. In the filters section, add a condition: "Company List" is not in "Company seen until \[current date]" 5. This will exclude all previously revealed companies from your new search results **Method 2: Using Company Domain Filter** If you have an Excel / CSV file with your previous exports: 1. Open your previous export file and copy all the company domains from the domain column 2. When setting up your new company search, apply your desired filters as usual 3. In the filters section, add a condition: "Company Domain" is not in \[paste your list of domains] 4. This will exclude all companies with those specific domains from your new search results --- title: Technographic enrichment description: Complete guide to company technographic enrichment on TheirStack. From manual bulk uploads to automated API integration for CRM and sales workflows. url: https://theirstack.com/en/docs/app/enrichment --- Got a list of companies you'd like to enrich with technographic data? You can handle this both manually and programmatically. If technology usage is a key factor in defining your Ideal Customer Profile, our enrichment feature helps you add technographic data to your company lists and build effective lead scoring models. Enrich company list manually [#enrich-company-list-manually] **Go to the [Home](https://app.theirstack.com) page in the TheirStack app and click on the "Enrich company list" button.** Enrich company list button **Fill the form with the companies and technologies you want to enrich** * **Select companies**: You can paste website URLs, company names, or both. We'll match companies that have the same name or domain * **Select technologies**: Choose multiple technologies to filter your enrichment results Enrich company list button **Explore the results** After clicking the "Enrich" button, you'll see your enrichment results displayed in a table. Each selected technology appears as a new column showing the confidence level of our detection signal (low, medium, or high), or "Not used" when we have no data for that technology. Enrich company list results Enrich company list programmatically [#enrich-company-list-programmatically] You can use our [Technographics API](/en/docs/api-reference/companies/technographics_v1) to enrich companies programmatically for new signups or to run automatic CRM updates. --- title: App description: Effortlessly explore, search, and analyze our data with an intuitive, user-friendly interface—no coding required. url: https://theirstack.com/en/docs/app --- App What is TheirStack app? [#what-is-theirstack-app] TheirStack App offer easy access to all features, including exporting company lists based on technology usage, searching for jobs across multiple job boards simultaneously, performing detailed company lookups, and more. Main features [#main-features] Search for jobs across multiple job boards simultaneously. Search for companies by name, technology usage, location, etc. Perform detailed company lookups. --- title: Full-Stack Engineer description: A Coruña | 35-70k€/year url: https://theirstack.com/en/docs/careers/full-stack-engineer-2025-09-03 --- Why now? [#why-now] As of speaking, our yearly revenue is 4x what it was by the same time one year ago. To keep up with the growth, in the last few months we have been investing heavily in improving the product and make it fast and resilient. To name a few, now all our [job](/en/product-updates/2025-02-24-job-search-performance) and [company](/en/product-updates/2025-05-07-slow-company-searches-are-now-2-6x-faster) searches run on ClickHouse and are up to 10x faster than before. API credits to get jobs are [3x cheaper](/en/blog/jobs-are-now-up-to-3x-cheaper). We added an affiliate program that gives users a [30% commission](/en/blog/new-affiliate-program). We added [lots](/en/product-updates/2025-06-06-job-description-contains-any) [of](/en/product-updates/2025-07-18-property-exists-filters) [new](/en/product-updates/2025-05-27-url-domain-filters) [filters](/en/product-updates/2025-08-11-employment-statuses) to our API and UI. Jobs now include [structured locations](/en/product-updates/2025-08-08-locations-property), searchable in a [catalog](/en/product-updates/2025-09-05-new-location-catalog), and jobs are also [filterable](/en/product-updates/2025-09-04-add-new-filter-for-locations) by them. Now, it's time to invest again in growth and marketing. What will you do? [#what-will-you-do] We know lots of things that could help us grow more - we just don't have the hands and time to do them yet. Your work here will be critical and you'll have a massive impact helping us build them. These are examples of things you'll help us do: * Create new pages in our landing page, which will **expose more parts of our datasets programatically**. These pages will match searches that potential customers are doing on search engines and LLMs, and will bring us more users. * Build **AI agents** that understand the needs of every person that signs up, checks their usage of our product, and reaches out to them with tips on how to get the most value out of TheirStack. * Let users have **multiple workspaces**, with different API keys in each workspace. Now a user can join other workspaces, but a user can only be in one workspace at a time, and the API key is linked to a user, rather than a workspace. * Build new features in our [product](https://app.theirstack.com), such as **new filters**, improving the **UI/UX**, create an **onboarding flow** so that users from each segment arrive to the "aha moment" faster, tec. * Build infrastructure that lets us **analyze massive amounts of data** from new sources such as Common Crawl to detect more technologies, intents and pains companies have and that our users could leverage. * Identify ways to **add new keywords and technologies to our catalog automatically based on our data**, without having to do it manually. * Build **tools to monitor how our biggest customers are using our API**, detect if their usage is going up or down, and send us alerts if the risk of churn is increasing. * Add **natural language filters to our API with function calling + build evals for it**, so that our users can use English to query our jobs and companies datasets. You will be a good fit if you... [#you-will-be-a-good-fit-if-you] * Have a strong product mindset. You know what makes a good product, understand that good is better than perfect, and can put yourself in users' shoes. You can build things end-to-end by yourself. * Have built and maintained production-ready systems in the past. * Are curious and love learning new things. You're not afraid to wear many hats. * Are familiar with testing and value code quality and maintainability. * Are a team player who enjoys teaching what you know and helping others grow. * Don't need to be managed and can think about the right tradeoffs to find technical solutions that fit the business context. * Can read and write in English (you don't need to be fluent). Most of our customers are international. Bonus points if... [#bonus-points-if] * You've worked with big amounts of data. You have an intuition on what works and what doesn't, and you've optimized queries before (without dreading it). * You have some basic knowledge on SEO. Don't worry if you don't—you'll learn a lot here. * You're familiar with our tech stack: FastAPI for the API, React for the web app, Next.js for our landing page, PostgreSQL for user data, ClickHouse for heavy searches, Redis for caching. We deploy the frontend on Vercel and the backend on Render. The team [#the-team] Compensation [#compensation] 35-70k€/year + profit sharing How to apply [#how-to-apply] Even if you don’t tick all boxes but still think this is an interesting position, are excited about the challenges we have and think you can help us make the pie larger, apply. The best is yet to come. Let's talk! [Apply through this link](https://tally.so/r/mZMk2e) --- title: Careers at TheirStack description: TheirStack is a small team of engineers building the future of job and technographic data. url: https://theirstack.com/en/docs/careers --- Our product [#our-product] [TheirStack](https://theirstack.com) is a job and technographic database that helps companies find clients. We scrape jobs and company information from the internet in almost real-time and let our users consume it in a structured, straightforward way. We scrape about 316k jobs every day, making \~1M requests/day, have hundreds of paying customers and tens of thousands of monthly active users. Our philosophy [#our-philosophy] * We haven’t raised any money and don’t have plans to do so. * Our goal is to keep building a sustainable, profitable company. Small in headcount and big in revenue per employee. * Success for us means living a good life solving intellectually stimulating problems and building a good product that ‘sells itself’. * We’re a company founded and driven by engineers, focused on creating exceptional solutions. Our focus is on building a product that speaks for itself, without relying heavily on traditional sales efforts. Every decision we make is guided by the question: 'Can this be discovered, used, and purchased autonomously by our users?’ * We prefer simple rather than complex solutions. * We try to understand the technologies we use as much as we can. Finding the efficient solution is better long-term than just throwing money/machines at problems, and this is only possible if we know how things work underneath. * We’ll never invest 1$ to get $1.10. Finding and focusing on what has the highest ROI has been and will keep being essential to being a small team. * We’re fine with working remotely for months, but most of the year we work in the same office and for our stage this is very important, and we’d rather find someone that can be in the office with everyday. We have nice ocean views :) Our customers [#our-customers] Our data is leveraged by customers from different verticals, such as: * B2B SaaS companies like [Superflex.ai](https://superflex.ai/) (a tool that generates code from Figma files), pull with our [UI](https://app.theirstack.com) lists of companies utilizing a technology ([Figma](https://theirstack.com/en/technology/figma) in their case) to drive their cold email outreach. * Job boards like [EnergyHire](https://app.energyhire.com/job-board) - the largest energy-sector recruiting agency - use our [Jobs API](https://theirstack.com/en/job-posting-api) to backfill their job board with all jobs publish on Linkedin, Indeed, Workable… * Salestech companies like [Clay.com](https://clay.com/) let their users use our [Technographics API](https://theirstack.com/en/technographics-api) and [Jobs API](https://theirstack.com/en/job-posting-api) to provide jobs and technology usage data so that their users can enrich their existing lists of companies and trigger outbound and marketing campaigns. * Security companies use our full datasets of [166M jobs](https://theirstack.com/en/jobs-dataset) and the full tech stack of [10M companies](https://theirstack.com/en/technographics-dataset) to identify third party risks Our team [#our-team] Xoel started [NoiceJobs](https://noicejobs.com) in early 2020. It was a bunch of job boards for which he had to build a lot of job boards and a way to store those jobs. TheirStack was born as a pivot from that in late 2021 to explore several hypotheses: * jobs signal companies’ intents, problems and needs, and can be used as sales triggers * jobs can also be used to infer the tech stack of companies In 2023, Christian joined the team to amplify marketing and sales efforts, but thanks to his technical background he made lots of improvements in the backend, as well as all the work on the frontend both for our landing page and product. And in 2024, we grew a lot, with double-digit growth in users and revenue every month.
Monthly active users in Q3 and Q4 2024
Our MAUs have doubled since this. Our open positions [#our-open-positions] --- title: Senior Data Engineer description: A Coruña | 40-80k€/year url: https://theirstack.com/en/docs/careers/senior-data-engineer-2025-09-03 --- What is TheirStack? [#what-is-theirstack] [TheirStack](https://theirstack.com) is a job and technographic database that helps companies find clients. We scrape jobs and company information from the internet in almost real-time and let our users consume it in a structured, straight-forward way. We scrape about 400k jobs every day, receive \~1M requests/day, have hundreds of paying customers and thousands of monthly active users. Our data is leveraged by customers from different verticals, such as: * B2B SaaS companies like [Superflex.ai](https://superflex.ai/) (a tool that generates code from Figma files), pull with our [UI](https://app.theirstack.com) lists of companies utilizing a technology ([Figma](https://theirstack.com/en/technology/figma) in their case) to drive their cold email outreach. * Job boards like [EnergyHire](https://app.energyhire.com/job-board) - the largest energy-sector recruiting agency - use our [Jobs API](https://theirstack.com/en/job-posting-api) to backfill their job board with all jobs publish on Linkedin, Indeed, Glassdoor, Workable… * Salestech companies like [Databar.ai](https://databar.ai/) use our [Technographics API](https://theirstack.com/en/technographics-api) and [Jobs API](https://theirstack.com/en/job-posting-api) to provide jobs and technology usage data so that their users can power their outbound campaings with it * Security companies use our full datasets of [70M jobs](https://theirstack.com/en/jobs-dataset) and the full tech stack of [5M companies](https://theirstack.com/en/technographics-dataset) to identify third party risks Our company - philosophy [#our-company---philosophy] We haven’t raised any money and don’t have plans to do so. Our goal is to keep building a sustainable, profitable company. Small in headcount and big in revenue per employee. Success for us means living a good life solving intellectually stimulating problems and building a good product that ‘sells itself’. We’re a company founded and driven by engineers, focused on creating exceptional solutions. Our focus is on building a product that speaks for itself, without relying heavily on traditional sales efforts. Every decision we make is guided by the question: 'Can this be discovered, used, and purchased autonomously by our users?’ We prefer simple rather than complex solutions. We try to understand the technologies we use as much as we can. Finding the efficient solution is better long-term than just throwing money/machines at problems, and this is only possible if we know how things work underneath. We’ll never invest 1$ to get $1.10. Finding and focusing on what has the highest ROI has been and will keep being essential to being a small team. We’re fine with working remotely for months, but most of the year we work in the same office and for our stage this is very important, and we’d rather find someone that can be in the office with everyday. We have nice ocean views :) How we got here - our story [#how-we-got-here---our-story] Xoel started [NoiceJobs](https://noicejobs.com) in early 2020. It was a bunch of job boards for which he had to build a lot of job boards and a way to store those jobs. TheirStack was born as a pivot from that in late 2021 to explore several hypotheses: * jobs signal companies’ intents, problems and needs, and can be used as sales triggers * jobs can also be used to infer the tech stack of companies In 2023, Christian joined the team to amplify marketing and sales efforts, but thanks to his technical background he made lots of improvements in the backend, as well as all the work on the frontend both for our landing page and product. And in 2024, we grew a lot, with double-digit growth in users and revenue every month. What will you do? [#what-will-you-do] We are looking for someone with experience in Data Engineering. You’d help us solve some hard problems involving entity resolution and data deduplication that need to solve, and similar problems that will arise in the future. You don’t need to check every box below or use all the technologies we use, but what matters more is that you are excited to learn, adapt, and grow alongside our evolving company needs. Your skills [#your-skills] * **Entity Resolution** Fuzzy/probabilistic matching of companies via domains, LinkedIn IDs, logos, names, and other signals. * **Job Deduplication** Time-aware and content-aware deduplication using job similarity, reposting patterns, and ML. * **ClickHouse Expertise** Schema design, projections, partitioning, and materialized views for fast ingestion and querying at scale. * **Real-Time Data Processing** Designing ingestion pipelines that classify, deduplicate, and assign company identity on the fly. * **Scalable Reprocessing** Systems that reprocess 100M+ records within hours — enabling batch updates and re-training. * **Backend Engineering (Senior Level)** Strong software engineering practices to build scalable, reliable APIs; experience with performance, monitoring, observability, and production readiness. * **AI for Web Scraping Automation (Future Work)** Interest or experience in automating scraper generation using AI — e.g., analyzing browser network requests to reverse engineer internal APIs. What you will work on [#what-you-will-work-on] These are some actual problems we’re looking that the person we hire will help us solve. * Build a **real-time job ingestion pipeline** that resolves company identity and deduplicates incoming data. * Design and maintain a **ClickHouse schema** for fast querying of new and reposted jobs. * Own backend components powering this pipeline, applying **robust engineering practices** (tests, observability, scalability). * Enable fast, repeatable reprocessing of **historical job data (100M+)** for retroactive improvements. * Collaborate on long-term R\&D around **AI-assisted scraper generation**, reducing time to ingest new job sources. About you [#about-you] You are a curious person and can learn things on your own. You like learning about the internals of the systems you work with. You’re familiar with testing, value code quality and maintainability. You are a team player, like teaching what you know and helping others grow as well. You don’t have to be managed and can think of the right tradeoffs to be made to find the right technical solutions given the business context. You don’t need to be fluent in English, but should be able to read and write in English, as most of our customers are international. How we work [#how-we-work] The team [#the-team] Compensation [#compensation] 40-80k€/year Location [#location] On-site position at our co-working space in A Coruña, Spain Interview process [#interview-process] * An offer from us. * And as many extra calls you and us need to get to know each other, the code… better. One more thing [#one-more-thing] We’re flexible about many things (salary, profit share, location), and everything is pretty much negotiable. Nothing is written in stone. Even if you don’t tick all boxes but still think this is an interesting position, are excited about the challenges we have and think you can help us make the pie larger, apply! How to apply [#how-to-apply] Apply through this [link](https://tally.so/r/mZMk2e) --- title: TheirStack vs BrightData description: Looking for the best job data solution? Compare TheirStack and BrightData side by side. While BrightData offers basic job scraping for platforms like LinkedIn and Indeed, TheirStack provides a comprehensive, real-time job data platform with advanced filtering, instant results, and seamless integration. Discover which solution best fits your needs in this detailed comparison guide. url: https://theirstack.com/en/docs/comparisons/theirstack-vs-brightdata --- Quick Decision Guide [#quick-decision-guide] **Choose TheirStack if** * You need a real-time solution that responds in 100ms-2s * You want a fast and easy integration with a single API call * You want to filter by attributes like company countries, industries, company sizes, job description, etc * You want all the jobs from all the job boards in one place and don't want to handle job deduplication. **Choose BrightData if** * You don't need a real-time solution and are fine waiting 4-5 minutes for each job search. * You're comfortable implementing a complex integration with multiple API calls, retry logic, and snapshot storage. * You don't need extensive filtering capabilities * You're prepared to manage separate processes for each job board and handle job deduplication yourself. What is BrightData? [#what-is-brightdata] BrightData is a general purpose web data extraction platform, so jobs per se are not their main focus. On the other hand, jobs is at the core of what we do at TheirStack. So 100% of our effort is in building a high-quality, end-to-end job data platform. Development cost and complexity [#development-cost-and-complexity] BrightData's integration is complex: * It requires at least two API calls for each search: one to create the search and another to retrieve the results. * You'll need to save in your database the snapshot ID of each search so that you can retrieve the results later. * You'll need to implement retry logic since the data isn't immediately available and can take several minutes to be ready. * There is no pagination so you will likely miss some jobs * If you need to search in multiple job boards, * you'll need separate API calls for each source * you'll need to handle job deduplication on your side because job boards share most of their jobs. TheirStack integration is straightforward with just a single API call needed. You can find our complete documentation [here](/en/docs/api-reference/jobs/search_jobs_v1). Response time [#response-time] When you make a request to TheirStack, we make a search in our database, which already contains millions of jobs scraped from [thousands of job boards and websites](/en/docs/data/job/sources). The response comes back almost instantly - 90% of our requests finish in less than 2 seconds. For example, to get the last data analyst jobs posted in NYC in the last 7 days with us you'd make this call: ```bash curl --request POST \ --url "https://api.theirstack.com/v1/jobs/search" \ --header "Content-Type: application/json" \ --header "Authorization: Bearer " \ --data '{ "posted_at_max_age_days": 7, "job_country_code_or": [ "US" ], "job_title_or": [ "data analyst" ], "job_location_pattern_or": [ "new york", "nyc" ] }' ``` In BrightData, when you make a search they do a live call to their job boards to get the data. This process involves 2 calls and the results not only aren't instant but take **minutes** to come back. To get the same data as in the previous example, first you'd make a call like this: ```bash curl --request POST \ --url "https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lpfll7v5hcqtkxl6l&include_errors=true&type=discover_new&discover_by=keyword&limit_per_input=5" \ --header "Authorization: Bearer " \ --header "Content-Type: application/json" \ --data '[ { "location": "New York", "keyword": "data analyst", "country": "US", "time_range": "Past week", "job_type": "", "experience_level": "", "remote": "", "company": "" } ]' ``` The result of this would not be the data directly, but a snapshot ID like this: ```json { "snapshot_id": "s_m5o15lt05g12b9s1x" } ``` You'd then need to make a second call to get the data: ```bash curl --request GET \ --url "https://api.brightdata.com/datasets/v3/snapshot/s_m5o15lt0rn12b9s1x?format=json" \ --header "Authorization: Bearer " ``` From our tests, this requests takes 8-10s to complete, and even after 3 or 4 minutes, the data isn't ready yet and we'd get responses like this: ```json { "status": "running", "message": "Snapshot is not ready yet, try again in 10s" } ``` This invalidates using BrightData for any real-time use case you might have related to jobs. But not only that. Extensive filtering capabilities [#extensive-filtering-capabilities] BrightData just lets you filter by the limited set of filters LinkedIn supports. TheirStack lets you filter by many filters that LinkedIn or BrightData don't support and won't support anytime soon. To name a few: * **Company filters:** By industry, size, country, revenue, funding, URL, LinkedIn URL or slug, etc. * **Job filters:** By title, description, country, city, remote options, salary, etc. Regular expression filters are supported by many fields like title, description or locations Historical data [#historical-data] BrightData only provides access to recent job postings, with limited historical data availability. TheirStack maintains a comprehensive historical database of jobs dating back to 2019, allowing you to access and analyze job postings across much larger time spans. Comprehensive documentation. [#comprehensive-documentation] BrightData's job scraping API documentation is limited and requires frequent communication with support to understand parameter usage and functionality. We are an API-first company, so our [Job Search API](/en/docs/api-reference/jobs/search_jobs_v1) is at the core of what we do and we talk with users daily to make it better and add new filters and features they need. We put great care into the developer experience, and you can tell so by visiting the link above and seeing how well documented our API is, so that you don't have to waste time figuring out how each parameter works or talking to support to get help. Job consolidation across multiple job boards [#job-consolidation-across-multiple-job-boards] BrightData offers LinkedIn, Indeed and Glassdoor job scrapers. We scrape those and more job boards, having jobs from tens of thousands of domains. With BrightData you would need to use one individual scraper per each job board, and then consolidate jobs into a central repository. With TheirStack, we consolidate jobs from all of them into a single database and provide a single API endpoint to access them so that you can get all the jobs you want with a single request, instead of having to make multiple requests to different scrapers. Job deduplication [#job-deduplication] Because BrightData has different endpoints for each job board, they don't handle job deduplication across them. But it happens many times that the same job appears on multiple job boards. As we offer a single entrypoint for all our job data, we have built our own job deduplication algorithm that lets us identify if the same job has already been scraped. Therefore, you won't get the same job twice and you won't have to worry about handling job deduplication yourself. --- title: TheirStack vs BuiltWith description: Compare TheirStack and BuiltWith to find the best technographic database for your needs. Learn how TheirStack offers broader technology coverage, real-time webhooks, and confidence scoring, while BuiltWith specializes in web technology tracking. url: https://theirstack.com/en/docs/comparisons/theirstack-vs-builtwith --- Builwith and TheirStack are a technographic databases that provide tools for lead generation, market research, and business intelligence. Quick Decision Guide [#quick-decision-guide] **Choose TheirStack if:** * You need to know who is using technologies that are not web technologies: CRMs, ERPs, databases, ATS, programming languages, etc. * You want to leverage Webhooks to trigger actions as soon as you detect a new technology used by a company. **Choose BuiltWith if:** * You need to know who is using a specific web technology: CMSs, E-commerce platforms, payment processors, etc. What is BuiltWith? [#what-is-builtwith] BuiltWith is a web analytics platform that provides detailed insights into website traffic, market share, and audience demographics. It offers a range of tools and data to help businesses understand their online presence and competitors. Data sources [#data-sources] Our approach to sourcing tech usage data sets us apart from BuiltWith in a few key ways. First, we offer a broader technology catalog that includes not only web technologies but also CRMs, ERPs, databases, and various internal tools. BuiltWith focuses solely on web technologies. Additionally, instead of tracking websites, we gather data from job postings. Each month, we collect job listings from millions of companies by monitoring company websites, job boards, and other hiring platforms. When a job listing mentions a specific technology in the title or description, it indicates that the company likely uses that technology. We then assign a Confidence Score (low, medium, high) based on the frequency and context of these mentions to estimate how likely the company is to use that technology. Pricing [#pricing] Our pricing model is also unique. While BuiltWith charges based on technology reports, we base our pricing on the number of companies returned in your search. Comparison table [#comparison-table] | Feature | TheirStack | BuiltWith | | ---------------------- | ------------------------------------------------------------------- | ----------------------------------- | | Technology Coverage | Web technologies, CRMs, ERPs, databases, ATS, programming languages | Web technologies only | | Data source | Job postings | Website crawling | | Data Freshness | Daily updates from job postings | Website crawling | | Confidence Scoring | Yes, based on job posting frequency and context | No | | Webhook Support | Yes, real-time notifications | No | | API Response Time | 100ms-2s | no data | | Integration Complexity | Single API call | Multiple API calls with retry logic | | Filtering Capabilities | Extensive (company countries, industries, sizes, etc.) | Limited | | Pricing Model | Based on number of companies returned | Based on technology reports | --- title: TheirStack vs Coresignal description: Compare TheirStack and Coresignal to find the best job data solution. While Coresignal offers extensive datasets and APIs for company, employee, and job data, TheirStack provides a comprehensive, real-time job data platform with advanced filtering, instant results, and seamless integration. Discover which solution best fits your needs in this detailed comparison guide. url: https://theirstack.com/en/docs/comparisons/theirstack-vs-coresignal --- TheirStack and Coresignal are both data providers that offer job and company data. Quick Decision Guide [#quick-decision-guide] **Choose TheirStack if** * You need deduplicated job data from over 312k sources including LinkedIn, Indeed, and ATS platforms. * You want a single API to access jobs combined and deduplicated from multiple sources (LinkedIn, Indeed and [16k+ more](/en/docs/data/job/sources)). * You value the possibility of making job searches filtering by company attributes (for example, "give me jobs from US companies" or "give me jobs from companies under 1000 employees") * You value the possibility of making company searches filtering by job attributes (for example, "give me companies hiring SDRs" or "give me companies with Python jobs") * You need mostly jobs and company data, and you care about not paying too much for it. **Choose Coresignal if** * You need employee data (email, experience, skills, etc.). Coresignal's employee data is very good. * You want highly detailed company data (including news, financials, etc.). Coresignal's company data is very good as well. * You don't need to make company searches filtering by their jobs, or job searches filtering by company attributes. * If you want jobs, you're OK with getting only jobs from LinkedIn. * You don't mind paying more for fewer jobs than you could get with TheirStack. What is Coresignal? [#what-is-coresignal] Coresignal is a data provider focused on 3 kinds of datasets: * Jobs data * Company data * Employee data Up to this date, all of Coresignal's data comes from LinkedIn. Even though t Coresignal's interface is API only and there is no way to explore the data visually.\ Coresignal has a free plan, but in small plans the costs per credit are very high, up to $0.2 per job. They are sales-led and their pricing is heavily weighted towards customers buying expensive plans, needed to support their sales team.\ To fetch jobs with Coresignal, you need to use 2 API endpoints: `search` to get the job data and `collect` to get the job data. What is TheirStack [#what-is-theirstack] TheirStack is a data provider focused on 3 kinds of datasets: * Jobs data * Company data TheirStack combines jobs data from multiple sources and deduplicates them.\ TheirStack has a free plan and put a lot of effort into the developer experience and into making the product as self-service as possible.\ TheirStack's pricing is thought to be able to support both customers starting out as well as bigger customers with higher usage needs.\ With a single API, TheirStack customers can fetch jobs data, making it easier to build integrations and estimate costs.\ TheirStack offers a UI that can be used to explore the data visually, export it, integrate with other sources and also works as an API playground to learn how to use the API. How does Coresignal compare to TheirStack? [#how-does-coresignal-compare-to-theirstack] | Feature | TheirStack | Coresignal | | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------ | | Job data | ✅ Jobs Linkedin, Indeed, ATS Platforms (Lever, Workable, Greenhouse...). More than [16.000 sources](/en/docs/data/job/sources) | ❌ Only Linkedin (Glassdoor and Indeed not via API) | | Company data | ✅ Including funding, size, industry... | ✅ Including funding, size, industry, news... | | Employee data | ❌ No employee data | ✅ Employee data including email, experience, skills... | | Technographic data | ✅ More than 32k technologies tracked in jobs and companies, not only frontend tools | ❌ Only information about frontend technologies | | Job deduplication | ✅ We [deduplicate jobs](/en/docs/data/job/data-workflow#job-deduplication) posted in multiples sources | ❌ Not supported (just jobs from LinkedIn via API) | | Filtering jobs by company attributes | ✅ [Fully supported](/en/docs/data/job/data-workflow#data-enrichment) (industry, size, revenue, description...) | ❌ Not supported | | Filtering companies by job attributes | ✅ [Fully supported](/en/docs/api-reference/companies/search_companies_v1) (title, description, date, location...) | ❌ Not supported | | Data delivery methods | ✅ [API](/en/docs/api-reference), ✅ [Webhooks](/en/docs/webhooks), ✅ [Flat Files](/en/docs/jobs-dataset) | ✅ API, ❌ Webhooks, ✅ Flat Files | | API complexity | ✅ Single [job search endpoint](/en/docs/api-reference/jobs/search_jobs_v1) to get all data | ❌ 2 API endpoints: search and collect | | Documentation | ✅ Clear and easy to understand | ❌ Confusing, not clear what each endpoint does | | User Interface | ✅ [Intuitive UI](https://app.theirstack.com) to explore the data and build API queries | ❌ No UI available | | Credit roll-over | ✅ Unused credits roll-over. Credits can be used for up to 12 months, even in monthly plans | ❌ No roll-over. Credits reset every month | | Job freshness | ✅ Jobs database updated every minute, almost in real-time | ❌ Jobs database updated every 6 hours | | Free plan | ✅ Free plan with 50 new company credits and 200 new API credits per month forever | ❌ 14-day free trial | Price comparison [#price-comparison] This is what fetching jobs from TheirStack and Coresignal costs via API: | Number of jobs | TheirStack (see [pricing](/en/pricing?tab=api\¤cy=usd)) | Coresignal (see [pricing](https://coresignal.com/pricing)) | | -------------- | ------------------------------------------------------------- | ---------------------------------------------------------- | | 200 | ✅ Free | ✅ Free | | 1,500 | ✅ $59 | ❌ $294 (5x more expensive) | | 5,000 | ✅ $100 | ❌ $800 (8x more expensive) | | 10,000 | ✅ $169 | ❌ $800 (4.7x more expensive) | | 20,000 | ✅ $239 | ❌ $1,000 (4.2x more expensive) | | 50,000 | ✅ $400 | ❌ $1,500 (3.8x more expensive) | | 100,000 | ✅ $600 | ❌ $2,000 (3.3x more expensive) | | 200,000 | ✅ $900 | ❌ $3,000 (3.3x more expensive) | | 500,000 | ✅ $1,000 | ❌ $5,000 (5x more expensive) | | 1,000,000 | ✅ $1,500 | ❌ $7,000 (4.7x more expensive) | --- title: TheirStack vs FantasticJobs description: Compare TheirStack and FantasticJobs to find the best job data solution. url: https://theirstack.com/en/docs/comparisons/theirstack-vs-fantasticjobs --- Quick Decision Guide [#quick-decision-guide] **Choose TheirStack if** * You need deduplicated job data from over 312k sources including LinkedIn, Indeed, and ATS platforms. * You want enriched company data like industry, size, revenue, and description. * You require advanced filtering (30+ filters) and webhooks for real-time workflows. * You prefer a simple, unified API for all job sources. * You want reliable company logos and the ability to search companies based on job activity. **Choose FantasticJobs if** * You only care about basic job listings from select ATSs and platforms like LinkedIn or Ashby. * You're okay with using multiple APIs and handling deduplication, enrichment, and filtering yourself. What is FantasticJobs? [#what-is-fantasticjobs] FantasticJobs is a job data platform designed to provide developers, startups, and job boards with access to millions of up-to-date job listings through APIs and custom data feeds. Comparison [#comparison] This comparison is based in all public information we could find about FantasticJobs. If you have more information or something is wrong, please let us know. | Feature | TheirStack | FantasticJobs | | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Sources | ✅ Linkedin, Indeed, ATS Platforms (Lever, Workable, Greenhouse...). More than [16.000 sources](/en/docs/data/job/sources) | ✅ Linkedin, ATS Platforms (Ashby, BambooHR, Join..) sources | | Freshness | ✅ We are constantly updating our data | ❌ Under 3h | | Coverage | 9.5M jobs per month | ✅ 10M jobs per month | | Job deduplication | ✅ We [deduplicate jobs](/en/docs/data/job/data-workflow#job-deduplication) posted in multiples sources | ❌ not supported | | Company enrichment | ✅ [+6 company data fields](/en/docs/data/job/data-workflow#data-enrichment) enriched from multiple sources (industry, size, revenue, description...) | ❌ not supported | | Filters | ✅ 30 filters (job, company and hiring manager data) | ❌ 10 filters. No filters by company, city.. data | | API - Easy to use | ✅ One job search API to query [16.000 sources](/en/docs/data/job/sources) | ❌ 1 API for ATSs (3 endpoints: jobs last 7 days, last 24h, last hour) + 1 API for Linkedin (3 endpoints: jobs last 7 days, last 24h, last hour) + 1 For Upwork + 1 YC jobs | | Webhooks | ✅ Webhooks to trigger actions when a new job is posted | ❌ No webhooks. Requires cron jobs for database backfill, no real-time notifications | | AI field extraction | ❌ | | | Data fields | ✅ Company logo hosted by TheirStack with stable link | ❌ Company logo unstable | | Company searches | ✅ | ❌ You can't do company searches: companies with most developer positions in the last 30 days | | Datasets | ✅ flat-files | ❌ not supported | | Documentation | ✅ Clear and easy to understand | ❌ Incomplete and confusing | --- title: TheirStack vs HG Insights description: Looking for the best way to work with job data? Compare TheirStack and HG Insights side by side. While HG Insights is an enterprise market-intelligence and technographics platform with sales-led pricing and access, TheirStack provides a self-serve, real-time job data platform with advanced filtering, instant results, and a developer-friendly API. See which solution fits your use case in this practical comparison. url: https://theirstack.com/en/docs/comparisons/theirstack-vs-hginsights --- Head-to-head at a glance [#head-to-head-at-a-glance] | Criteria | TheirStack | HG Insights | | --------------- | ----------------------------------------------- | ----------------------------------------------------- | | Access | Self-serve API with clear docs | Sales-led, no self-serve | | Pricing | Affordable, usage-based; free testing available | \~$10k/seat/year+, annual enterprise | | Jobs API | Yes (real-time) | No | | Technographics | Practical signals from job postings | Core technographics coverage | | Extra endpoints | Installs-like signals from jobs | Installs, Spend, Functional Area Intelligence, Intent | | Response time | 100ms–2s typical | Not a real-time jobs API | | Historical jobs | 2019–present | Not a jobs database focus | | Integration | Single API call | Enterprise onboarding, dashboards/CRM | Quick Decision Guide [#quick-decision-guide] **Choose TheirStack if** * You want a jobs API that provides real-time access to job data * You need a real-time solution that responds in 100ms-2s * You want a fast and easy integration with a single API call * You want to filter by attributes like company countries, industries, company sizes, job description, etc * You want all the jobs from all the job boards in one place and don't want to handle job deduplication * You want to trace back and see the origin of technographics data directly from job postings * You prefer self-serve access with clear documentation and a developer-first experience **Choose HG Insights if** * You're buying an enterprise market-intelligence/technographics platform and can commit to annual contracts * You're comfortable with pricing that starts around $10k per seat per year * You're okay with a sales-led process (no self-serve), demos, and onboarding calls * You don't need a real-time jobs API and are fine with dashboards, exports, or managed delivery What is HG Insights? [#what-is-hg-insights] HG Insights is an enterprise data platform focused on firmographics and technographics (e.g., what technologies companies use), TAM planning, and account selection. Their core strengths are in sales and marketing use cases at larger organizations. TheirStack, by contrast, is built specifically for jobs. Jobs are at the core of what we do, so 100% of our effort goes into building a high-quality, end-to-end job data platform. Pricing and contracts [#pricing-and-contracts] * HG Insights pricing commonly starts around $10k per seat per year * Access is sales-led with enterprise-style contracts and annual commitments * There is no self-serve checkout; you must talk to sales to get access TheirStack offers a developer-first experience with clear documentation and a simple API you can try right away. Integration and developer experience [#integration-and-developer-experience] HG Insights is designed for enterprise deployments. Access typically goes through sales, and documentation is not openly self-serve. Implementations often center on dashboards, exports, or CRM integrations rather than a real-time jobs API. TheirStack integration is straightforward with just a single API call needed. You can find our complete documentation [here](/en/docs/api-reference/jobs/search_jobs_v1). UI and contact data integrations [#ui-and-contact-data-integrations] * Beyond the API, TheirStack provides a rich UI where you can run company and job searches and quickly find people contacts from selected companies. * We integrate with leading contact data providers (Apollo, ContactOut) and LinkedIn (Free, Recruiter, Sales Navigator) to streamline outreach from search results. * Learn more in our guide: [Find people](/en/docs/app/contact-data/find-people). APIs and capabilities [#apis-and-capabilities] * If you want technographics via API, both platforms can work. TheirStack is much more affordable and you can test it for free. * TheirStack offers a real-time **Jobs API**; HG Insights does not provide a jobs API. * HG Insights includes dedicated enterprise endpoints, while TheirStack delivers similar outcomes via jobs-derived signals: * Installs-like signals: quantified mentions per company, confidence, first/last seen, mention location, and relative occurrence vs similar technologies * Spend orientation: HG models technology spend; TheirStack emphasizes observed adoption and hiring intensity signals from jobs * Functional area insights: infer likely department with job role/department fields and where the tech is mentioned (title/description/URL) * Intent: HG exposes an Intent API; TheirStack enables intent-like workflows via keyword searches and trend analysis in job postings Choose HG Insights if you specifically need those enterprise endpoints. Choose TheirStack for fast, self-serve, and cost-effective programmatic access to job data and practical technographic signals from job postings. Extensive filtering capabilities [#extensive-filtering-capabilities] * **Company filters (TheirStack):** By industry, size, country, revenue, funding, URL, LinkedIn URL or slug, etc. * **Job filters (TheirStack):** By title, description, country, city, remote options, salary, etc. Regular expression filters are supported by many fields like title, description or locations. HG Insights focuses on firmographics/technographics for account selection and market intelligence, not deep, real-time job-posting filters. Historical data [#historical-data] TheirStack maintains a comprehensive historical database of jobs dating back to 2019, enabling analysis across larger time spans. HG Insights' primary strength is historical technographic and firmographic context; job postings are not the focus of their platform. Job consolidation across multiple job boards [#job-consolidation-across-multiple-job-boards] With TheirStack, we consolidate jobs from many sources into a single database and provide a single API endpoint to access them. You can get all the jobs you want with one request instead of orchestrating multiple scrapers. Job deduplication [#job-deduplication] Because we offer a single entry point for all our job data, we have built our own job deduplication algorithm that lets us identify if the same job has already been scraped. You won't get the same job twice and you won't have to handle deduplication yourself. --- title: TheirStack vs PredictLeads description: Compare TheirStack and PredictLeads to find the best solution for your business needs. TheirStack offers a real-time job data platform, while PredictLeads provides comprehensive company intelligence data. Discover which solution best fits your needs in this detailed comparison guide. url: https://theirstack.com/en/docs/comparisons/theirstack-vs-predictleads --- Quick Decision Guide [#quick-decision-guide] **Choose TheirStack if** * You need a real-time job data platform that responds in 100ms-2s. * You want a fast and easy integration with a single API call. * You want to filter by attributes like company countries, industries, company sizes, job description, etc. **Choose PredictLeads if** * You need comprehensive company intelligence data. * You're interested in signals like hiring intent, new customers signed, and product launches. * You want to identify growing companies and understand target prospects. What is PredictLeads? [#what-is-predictleads] PredictLeads provides structured company intelligence data via APIs, Flat Files, and Webhooks, helping businesses identify growing companies and improve outreach personalization. TheirStack, on the other hand, focuses on providing a real-time job data platform with advanced filtering and instant results. Comparison [#comparison] This comparison is based in all public information we could find about PredictLeads. If you have more information or something is wrong, please let us know. I would love if they were more transparent about their product, pricing and features. PredictLeads and TheirStack are both data providers that offer job and technographic data. This comparison is done only on those two datasets. PredictLeads also offer other datasets like New Events or Github repositories that are not covered in this comparison. Job data [#job-data] | Feature | TheirStack | PredictLeads | | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | Sources | ✅ Linkedin, Indeed,YC job board, ATS Platforms (Lever, Workable, Greenhouse...). More than [16.000 sources](/en/docs/data/job/sources) | ❌ Only Linkedin and ATSs (Ashby, BambooHR, Join..) sources | | Freshness | ✅ We are constantly updating our data | not specified | | Coverage | 166M historical jobs | 206M historical jobs | | Data delivery methods | ✅ API, Webhooks, Flat Files | ✅ API, Webhooks, Flat Files | | Job deduplication | ✅ We [deduplicate jobs](/en/docs/data/job/data-workflow#job-deduplication) posted in multiples sources | ✅ | | API - Easy to use | ✅ One job search API to query [16.000 sources](/en/docs/data/job/sources) | ❌ One API endpoint but you need to call for each company individually
❌ Job endpoint does not return company data | | Company enrichment | ✅ [+6 company data fields](/en/docs/data/job/data-workflow#data-enrichment) enriched from multiple sources (industry, size, revenue, description...) | ✅ | | Filters | ✅ 30 filters (job, company and hiring manager data) | ❌ 6 filters and you can't filter by job title, description, location... | | Data fields | ✅ Company logo hosted by TheirStack with stable link | ❌ Company logo unstable | | Documentation | ✅ Clear and easy to understand | ❌ Incomplete and confusing | --- title: TheirStack vs Similarweb description: Compare TheirStack and Similarweb to find the best solution for your needs. Learn how TheirStack offers technographic data and real-time webhooks, while SimilarWeb specializes in web traffic and market intelligence. url: https://theirstack.com/en/docs/comparisons/theirstack-vs-similarweb --- SimilarWeb and TheirStack are powerful tools that serve different purposes in the business intelligence space. While SimilarWeb focuses on web traffic and market intelligence, TheirStack specializes in technographic data and real-time technology usage tracking. Quick Decision Guide [#quick-decision-guide] **Choose TheirStack if:** * You need to know which companies are using internal tools like CRMs, ERPs, databases, programming languages, etc. * You want real-time notifications when companies adopt new technologies * You're looking for technographic data to power your sales and marketing efforts **Choose SimilarWeb if:** * You need detailed web traffic analytics and market intelligence * You want to understand your competitors' digital performance * You're interested in audience insights and market share analysis What is SimilarWeb? [#what-is-similarweb] SimilarWeb is a web analytics platform that provides detailed insights into website traffic, market share, and audience demographics. It offers a range of tools and data to help businesses understand their online presence and competitors. Data sources [#data-sources] Our approach to data collection differs significantly from SimilarWeb. While SimilarWeb primarily focuses on web traffic data through browser extensions, panel data, and direct measurement, we gather our data from job postings. Each month, we collect job listings from millions of companies by monitoring company websites, job boards, and other hiring platforms. When a job listing mentions a specific technology in the title or description, it indicates that the company likely uses that technology. We then assign a Confidence Score (low, medium, high) based on the frequency and context of these mentions. Pricing [#pricing] Our pricing model is based on the number of companies returned in your search, making it more predictable and scalable for businesses of all sizes. SimilarWeb's pricing is typically based on the level of access to their traffic data and market intelligence features. Comparison table [#comparison-table] | Feature | TheirStack | SimilarWeb | | ---------------------- | ------------------------------------------------------ | ----------------------------------- | | Primary Focus | Technographic data and technology usage tracking | Web traffic and market intelligence | | Data Sources | Job postings and hiring platforms | Browser extensions, panel data | | Real-time Updates | Yes, through webhooks | Limited | | Confidence Scoring | Yes, based on job posting frequency and context | No | | Webhook Support | Yes, real-time notifications | No | | API Response Time | 100ms-2s | 1-5s | | Integration Complexity | Single API call | Multiple API calls | | Filtering Capabilities | Extensive (company countries, industries, sizes, etc.) | Limited | | Pricing Model | Based on number of companies returned | Based on access level | | Data Types | Technology usage, company information | Traffic, audience, market share | --- title: TheirStack vs Sumble description: TheirStack and Sumble are very similar products, but with big differences in pricing, volume, freshness and go-to-market strategy. This is an unbiased comparison of the two products. url: https://theirstack.com/en/docs/comparisons/theirstack-vs-sumble --- TheirStack and Sumble are both powerful platforms that transform job postings into actionable sales intelligence and technographic data. TheirStack has been collecting data since 2021, is bootstrapped and profitable with thousands of customers. We've put a big effort in building a world-class self-serve experience for people to use our UI, API and webhooks in an autonomous way. Our [transparent public pricing](https://theirstack.com/en/pricing?currency=usd\&tab=api) already includes big volume discounts that will let you scale as you want without having to engage in long sales process or be locked into long, expensive contracts. Sumble is a more recent player that has raised [almost $40M](https://techcrunch.com/2025/10/22/sumble-emerges-from-stealth-with-38-5m-to-bring-ai-powered-context-to-sales-intelligence/) in venture capital, with a sales motion focused on enterprise customers. Their product is fast and capable, but smaller in data volume and freshness when it comes to jobs and organizations than us. Even though Sumble has a basic [pricing](https://sumble.com/pricing) page, knowing costs if one needs more volume than what their $99/month plan offers is unclear and will require talking to sales. Head-to-head at a glance [#head-to-head-at-a-glance] | **Criteria** | **TheirStack** | **Sumble** | | --------------------------------------------- | ------------------------------------------------ | ----------------------------------------------------------------- | | **Org Database Size** | ✅ **9.5 Million Organizations** | ❌ 2.7 Million Organizations | | **Job Volume** | ✅ **9.5M jobs per month** | ❌ \~1.8M jobs per month | | **Job Freshness** | ✅ **Minutes (Near Real-time)** | ❌ Up to 24 hours delay | | **Cost per job (API)** | ✅ **$0.0015 – $0.039** | ❌ **\~$0.03** – ? (unknown volume discounts) | | **Cost per organization (API)** | ✅ **$0.0045 – $0.11** | ❌ **$0.05** – ? (unknown volume discounts) | | **Technographics Cost** | ✅ **Fixed: $0.0045 – $0.11** (All technologies) | ❌ **Variable: \~$0.05 PER technology** | | **Credit Price** | ✅ **Decreases with volume** ($0.039 → $0.0015) | ❌ **Static/Talk to Sales** (\~$0.01) | | **Price transparency, scaling to Enterprise** | ✅ **Self-serve, public volume discounts** | ❌ "Talk to Sales" | | **API Documentation** | ✅ **Clear, extensive, self-serve** | ❌ **Limited, unclear** | | **API Filters** | ✅ **40+ filters** (job, company, tech, regex) | ❌ **7 filters** (even job title filter apparently not available) | | **Max jobs in $100/month plan** | ✅ 5,000 | ❌ 3,300 | | **Max signals in $100/month plan** | ✅ 1,666 | ❌ 600 | | **Max jobs in free plan** | ✅ 200 | ❌ 166 | | **Max signals in free plan** | ✅ 66 | ❌ 28 | | **Max monthly spend before talking to sales** | ✅ $1500/month | ❌ $99/month | | **UI Pagination** | ✅ **Infinite Pages (pay only for what you see)** | ❌ Capped at 10 pages (Pro) | | **Original Job URLs** | ✅ **Provided (verify & repost)** | ❌ No source links | | **Person-level Signals** | ❌ Not supported | ✅ **LinkedIn-based person data** | | **Team Identification** | ❌ Not supported | ✅ **Department/Team breakdown** | | **Job Title Normalization** | ❌ Not supported | ✅ **ML-based job title normalization** | | **Technology Catalog Quality** | ✅ **Clean catalog (actual technologies only)** | ❌ **Dirty catalog (many non-tech phrases from NER)** | | **Organization Intelligence** | ❌ No parent-subsidiary mapping | ✅ **Hierarchical org structure, parent-subsidiary relationships** | Pricing Drill-down [#pricing-drill-down] 1. Transparency and Scaling: No Sales Calls Required [#1-transparency-and-scaling-no-sales-calls-required] TheirStack's [public pricing](https://theirstack.com/pricing) shows exactly what you'll pay at every level. As you scale, the cost per credit drops dramatically—down to **$0.0015** per credit on our $1,500 plan. You can scale from 1,500 to 1,000,000 credits autonomously. TheirStack pricing Sumble's Pro plan ([check their pricing here](https://sumble.com/pricing)) provides 9900 credits for $99/month. Once you need more, there is no other option than to contact sales for an Enterprise plan. Sumble pricing **Conclusion: TheirStack wins on pricing transparency and self-serve scaling.** 2. Job and Organization Costs (API Credits) [#2-job-and-organization-costs-api-credits] At TheirStack, a job costs exactly **1 API credit**. An organization lookup costs exactly **3 API credits**. TheirStack also have webhooks, which is the equivalent of Sumble's signals. The cost of getting data via webhooks on TheirStack is the same as via API (1 job = 1 API credit, 1 company = 3 API credits). On Sumble, what you can get via signals is limited to 20/day with their Pro plan, so you can only get up to 600 signals per month. Sumble charges **3 credits per job** (\~$0.03 with their Pro plan). The closest plan TheirStack has in price offers 5k API credits for $100/month. For the same montly spend, TheirStack gives you: * Up to 5k jobs * Up to 1,666 companies via webhooks (what Sumble calls signals) On the other hand, Sumble gives you: * Up to 3.3k jobs * Up to 600 signals (600 companies) **Conclusion: TheirStack wins on job and organization costs.** 3. Technographics cost: Fixed vs. Variable [#3-technographics-cost-fixed-vs-variable] This is where the difference is most extreme. * **TheirStack:** A single lookup (3 API credits) returns **every technology** we have ever identified for an organization, along with confidence levels and granular metrics. * **Sumble:** They charge **5 credits for every single technology** found. **The Price Equivalency:** If you enrich an organization that uses 20 technologies: * **Sumble:** 100 credits = **\~$1.00** * **TheirStack:** 3 credits = **$0.0045 – $0.11** TheirStack is up to **200x more cost-effective** for technographic enrichment at scale. **Conclusion: TheirStack wins on technographics cost.** 4. UI Pagination and Search Limits [#4-ui-pagination-and-search-limits] Sumble's "Pro" plan caps your search results at **10 pages**. TheirStack is fully usage-based and provides **infinite pagination** in the UI—as long as you have the credits to view the data, you can access it. **Conclusion: TheirStack wins on UI pagination and search limits.** Data Volume and Freshness [#data-volume-and-freshness] When it comes to the sheer volume of data and how quickly it's delivered, TheirStack consistently outperforms Sumble across both jobs and organization profiles. Job Volume: 4x More Coverage [#job-volume-4x-more-coverage] TheirStack jobs per week TheirStack identifies over **2.4M jobs per week**, which is **9.5M jobs in the last 30 days**. [Click here to open this search on TheirStack](https://app.theirstack.com/search/jobs/new?query=N4IgjgrgpgTgniAXKAlgOwMYBsIBMoD6ALgPZECGWBMUAzhFkbUgGaW1QA0IJM+MBAEYJEAbVD5aGJERjRuLFFCy4kIXOSKEADiVpbVAXwC63Xfqi4CmggFtyAD2sBzQhrjNEAdkPdyEUgIOchgMAAsZOShDIA) to double-check it yourself. Sumble jobs per month Sumble only surfaces approximately **1,800,000 jobs per month**. This gives TheirStack over **4x more volume** than Sumble. Double-check by going to [this same search in Sumble](https://sumble.com/jobs?as=%7B%22operator%22%3A%22AND%22%2C%22children%22%3A%5B%7B%22operator%22%3A%22OR%22%2C%22fields%22%3A%7B%22hiring_period%22%3A%7B%22include%22%3A%5B%221mo%22%5D%2C%22exclude%22%3A%5B%5D%7D%7D%7D%2C%7B%22operator%22%3A%22OR%22%2C%22fields%22%3A%7B%7D%7D%5D%7D). **Conclusion: TheirStack wins on job volume.** Job searches filtering by technology [#job-searches-filtering-by-technology] Both TheirStack and Submle identify technology usage from mentions in job posts. So both of them should be great at being able to surface jobs that mention specific technologies. Let's see how true that is. For a search like **"Python jobs posted in the last 30 days"**, TheirStack identifies over **224,000 jobs**, as seen in the folllowing screenshot. [Open this search on TheirStack](https://app.theirstack.com/search/jobs/new?query=N4IgjgrgpgTgniAXKADgQwOZSQBgDQgA2AlgLbEAuSAjAQPYwAmsA+gEYKIDaozAzgGMkFGNAIAzYlEKMkIRmgpQWKOnyWyAvgF0CbQhBgsBdUugB2cFgopphoqAWLmBB5iwp1bhFjCh8IQgo+ezEQACs6Ng8oAQALczpCOgwrPgMMFgYkLhAUOAo4unMQXTy1DRZFFlI0AA8qrGs0OBDEAGYcTQI0CE8WPig0GHjQqE0gA) TheirStack Python job count On the other hand, Sumble only yields approximately **125,000** jobs for the very same search. [Open this search on Sumble](https://sumble.com/jobs?as=%7B%22operator%22%3A%22AND%22%2C%22children%22%3A%5B%7B%22operator%22%3A%22OR%22%2C%22fields%22%3A%7B%22hiring_period%22%3A%7B%22include%22%3A%5B%221mo%22%5D%2C%22exclude%22%3A%5B%5D%7D%7D%7D%2C%7B%22operator%22%3A%22OR%22%2C%22fields%22%3A%7B%22technology%22%3A%7B%22include%22%3A%5B%22python%22%5D%2C%22exclude%22%3A%5B%5D%7D%7D%7D%5D%7D) Sumble Python job count Real-time Freshness [#real-time-freshness] TheirStack processes and exposes jobs in our API and UI **within minutes** of them being posted online. In contrast, Sumble can take **up to 24 hours** to surface the same listings. See this checking the Time column of the picture above. **Conclusion: TheirStack wins on data freshness.** Database Scale: 9.5M vs 2.7M Organizations [#database-scale-95m-vs-27m-organizations] * **TheirStack:** Detailed data on **9.5 million organizations**. TheirStack 9.5M organizations * **Sumble:** Data on **2.7 million organizations**. Sumble 2.7M organizations TheirStack has 3.5x more organizations in its catalog. **Conclusion: TheirStack wins on organization volume.** Data Depth and Feature Nuances [#data-depth-and-feature-nuances] To provide an objective comparison, it's important to recognize where each platform focuses its engineering efforts. While TheirStack prioritizes the breadth and depth of job data and technographics, Sumble has invested more heavily in the "Person" and "Team" layers of sales intelligence. Person-Level Intelligence [#person-level-intelligence] Sumble includes person-level data, which allows them to offer signals that TheirStack currently does not. For example, they can track when a company increases headcount in a specific area by monitoring changes in LinkedIn profiles. If your workflow requires identifying the specific individuals currently at a company or seeing headcount trends based on existing employees, Sumble has a clear advantage here. TheirStack focuses exclusively on the "Organization" and "Job Posting" level—we tell you who they *want* to hire, not who they *already* have. **Conclusion: Sumble wins on person-level intelligence.** Team and Department Mapping [#team-and-department-mapping] Sumble also attempts to identify and map specific teams within a company. This can be useful for seeing how an organization is structured internally. TheirStack provides granular firmographics and technographics for the organization as a whole, but we do not currently provide a structured breakdown of internal departments or teams. **Conclusion: Sumble wins on team and department mapping.** Job Title Normalization [#job-title-normalization] Sumble uses machine learning to normalize job titles, which can help group similar roles together (e.g., "Software Engineer", "SWE", "Software Developer" might all map to a standardized title). TheirStack does not currently perform job title normalization—we return job titles as they appear in the original job postings. **Conclusion: Sumble wins on job title normalization.** Technology Inference: "Used" vs "Mentioned" [#technology-inference-used-vs-mentioned] Sumble attempts to infer which technologies are actively used versus which are just mentioned as nice-to-haves in job descriptions. They label technologies as either `TECH USED` or `TECH MENTIONED` to help users understand what's required versus what's optional. However, this inference is very unreliable and fails at basic logical relationships. For example, Sumble may mark a JavaScript framework like `D3` or `React` as `TECH USED` while simultaneously marking `JavaScript` itself as only `TECH MENTIONED.` This is logically inconsistent—if a JavaScript framework is used, then JavaScript knowledge is absolutely required as well. The system fails to recognize these fundamental dependencies between technologies. Sumble technology inference TheirStack takes a different approach: we identify all technologies mentioned in job descriptions without attempting to infer usage versus mention. We focus on doing one thing well—accurately identifying what technologies appear in job postings—rather than trying to do more and doing it inconsistently. **Conclusion: TheirStack wins on technology inference reliability.** Technology Catalog Quality [#technology-catalog-quality] Sumble's technology catalog is derived directly from job descriptions using a Named Entity Recognition (NER) model. While this approach can capture a wide range of terms, it yields many entries that aren't actually technologies. A very large percentage of Sumble's catalog consists of "dirty" technologies—phrases like "Python Data Analytics", "Python backend", "Python software development", "Data visualization using Python", and "API/Python" that are descriptive phrases or job functions rather than actual technology names. Sumble technology catalog TheirStack's technology catalog is smaller and cleaner because it doesn't contain this fluff. We focus on identifying actual technologies mentioned in job postings, not extracting every phrase that happens to contain a technology keyword. This results in a more accurate, usable catalog for filtering and analysis. **Conclusion: TheirStack wins on technology catalog quality.** Organization Intelligence and Parent-Subsidiary Relationships [#organization-intelligence-and-parent-subsidiary-relationships] Founded by world-class Machine Learning experts, Sumble does a much better job at organization intelligence, particularly in identifying and mapping hierarchical organizational structures. They can accurately determine whether an organization has subsidiaries or is an independent company, and they effectively tie together organizations under the same parent organization. For example, Sumble can display complex hierarchies like "U.S. Government" → "US Department of Energy" → "Lawrence Berkeley National Laboratory" → "Cyclotron" with clear parent-child relationships. This hierarchical view helps users understand organizational structures and relationships at a glance. Sumble organization intelligence TheirStack treats organizations more independently and does not currently provide the same level of parent-subsidiary relationship mapping or hierarchical organization intelligence. **Conclusion: Sumble wins on organization intelligence and parent-subsidiary relationships.** API Documentation and Filtering Capabilities [#api-documentation-and-filtering-capabilities] Developer Experience: Clear Documentation vs. Limited Docs [#developer-experience-clear-documentation-vs-limited-docs] TheirStack's [Job Search API documentation](/en/docs/api-reference/jobs/search_jobs_v1) is comprehensive, self-serve, and includes examples for every parameter. You can test endpoints directly in the browser. Sumble's [API documentation](https://docs.sumble.com/api/jobs) is more limited. While functional, it lacks the depth and clarity needed for complex integrations. Understanding parameter usage often requires trial and error or reaching out to support. Sumble offers an "advanced query" option that allows filtering by fields like `job_function` or `hiring_period`, but these parameters are **not documented** in their public API reference. This undocumented functionality requires developers to discover features through experimentation or support conversations. Filter Depth: 40+ vs. 7 Filters [#filter-depth-40-vs-7-filters] This is where the gap becomes most apparent for developers building sophisticated search workflows. **TheirStack's Job Search API** offers **40+ filters** across multiple categories: * **Job-level filters:** Title (with regex support), description patterns, location patterns, salary ranges, seniority, remote options, posted date ranges, and more. * **Company-level filters:** Industry, size, country, revenue, funding, URL patterns, LinkedIn URL, and more. * **Technology filters:** Filter by technologies mentioned in job descriptions. * **Advanced features:** Regex support for many text fields, exclusion filters, and complex boolean logic. **Sumble's Jobs API** offers just **7 filters** according to their public documentation: * Company filters (domain, ID, slug) * Technology filters * Technology category filters * Country filters * Date filters (`since`) Notably, **Sumble's API doesn't even support filtering by job title** according to their public documentation. This is a fundamental limitation for many use cases where you need to find specific roles (e.g., "Data Engineer" or "DevOps Manager"). If you need to build sophisticated search workflows—like finding "Python jobs in New York posted in the last 7 days for companies with 50-200 employees"—TheirStack's extensive filtering capabilities support this use case. **Conclusion: TheirStack wins on developer experience.** Quick Decision Guide [#quick-decision-guide] **Choose TheirStack if** * You care about **overall cost**—TheirStack offers significantly lower costs per job, organization, and technographic enrichment. * You need **high volume**—9.5M jobs in the last 30 days vs 1.8M. * You need **real-time data**—jobs available within minutes vs up to 24 hours. * You need **advanced API filters**—40+ filters including regex support vs 7 basic filters. * You want **transparent, self-serve pricing**—scale autonomously without sales calls. * You need **technographics at fixed cost**—all technologies included vs pay-per-technology. * You want a **clean technology catalog**—actual technologies only, not descriptive phrases or job functions. * You want **original job URLs** to verify sources or repost jobs. * You need a **larger organization database**—9.5M organizations vs 2.7M. * You prefer **clear, comprehensive API documentation** with self-serve examples. **Choose Sumble if** * You need **signals based on new hires or growth in headcount**—Sumble tracks changes in LinkedIn profiles to identify headcount trends. * You need **person-level LinkedIn data**—identify specific individuals currently at companies. * You need **team/department mapping**—see how organizations are structured internally. * You need **organization intelligence and parent-subsidiary relationships**—understand hierarchical org structures and identify which companies are subsidiaries vs independent. * You need **ML-based job title normalization**—group similar roles together (e.g., "Software Engineer", "SWE", "Software Developer"). * You only need basic search and don't mind a **10-page limit** on results. * You are okay with a sales-led process for higher volume needs. Summary [#summary] TheirStack offers significantly lower costs (up to 200x more cost-effective for technographics), higher job volume (9.5M jobs in the last 30 days vs 1.8M per month), real-time freshness (minutes vs 24 hours), 40+ API filters, reliable technology identification, a clean technology catalog, and a larger organization database (9.5M vs 2.7M). Sumble provides person-level intelligence, team mapping, organization intelligence with parent-subsidiary relationships, job title normalization, and signals based on new hires or headcount growth that TheirStack does not currently support. --- title: TheirStack vs Wappalyzer description: Compare TheirStack and Wappalyzer to find the best solution for your needs. Learn how TheirStack offers technographic data and real-time webhooks, while Wappalyzer specializes in website technology profiling. url: https://theirstack.com/en/docs/comparisons/theirstack-vs-wappalyzer --- Wappalyzer and TheirStack are both valuable tools in the realm of technology profiling and business intelligence, but they serve different purposes. Wappalyzer focuses on identifying the technologies used by websites, while TheirStack provides comprehensive technographic data and real-time technology usage tracking. Quick Decision Guide [#quick-decision-guide] **Choose TheirStack if:** * You need to know which companies are using internal tools like CRMs, ERPs, databases, programming languages, etc. * You want real-time notifications when companies adopt new technologies * You're looking for technographic data to power your sales and marketing efforts **Choose Wappalyzer if:** * You need to identify the technology stack of specific websites * You want to monitor changes in website technologies * You're interested in browser-based technology profiling What is Wappalyzer? [#what-is-wappalyzer] Wappalyzer is a browser extension that identifies the technologies used by websites. It offers a range of tools and data to help businesses understand their online presence and competitors. Data sources [#data-sources] TheirStack gathers data from job postings, collecting job listings from millions of companies by monitoring company websites, job boards, and other hiring platforms. This approach allows for a broader understanding of technology usage beyond just web technologies. Wappalyzer, on the other hand, uses a browser extension and in-house crawlers to identify technologies used on websites, providing instant results and detailed technology profiles. Pricing [#pricing] TheirStack's pricing model is based on the number of companies returned in your search, making it scalable for businesses of all sizes. Wappalyzer offers a tiered pricing model with options for individuals and businesses, providing a greater number of technology lookups at each plan tier. Comparison table [#comparison-table] | Feature | TheirStack | Wappalyzer | | ---------------------- | ------------------------------------------------------ | ------------------------------------ | | Primary Focus | Technographic data and technology usage tracking | Website technology profiling | | Data Sources | Job postings and hiring platforms | Browser extension, in-house crawlers | | Real-time Updates | Yes, through webhooks | Yes, through browser extension | | Confidence Scoring | Yes, based on job posting frequency and context | No | | Webhook Support | Yes, real-time notifications | No | | API Response Time | 100ms-2s | Split-second | | Integration Complexity | Single API call | Browser-based | | Filtering Capabilities | Extensive (company countries, industries, sizes, etc.) | Limited | | Pricing Model | Based on number of companies returned | Tiered pricing model | | Data Types | Technology usage, company information | Website technology stack | --- title: Clay description: How to add a new column in Clay table with TheirStack data and how to create a new table in Clay with TheirStack data. url: https://theirstack.com/en/docs/integrations/clay --- We're currently in discussions with Clay to establish an official integration. Meanwhile, you can still leverage our data within Clay. Depending on your specific needs, we suggest the following approaches: * [New jobs or companies table in Clay](#new-jobs-or-companies-table-in-clay) (live sync or one-time export) * [Adding a new column to Clay table](#adding-a-new-column-to-clay-table) (manual sync) New Jobs or Companies Table in Clay [#new-jobs-or-companies-table-in-clay] If you aim to create a new table with * A list of jobs posted in the US in the last 30 days that mention a specific keyword. * A list of companies that have posted a job in the last 30 days in New York. * A list of companies using specific technologies like Snowflake, Hubspot, Python, etc. * A list of companies employing a category of technologies like AI, Cloud, etc. with a live sync or as one-time export, follow these steps: 1. Go to the Clay and create a new table and select "monitor webhook" as the source. [Clay Webhook Guide](https://www.clay.com/university/guide/webhook-integration-guide) 2. [Setup a webhook in TheirStack](/en/docs/webhooks/how-to-set-up-a-webhook) Adding a New Column to Clay Table [#adding-a-new-column-to-clay-table] If you have a list of companies in Clay and wish to add a new column with * the number of developer jobs posted by this company in the last 30 days. * "Yes" / "No" if they are utilizing specific technologies like Snowflake, Hubspot, Python, etc. * "Yes" / "No" if they are employing a category of technologies like AI, Cloud, etc. follow these steps: 1. Go to the Clay table you want to add the column to. 2. Click on the "Columns" tab. 3. Click on the "Add Column" and select "HTTP API" [Clay HTTP API Guide](https://www.clay.com/university/guide/http-api-integration-overview) 4. Review our [API docs](/en/docs/api-reference) Frequently asked questions [#frequently-asked-questions] Has anyone integrated and used TheirStack with Clay? [#has-anyone-integrated-and-used-theirstack-with-clay] We’re in talks with Clay to have an official integration with them but it’s a bit far still. But there are still other ways that customers used TheirStack with Clay. Mostly: * Exporting and uploading manually a CSV from TheirStack * Using the [HTTP API](https://docs.clay.com/en/articles/9672489-http-api-with-clay) function from Clay, connecting to our [API](/en/docs/api-reference) --- title: Make description: How to connect TheirStack with Slack or any other tool through Make url: https://theirstack.com/en/docs/integrations/make --- Make.com is one of the most powerful no-code platforms. It lets you connect thousands of apps without having to write any code. How to send a Slack message for every new job found [#how-to-send-a-slack-message-for-every-new-job-found] The easiest to send a Slack message for every new job found is to use a "Search", this will allow us to modify search criteria without having to update the Make Scenario. 1. Get saved search 2. Get jobs meeting saved search criteria 3. Send Slack message Make Scenario Import scenario on Make.com [#import-scenario-on-makecom] We have created a [template](https://drive.google.com/file/d/1-tv6DT4pPEPD-zIRKd1UmSnBtqOIsM8d/view) to help you configure your scenario. Click on "Import Blueprint" and import [this blueprint](https://drive.google.com/file/d/1-tv6DT4pPEPD-zIRKd1UmSnBtqOIsM8d/view). Import Blueprint Getting TheirStack API Key [#getting-theirstack-api-key] Go to [TheirStack App](https://app.theirstack.com/settings/api-key) and copy the API Key --- title: Adding a technology or job filter to your company search description: Learn how to add a technology or job filter to your search. url: https://theirstack.com/en/docs/guides/adding-technology-filter-to-search --- Beta Feature Available We now offer a new `/companies/search/domains` endpoint that's perfect for this use case and can significantly reduce your API costs. This endpoint is currently in beta. Please [contact us](mailto:hi@theirstack.com) to request access. At TheirStack, we're obsessed with helping sales intelligence platforms give their users the best data. We know that building a great company search is key to helping your users find the right companies. But to have a truly powerful company search, you need plenty of filters—and let's be honest, each data provider excels at specific data points. If you're a sales tech company that already has your own database of companies and runs searches against it, but you'd like to add technology filters to enhance your search capabilities, TheirStack is the perfect solution. TheirStack can help you add the following filters to your existing company database: * **Technologies**: A catalogue of 32k technologies to filter by technology stack * **Job postings**: A catalogue of 166M job postings to filter by hiring patterns Generic company search The optimal workflow to minimize API costs [#the-optimal-workflow-to-minimize-api-costs] When you already have a company database and want to add technology filtering, the most cost-effective approach is to leverage our new domains endpoint. Here's how it works: Let's say your user is searching for *"Companies in the US, with more than 100 employees, that use Snowflake, and raised more than $10M"*. **Run your existing filters on your own database first (optional but recommended):** Filter your company database by the criteria you already have: * `country`: US * `employee_count`: more than 100 * `raised_amount`: more than $10M This step is optional but highly recommended to avoid sending us companies that aren't in your database. If you want to show 100 results to your users, consider getting 200, 500, or even the full list of domains that match your filters from your internal database. This ensures you have enough companies to work with after our filtering. Remember: you can pass us a list as big as you want—our pricing is only based on the number of results we send back to you, not the number of domains you send us. **Call our new Company Domains API (Beta):** Pass the domains from your pre-filtered list of companies to our `/companies/search/domains` endpoint: * `company_domain_or`: list of domains from step 1 (or all your domains if you skipped step 1) * `company_technology_slug_or`: `snowflake` * `limit`: 100 (to get only the first 100 results—set this to the number of results you'll show to your users to save credits) You can also apply additional filters here to further narrow down results if needed, like job filters. The complete parameter list is available in our [API documentation](/en/docs/api-reference). **Filter your original results:** Take the domains returned by our API and filter your original company list from step 1 to show only companies whose domains appear in our response. This gives you the final list of companies that match all criteria, including technology usage. Alternative: Purchase our technographics dataset [#alternative-purchase-our-technographics-dataset] Another way to add technology filtering would be to purchase our complete technographics dataset and run queries internally. However, this approach has several drawbacks compared to the API: * **More development work**: You'll need to build infrastructure to handle an additional dataset * **Data management overhead**: You'll need to manage and store our technographics data alongside your existing company database * **Sync complexity**: We provide daily updates, but you'll need to resync your entire technographics table regularly, downloading and repopulating the full dataset * **Higher upfront costs**: This requires a significant initial investment compared to pay-as-you-go API usage * **Less flexibility**: The API approach lets you validate our data quality first and only pay for what you actually use With the API approach, you get always up-to-date information without the infrastructure overhead, and you can start small to validate the value before scaling up. Ready to get started? [Contact us](mailto:hi@theirstack.com) to request access to the beta domains endpoint, or start using our [Company Search API](/en/docs/api-reference/companies/search_companies_v1) right away. --- title: Backfilling a job board description: Learn why TheirStack is the best job board backfill solution and how to backfill a job board using webhooks url: https://theirstack.com/en/docs/guides/backfill-job-board --- What is backfilling a job board? [#what-is-backfilling-a-job-board] Backfilling a job board involves augmenting its own job listings with external postings from various sources. This integration allows job boards to present a broader array of opportunities to their users, helping to attract more traffic, boost user engagement, and ultimately enhance their overall value proposition. Why TheirStack is the best job board backfill solution [#why-theirstack-is-the-best-job-board-backfill-solution] Backfilling job boards is a common use case for our Job data platform and it was built with this in mind: * **Original job link to company website** When a job originates from a company's career page, we include the URL (`final_url`) so you can redirect users to the correct source. You can also get only jobs from career pages with the `final_url_exists` filter. * **Standardized job descriptions** Our job descriptions are standardized across all information sources in Markdown format, ensuring consistency. * **Company information** Most of our jobs are enriched with company information, so can use the company `logo`, `domain`, `industry`, `headcount`, `revenue`, `type`, `location` and technologies used for your company profile page. Additionally, media assets such as company logos are downloaded and stored in our own infrastructure, allowing you to access them reliably via stable URLs for use in your own applications. * **Up-to-date data** The data is up-to-date, with new jobs being added to our database every minute. * **Filters** If you are a niche job board, you can use the `job_title_or` filter to get specific jobs, or the company `industry_id_or` filter to get only jobs from companies in a specific industry or any of our 20+ filters. * **16k+ job data sources** so you can get a wide range of jobs from all over the world. [Learn more](/en/docs/data/job/sources) How to backfill a job board [#how-to-backfill-a-job-board] You have two options: Webhook (Recommended) [#webhook-recommended] Set up a webhook to listen for the `new.job` event. By applying the necessary filters, you can ensure that you only receive the job postings that meet your specific criteria. This approach allows you to automatically receive new job listings as soon as they are published. * Step 1 - Create a job search with your desired criteria (e.g: location, company, technology, etc). You can create as many as you want. It's important to create exclusive criteria to avoid receiving duplicate job postings. * Step 2 - Set up a webhook to listen for the `new.job` event. [How to set up a webhook](/en/docs/webhooks/how-to-set-up-a-webhook) API [#api] We strongly recommend using our [webhooks](/en/docs/webhooks) instead of the Jobs API to fetch jobs periodically. Using the Jobs API is much more complex, harder to implement and you won't have real time updates. Use our [Jobs API](/en/docs/api-reference/jobs/search_jobs_v1) to fetch jobs periodically. Check out our [Fetch jobs periodically](/en/docs/guides/fetch-jobs-periodically) guide for more details. --- title: How to fetch jobs periodically using the Jobs API description: This guide demonstrates how to fetch jobs periodically from the TheirStack API, ensuring fresh data and minimizing API costs. url: https://theirstack.com/en/docs/guides/fetch-jobs-periodically --- Important notice While the Jobs API can handle periodic fetching, we'd strongly recommend using our [webhooks](/en/docs/webhooks) instead. Webhooks are purpose-built for this use case and provide significant benefits: * They're much easier to implement and will save you valuable development time * You'll save API credits by avoiding duplicate job retrievals * You'll get real-time updates as soon as new jobs are available The Jobs API works best when triggered by user actions rather than for automatically syncing data to your database on a schedule. If you're seeing duplicate job issues, it's a strong signal that your current approach is flawed — switching to webhooks is the right move for your use case. Take a look to [How to set up a webhook](/en/docs/webhooks/how-to-set-up-a-webhook) to get started. To integrate TheirStack's job data seamlessly into your application or database, focus on the following: * [Ensure fresh data with efficient batching](#ensure-fresh-data-with-efficient-batching). * [Minimize API costs by optimizing your requests](#minimize-api-costs-by-optimizing-your-requests). * [Avoid missing any data during the integration process](#avoid-missing-any-data-during-the-integration-process). Ensure fresh data with efficient batching [#ensure-fresh-data-with-efficient-batching] We continuously monitor company websites and job boards to identify new job postings. To optimize performance, we recommend batching your requests with a maximum frequency of once every hour or two hours, based on your needs, and using the maximum limit of 500 jobs per page. Minimize API costs by optimizing your requests [#minimize-api-costs-by-optimizing-your-requests] One API Credit is consumed for each record returned from our API endpoints. If you fetch the same job multiple times, you will be charged for each fetch. The `discovered_at` field in the `job` object indicates the date and time when the job was first identified by TheirStack. To prevent duplicate charges when fetching jobs, you can filter by `discovered_at_gte` in your request to get only new jobs. This parameter will ensure that only jobs discovered after the specified date are fetched. The `discovered_at_gte` parameter is a timestamp in the format `YYYY-MM-DDTHH:MM:SSZ` and it should be the date and time of the last job you fetched. ```sql SELECT MAX(discovered_at) FROM jobs; ``` Copy the timestamp and use it as the value for `discovered_at_gte` in your request. ```bash curl --request POST \ --url "https://api.theirstack.com/v1/jobs/search" \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --header "Authorization: Bearer " \ -d '{ "offset": 0, "limit": 500, "discovered_at_gte": "2024-12-29T17:32:28Z" "job_title_or": [ "Data Engineer" ], "posted_at_max_age_days": 15, "job_country_code_or": [ "NG" ], }' ``` Another option is to use the `job_id_not` filter. You'd need to fetch the IDs of the jobs you already have in your system from us, and pass them to the Job Search Endpoint. This can be useful if you fetch jobs from multiple searches and the same job may appear in the results from more than one search. Avoid missing any data during the integration process [#avoid-missing-any-data-during-the-integration-process] If your cron process fails—whether due to system downtime, credit depletion, or connection issues—you can resume from the last processed job using the `discovered_at_gte` parameter. This ensures you fetch only the jobs discovered after the last successful run, preventing any data loss even in periodic integrations. --- title: How to Choose the Best Way to Access TheirStack Data description: Guidance to help you choose the most suitable way to access TheirStack data (App, API, Webhooks, or Datasets) for your use case, scale, and freshness needs—without prescribing a single path. url: https://theirstack.com/en/docs/guides/how-to-choose-best-way-to-access-theirstack-data --- TL;DR [#tldr] * If you're not a developer, use the [App](/en/docs/app). * If you need more than 10M records / month, use [Datasets](/en/docs/datasets). * If you want to get notified when (1) new jobs are posted or (2) new companies start using a new technology, use [Webhooks](/en/docs/webhooks). * If you want to enrich an external system on demand, use the [API](/en/docs/api-reference). Basics [#basics] * **Same data for all methods**: Every delivery method accesses the same underlying dataset and quality. * **Filtering**: All filters are available in the App, API, and Webhooks. Datasets are exported as flat files (CSV/Parquet) without server-side filtering. Delivery methods [#delivery-methods] App (UI) [#app-ui] Use the App when you want to explore, iterate, and export data without writing code. * What it’s best for * Validating data quality and fields quickly * Running ad-hoc searches and refining filters interactively * Exporting results to CSV/Excel or sending to external tools * Pricing * Uses [company credits](/en/docs/pricing/credits) * [Learn more](/en/docs/app) API (on-demand) [#api-on-demand] Use the API when you need programmatic, on-demand access for enrichment or user-triggered actions. * What it’s best for * Enriching CRM or product records when a user opens a page or clicks a button * Server-to-server lookups inside workflows (e.g., scoring, validation) * Synchronous product features that fetch data on demand * Pricing * Consumes [API credits](/en/docs/pricing/credits); pay per record returned * When not to use * If you’re polling or batching requests on a schedule, prefer Webhooks for push delivery, retries, and lower operational overhead * [Learn more](/en/docs/api-reference) Webhooks (real-time) [#webhooks-real-time] Use Webhooks when you need to ingest fresh data continuously without polling. * What it’s best for * Keeping an internal database or pipeline in sync * Triggering workflows in tools like Zapier, Make, n8n, or your services * Event-driven integrations based on saved searches * Pricing * Consumes [API credits](/en/docs/pricing/credits); pay per record returned * Learn more * [How to set up a webhook](/en/docs/webhooks/how-to-set-up-a-webhook) * [Monitor your webhooks](/en/docs/webhooks/monitor-your-webhooks) Datasets (bulk + historical) [#datasets-bulk--historical] Use Datasets when you need large-scale access for warehouses, analytics, or ML. * What it’s best for * Loading into a data warehouse or data lake (S3, BigQuery, Snowflake, etc.) * Historical analysis and model training * High-volume consumption (>10M records/month) * Pricing * Flat subscription; more cost‑efficient above \~10M records/month * Learn more * Overview: [Datasets](/en/docs/datasets) * Jobs schema and coverage: [Job data](/en/docs/data/job) * Access steps: [Obtaining access to your datasets](/en/docs/datasets/accessing-datasets) Examples [#examples] * Sales or RevOps team wants to test a new ICP and export a CSV for outreach → App (UI) * Product team needs new US tech jobs streamed into an internal DB every hour → Webhooks * Data team wants multi-year job postings for trend analysis and modeling → Datasets --- title: How to find old job postings description: Learn how to find old and expired job postings from any company. Access historical job data dating back to 2021 using TheirStack search, company lookup, API, or datasets. url: https://theirstack.com/en/docs/guides/how-to-find-old-jobs --- What are old job postings? [#what-are-old-job-postings] Old job postings are job listings that have been closed, filled, or expired. These positions are no longer available on most job boards, but they remain part of a company's recruitment history. While most job boards remove expired listings after 30-90 days, TheirStack stores all historical job data dating back to 2021, giving you access to years of recruitment history for any company. Find old job postings of a company [#find-old-job-postings-of-a-company] To find historical job postings from any company, use TheirStack's company lookup feature. Search for a company by name or domain, then view all jobs they've ever posted—including expired ones. **Click on the search box** Open [TheirStack](https://app.theirstack.com) and click on the search box in the header. Search box in TheirStack header **Search for a company** Type the company name or domain. Select the company from the dropdown results. Search results showing companies **Open the Jobs tab** In the company modal, click on the **Jobs** tab to see all jobs posted by that company. Company modal with Jobs tab **View all historical jobs** Browse all jobs ever posted by the company, including expired ones. You can filter, sort, and export the results. List of all historical jobs Learn more: [Company Lookup](/en/docs/app/company-lookup) Other ways to access historical job data [#other-ways-to-access-historical-job-data] Search jobs with date filters [#search-jobs-with-date-filters] Go to [Job Search](https://app.theirstack.com/search/jobs/new), add your filters, and use the **Date posted** filter to search for jobs from a specific time period (back to 2021). API or datasets [#api-or-datasets] * **[Jobs API](/en/docs/api-reference):** Query historical jobs with filters for date ranges, companies, technologies, and more. * **[Job datasets](/en/docs/datasets):** Download bulk historical job data in CSV format. Why access old job postings? [#why-access-old-job-postings] Historical job data is valuable for: * **Identifying hiring patterns:** Spot when and how often companies hire for certain roles to predict future hiring needs. * **Tracking company evolution:** See how a company's structure, priorities, and technology stack have changed over time. * **Mapping technology adoption:** Chart which tools, platforms, and programming languages are gaining or losing traction across industries. * **Sales prospecting:** Find companies that were recently expanding or investing in new areas—strong signals for B2B outreach. * **Competitive intelligence:** Understand which companies have hired for specific skills or roles to inform your business strategy. Data coverage [#data-coverage] TheirStack maintains historical job data from: * **Time range:** 2021 to present * **Sources:** 312k job boards, ATS platforms, and company career pages * **Countries:** 195 countries worldwide * **Total jobs:** 166M active listings, with millions more in the archive Even if a job has been removed from the original job board, it remains accessible in TheirStack. --- title: Identifying companies with problems your software solves description: Learn how to use job postings to discover companies actively hiring for tasks your software automates. Find your ideal customers by analyzing 167M job descriptions for specific pain points and manual processes. url: https://theirstack.com/en/docs/guides/how-to-identify-companies-with-problems-your-software-solves --- Why job posting reveal buyer intent [#why-job-posting-reveal-buyer-intent] Job postings serve as a transparent window into a company's current challenges and priorities. By analyzing these postings, you can uncover organizations in need of your offerings, allowing for timely and targeted outreach. In order to identify companies with a strong intention, we could look for keywords that are related to the task your software automates or helps with. Matching Job Roles and Use Cases to Your Product's Value [#matching-job-roles-and-use-cases-to-your-products-value] For example, Qonto is a fintech company that provides expense management, bank, invoicing and billing, accounting and bookkeeping tools. * When a company post a job looking for a "Bookkeeper" or "Accounting Manager", it means they have an increasing workload and need help with their accounting. If in the job description they mention "collect invoices and receipts", "expense report", "payroll processing", ... the chances that a software like Qonto that automates these tasks could help them are high. * When a company post a job looking for "Finance Manager" or "Financial Analyst", it means they have an increasing workload and need help with their financial operations. If in the job description they mention "cash flow reporting", "financial analysis", "budgeting", ... the chances that a software like Qonto that automates these tasks could help them are high. Example Keyword Mapping by Product [#example-keyword-mapping-by-product] Here's an example of how to map your product's use cases to relevant job keywords: | Product | Use cases | Keywords to search in job descriptions | | --------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Zapier (Automation) | Workflow Automation, Integration, Task Automation | workflow automation, process automation, integration management, task automation, data synchronization, API integration, automation tools, workflow optimization, process improvement, efficiency tools | | Notion (Productivity) | Project Management, Documentation, Knowledge Base | project management, documentation, knowledge base, team collaboration, task tracking, content management, wiki management, team workspace, productivity tools, workflow documentation | The key is to identify the specific tasks and responsibilities that would indicate a company needs your product's functionality. Look for keywords that describe the problems your software solves or the manual processes it automates. Steps [#steps] **Define a list keywords that represent tasks that your software automates or help with.** You can do it manually or paste the website of your product and the tool will generate keywords for you. **Open a new job search** **Paste the keywords in the job description** Case studies [#case-studies] * [Qonto uses TheirStack to detect companies with high intents](/en/blog/qonto-uses-theirstack-to-detect-companies-with-high-intents) --- title: How to monitor job postings automatically description: Learn how to automatically monitor job postings and get real-time alerts when companies post new jobs. Set up automated job tracking with webhooks to Slack, CRM, or any system. url: https://theirstack.com/en/docs/guides/how-to-monitor-job-postings-automatically --- What is automatic job monitoring? [#what-is-automatic-job-monitoring] Automatic job monitoring means getting notified the moment companies post new jobs that match your criteria—without manually checking job boards every day. Instead of refreshing LinkedIn, Indeed, or company career pages, you set up alerts once and receive notifications in real-time via Slack, email, your CRM, or any other system. Timing matters. Whether you're in sales or recruiting, being first to know about a new job posting gives you a competitive advantage. Why monitor job postings automatically? [#why-monitor-job-postings-automatically] Sales prospecting [#sales-prospecting] When a company posts a job, it signals three things: **budget**, **need**, and **timing**. A company hiring a "Data Engineer with Snowflake experience" has budget for data infrastructure. If you sell data tools, this is a warm lead. The job posting tells you exactly what they need before they even know you exist. Recruiting agencies [#recruiting-agencies] Track companies actively hiring in your specialty. When you see a new opening, you can reach out to place candidates before competitors know the role exists. IT services and consulting [#it-services-and-consulting] Job postings reveal development needs. A company hiring multiple React developers likely has a backlog of frontend work—and may consider outsourcing to move faster. Competitive intelligence [#competitive-intelligence] Monitor competitors' hiring patterns to understand their strategy. Are they scaling sales? Building a new product line? Expanding to new markets? Job postings reveal it all. How to set up automatic job monitoring [#how-to-set-up-automatic-job-monitoring] TheirStack's [webhooks](/en/docs/webhooks) let you get real-time notifications when new jobs match your criteria. Here's how to set it up: **Create a job search with your criteria** Go to [Job Search](https://app.theirstack.com/search/jobs/new) and add filters for the jobs you want to monitor: * **Job title**: e.g., "Data Engineer", "Sales Manager", "DevOps" * **Location**: Country, state, or city * **Company filters**: Industry, size, funding stage, technologies used * **Job description keywords**: Specific skills or tools mentioned **Save the search** Click the **Save** button to save your search. The search must be saved before you can create a webhook. **Create a webhook from the saved search** Click the **Webhooks** button in the top right corner of your saved search. Webhook button on saved search **Configure webhook settings** Webhook configuration modal * **Trigger once per company**: Enable this for sales workflows. You'll get one notification per company, not one per job. Perfect for outreach where you only need to know a company is hiring, not every individual role. * **Choose where to start**: * **From now on**: Only new jobs posted after you create the webhook * **All time**: Include existing jobs that already match your search, plus all future jobs * **Webhook URL**: The endpoint where you want to receive notifications (your automation tool, CRM, or custom system) **Connect to your destination** Paste the webhook URL from your destination system. TheirStack works with: * **[Make](https://www.make.com/)** - Visual automation platform with 1000+ integrations * **[Zapier](https://zapier.com/)** - Connect to 5000+ apps * **[N8N](https://n8n.io/)** - Open-source workflow automation * **Slack** - Via Make, Zapier, or direct webhook * **CRMs** (Salesforce, HubSpot) - Via automation tools or direct API * **Custom endpoints** - Any system that accepts webhooks Click "Send test event" to verify your connection works. **Wait for new jobs** Once configured, you'll receive notifications in real-time as new jobs match your criteria. Webhook details page For a detailed walkthrough, see [How to set up a webhook](/en/docs/webhooks/how-to-set-up-a-webhook). Where to send job alerts [#where-to-send-job-alerts] Slack [#slack] Get instant team notifications when relevant jobs are posted. See our guide: [How to send jobs to Slack](/en/docs/guides/how-to-send-jobs-to-slack). CRM (Salesforce, HubSpot) [#crm-salesforce-hubspot] Automatically create leads or contacts when companies post jobs matching your ICP. Use Make or Zapier to connect TheirStack webhooks to your CRM. Email [#email] Route webhook events through automation tools to send formatted email alerts to your team. Custom systems [#custom-systems] Build your own integration using the webhook payload. See [Webhook event schemas](/en/docs/webhooks/event-type/job_newjob_new_post) for the data format. Alternative: Email alerts [#alternative-email-alerts] For simpler use cases, TheirStack offers built-in email alerts without setting up webhooks: * **Daily alerts**: Fresh matches every morning * **Weekly alerts**: Summary of new jobs every Monday See [Email Alerts](/en/docs/app/saved-searches/email-alerts) to set this up. Use case examples [#use-case-examples] Sales: Monitor companies hiring for roles that use your product [#sales-monitor-companies-hiring-for-roles-that-use-your-product] If you sell a testing automation tool, monitor jobs mentioning "manual testing", "QA engineer", or "test automation". These companies have testing needs and budget. Recruiting: Track jobs in specific industries and locations [#recruiting-track-jobs-in-specific-industries-and-locations] Set up alerts for "Software Engineer" jobs in "Berlin" at "Series A-C" startups. Be the first to know when your target companies are hiring. Research: Monitor technology adoption [#research-monitor-technology-adoption] Track jobs mentioning specific technologies like "Kubernetes", "Snowflake", or "React Native" to understand market trends and identify companies adopting new tools. Data coverage [#data-coverage] TheirStack monitors job postings from: * **312k** job boards, ATS platforms, and company career pages * **195** countries worldwide * **166M** active job listings tracked New jobs are discovered and indexed continuously, so your webhooks fire as soon as we detect new postings. Further reading [#further-reading] * [Webhooks documentation](/en/docs/webhooks) - Complete webhook reference * [How to set up a webhook](/en/docs/webhooks/how-to-set-up-a-webhook) - Step-by-step guide * [How to send jobs to Slack](/en/docs/guides/how-to-send-jobs-to-slack) - Slack integration walkthrough * [Email Alerts](/en/docs/app/saved-searches/email-alerts) - Simpler alternative to webhooks --- title: Outreach companies actively hiring description: How to outreach companies actively hiring on autopilot using TheirStack url: https://theirstack.com/en/docs/guides/how-to-outreach-on-autopilot-to-companies-actively-hiring --- How to outreach companies actively hiring on autopilot Originally posted by Bjion Henry This article was first published on Bjion Henry's LinkedIn page . All credit goes to Bjion for their expertise and insights—we're big fans of their work and are sharing it here because we believe our community will benefit from their valuable content. Read the original article on Bjion Henry's LinkedIn page Introduction [#introduction] Give me 3 minutes, and I'll show you how to outreach on autopilot to companies actively-hiring... This is our 100% automated system that finds perfect clients for agencies & consultancies. Most agencies waste time outreaching to prospects who don't need help right now. But what if you could identify companies with: * ACTIVE problems they're trying to solve * BUDGET already allocated * URGENCY to find a solution That's exactly what our job board scanning system does. Steps [#steps] 1. Set up job board scanning automations [#1-set-up-job-board-scanning-automations] We use TheirStack to monitor when companies post specific job listings: * If you're a branding agency, target companies hiring graphic designers * If you're a dev shop, look for companies hiring developers * If you're a marketing agency, find brands hiring marketing reps The logic is simple but powerful: No company goes through the hassle of hiring unless they REALLY need help. And the fact they're willing to hire shows budget is already approved. This creates the perfect storm of need + resources + timing. 2. Use AI to find the right decision makers [#2-use-ai-to-find-the-right-decision-makers] Once we identify a company actively hiring, we: * Automatically pull all potential decision makers from the company * Use AI to determine who has actual buying power * Find their exact contact details (both work and personal email) * Get their phone numbers using tools like LeadMagic The system delivers a daily feed of perfect prospects who are ACTIVELY looking to solve problems YOUR agency specialises in. 3. Create hyper-personalised outreach at scale [#3-create-hyper-personalised-outreach-at-scale] No more generic "hope you're doing well" messages: * AI analyzes the exact job posting they've created * Identifies the specific challenges they're trying to solve * Crafts outreach that positions your agency as the solution * Personalises each message based on the job description * Automatically schedules and sends via SmartLeads & Lemlist Your outreach essentially says: "I see you're trying to hire for X, which means you're struggling with Y. Instead of spending months finding and training someone, we can solve this problem immediately." Why does this work? [#why-does-this-work] * Target companies with ACTIVE needs (not cold prospects) * Reach decision-makers when they're ACTIVELY seeking solutions * Position your agency as the faster alternative to hiring * Run everything on complete autopilot while you focus on clients * Scale without adding sales staff or spending hours prospecting Without any of this: [#without-any-of-this] * No more guessing which companies might need your services * No more cold outreach to prospects who aren't actively buying * No more spending hours researching contact details * No more generic templates that get ignored --- title: How to send a slack message for every new job found description: Step-by-step guide to automatically notify your team in Slack whenever new jobs are posted using TheirStack's webhook integration with Make, Zapier, or N8n. url: https://theirstack.com/en/docs/guides/how-to-send-jobs-to-slack --- Through our [Webhooks](/en/docs/webhooks) feature, you can trigger actions in any external system (CRMs, Slack, Airtable, etc). Not all systems accept webhooks, so we recommend using workflow automation tools like [Make](https://www.make.com/), [Zapier](https://zapier.com/) or [N8n](https://n8n.io/) and then levearing their integrations libraries to connect to other systems like Salesforce, Hubspot, etc. **Choose a workflow automation tool to connect to TheirStack.** * [Make](https://www.make.com/) (Generous free plan, low cost) * [N8N](https://n8n.io/) (no free plan, open source, low cost) * [Zapier](https://zapier.com/) (Good documentation and easy for beginners) For this example we will use [Make](https://www.make.com/), it's our favorite and has a generous free plan. Follow this guides to do it in [N8n](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.webhook/) or [Zapier](https://help.zapier.com/hc/en-us/articles/8496288690317-Trigger-Zaps-from-webhooks) **Get the webhook URL from Make** * Click on "Create a new scenario" * Click on "Add Webhooks module" Add webhooks module * Click on "Custom webhook" Custom webhook * Click on "Add" and then "Create webhook" Create webhook * Copy the webhook URL Webhook URL **Create a webhook that triggers an event when a new job is found** * Use the webhook URL you got from the previous step. * I recommend you sending a test event to make sure the webhook is working. **Add slack module to your Make scenario** * Click on "Add another module" and search for "Slack - Create message" Add slack module * Configure in which channel you want to send the message and the message content. Slack module configuration * Click on "Save" --- title: Spotting your competitors' next moves description: Learn how to use job postings as an early signal for competitor expansion. Track new locations, new teams, and strategic initiatives 6-18 months before they show up on maps and press releases. url: https://theirstack.com/en/docs/guides/how-to-spot-your-competitors-next-moves --- Why job postings are a leading indicator [#why-job-postings-are-a-leading-indicator] Most companies hire **before** they launch. When a competitor starts recruiting for a new region (or a new operational function), it often means they've already approved budget, picked a direction, and started executing. Job postings can surface those signals long before: * A new location appears on Google Maps * A press release comes out * Customers notice the change What to look for [#what-to-look-for] Pick a signal that maps to the “move” you care about: * **New locations**: “Store Manager — Austin”, “Site Lead — Berlin”, “Regional Sales — Nordics” * **New operations / build-out**: “Construction Project Manager”, “Real Estate Manager”, “Facilities”, “Permitting” * **New product bets**: “Applied AI”, “Security”, “Payments”, “Marketplace”, “Data Platform” The goal isn’t to read every post. It’s to detect patterns across roles + locations + timing. Steps [#steps] **Create a competitor list.** Start with a list of competitor company names (and, if you have them, their domains). You’ll use this to filter searches so you only see relevant postings. **Choose 1–2 signals to track.** For expansion tracking, focus on job titles that tend to be hired early (e.g., “Store Manager”, “Site Lead”, “Regional Sales”, “Facilities”, “Real Estate”, “Construction”). **Open a new search and add your competitor filter.** **Filter by job title and location patterns.** Add a Job title filter with your signal titles, and use location filters to highlight where they’re hiring (especially places you don’t associate with them yet). **Save the search and turn on alerts.** Run it weekly (or set alerts) so you can spot new locations and initiatives as soon as they show up, then act on them: reprioritize markets, adjust sales territories, or preempt competitive moves. --- title: Monitoring open jobs from current and past customers description: How to know which companies from a given list are actively hiring. This can help SaaS companies detect new needs of their current customers for potential upsells, and also recruitment companies to find old customers that are hiring again and could be easier to sell to than if they were completely new customers. url: https://theirstack.com/en/docs/guides/monitoring-open-jobs-from-current-and-past-customers --- The problem [#the-problem] **Are you a recruiting company?** If so, you know it is a tough industry. Every month, revenue starts at zero dollars and you have to build up your way from there. Winning new customers is hard and you hear "no" many times. However, reconnecting with former clients can often be more straightforward and successful. They already know your work and trust you. TheirStack can help you make these reconnections easier by informing you when these past clients are hiring again. **Are you a SaaS company?** In this case, long-term, net retention revenue is key to building a long-standing, healthy, compounding business. If you have NRR > 100% it means that over time you're making more money from the same customers. The way to do this is to figure out new problems your customers are having, and either build new products to solve them or help your customers solve them with your sofware in ways they weren't aware of. By digging into their job posts, one can infer the problems a company is running into. Monitoring jobs manually [#monitoring-jobs-manually] To monitor that for all your past customers, you'd have to check all the job boards and all the companies' career pages and do it regularly, at least weekly. Otherwise, jobs may already be filled, you could have lost them to a competitor or they could have solved their problem by the time you contact the company. The bigger your customer list is, the longer this process would take. And you should check out all the jobs posted, until the last page. Doing this manually is tedious and time-consuming. Yet it's important and has to be done, or you risk leaving lots of money on the table on the table if you don't do it. Monitoring which companies are hiring [#monitoring-which-companies-are-hiring] With TheirStack you can filter our worldwide jobs database by the company names and domains of your current or former clients, letting you: * See the results visually on our UI * Export the data in CSV and Excel * Get alerts sent daily or weekly to your email with all the jobs and companies found * Make the same searches via API * Send new opportunities to Slack, Hubspot, Salesforce and many more with our Make and Zapier integrations. TheirStack gives you 2 options or seeing the information * **Doing a job search:** by searching our jobs database directly, you'll see all the details of each job, including the specific sections of the job description that are relevant to you (if you're filtering by technologies or keywords in the description). Check our Job Search guide to learn more about this, and some of the most important filters you can apply. To do this, go to the Jobs section, clicking on Jobs in the navbar * **Doing a company search:** we'll group all the jobs from each company and just return a list of companies, with a small section where you can see some of the jobs found from each company. In the rest of this guide, we'll show you how to do the second option. All the job filters are available in both views. Do a company search [#do-a-company-search] To do so, follow these steps 1. Go to [app.theirstack.com](https://app.theirstack.com) and open a new company search 2. Remove the existing filters, by clicking on the X next to each filter. 3. Add a Company name filter, and then paste the names of all your past customers, one per line. Pasting company names 4. Add a Job Posting -> Date Posted filter and set it to 30, for example, to see which of the companies have posted jobs in the last 30 days. Setting date filter As you see, a new Jobs column will be shown, where you can see the jobs each company has posted. 5. To get as many matches as possible, add a Company domain filter and paste the domains or URLs of your past customer. Sometimes the name of the company in our database doesn't match exactly the name that you pass, but the domain does. As you see, if you do this the number of companies for which we found jobs almost tripled (going from 68 to 176, out of 200 companies) 6. Save the search by clicking on the Save button in the top right corner of the screen and give a name to it by clicking on its name and setting a new one. 7. (Optional) If you specialize in tech jobs, you can also add a Job title filter and paste the jobs from this guide. You'll then only see the companies hiring tech profiles. --- title: Integration guide for sales intelligence software description: This guide provides detailed instructions on integrating TheirStack into your product, including all possible connectors, marketing content and best practices. url: https://theirstack.com/en/docs/guides/sales-software-integration-guide --- Are you a sales intelligence platform like Clay, Databar, or Trigify? We've compiled everything you need to seamlessly integrate TheirStack as a source of job data and technographics into your product. This is a dynamic, evolving guide that improves with each integration. Your feedback and suggestions are always welcome! Introduction [#introduction] At TheirStack, we are passionate about building long-term partnerships with sales intelligence platforms. Our goal is to become the largest, most reliable, and fastest-responding job and technographics database. Everything we do is driven by this vision. If you're seeking top-quality job and technographic data, we're the ideal partner for you. Why TheirStack is the right partner for you [#why-theirstack-is-the-right-partner-for-you] * **Coverage**: * Job data: 312k+ job data sources, 30+ advanced job and company filters, worldwide coverage. [(learn more).](/en/docs/data/job) * Technographics data: 32k technologies and 10M companies. [Learn more](/en/docs/data/technographic) * **API designed for you**: * Use our [API Preview mode](/en/docs/api-reference/features/preview-data-mode) to show a preview to your end users. * Use our [Free count](/en/docs/api-reference/features/free-count) to estimate the number of records that match your search criteria with no credits consumption. * **Pricing Flexibility**: * We know estimating your consumption is hard, with us you don't need to worry about it. You can start with a low volume of credits and increase it as your users need more data. No commitment, cancel anytime, and you can enable a [auto recharge rule](/en/docs/pricing/auto-recharge-credits) to avoid running out of credits. * Learn how our API pricing works [here](/en/docs/pricing/credits#api-credits) Use cases [#use-cases] TheirStack allow you to build different features in your platform: | **Type** | **Features** | | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **On-Demand Actions (API)**

When your users actively request information | **List Building**
- Find jobs
- Find companies by tech stack or job data

**Enrichment**
- Get the tech stack of a company
- Get all jobs posted by a company | | **Real-Time Signals (Webhooks)**

Trigger workflows when an event occurs | - Monitor new jobs
- Detect companies adopting new technologies
- Detect when the tech stack of a company changes | Features [#features] List building [#list-building] The list building category are all the features that start from a colection of filter and return a list of records (jobs or companies) Find jobs [#find-jobs] Use [Job Search API endpoint](/en/docs/api-reference/jobs/search_jobs_v1) to build this feature. Recommended filters sorted by importance: | # | Filter Name | Description | API Field(s) | | -- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------ | | 1 | Days since posted (required) | Number of days since the job was posted (default: 30 days) | `posted_at_max_age_days` | | 2 | Job titles to include | Keywords to include in the job title | `job_title_or` | | 3 | Job titles to exclude | Keywords to exclude from the job title | `job_title_not` | | 4 | Job description keywords include | Keywords to include in the job description | `job_description_contains_or` | | 5 | Job description keywords exclude | Keywords to exclude from the job description | `job_description_pattern_not` | | 6 | Job country | Countries to include | `job_country_code_or` | | 7 | Job location | Cities or states to include | `job_location_pattern_or` | | 8 | Job technologies | Technologies mentioned in the job description (see [Technology Catalog](/en/docs/api-reference/catalog/get_catalog_technologies_v0)) | `job_technology_slug_or` | | 9 | Remote | Whether the job is remote (yes/no) | `remote` | | 10 | Anual salary | Anual salary of the job post | `min_annual_salary_usd`, `max_annual_salary_usd` | | 11 | Has hiring manager | Whether the job lists a hiring manager (yes/no) | `only_jobs_with_hiring_managers` | | 11 | Company domain | Company website URL(s) | `company_domain_or`, `company_domain_not` | | 12 | Company name | Name(s) of the company | `company_name_or`, `company_name_not` | | 13 | Company industry | Industry(s) of the company (see [Industry Catalog](/en/docs/api-reference/catalog/get_industries_v0)) | `company_industry_id_or` | | 14 | Company headcount | Number of employees (min and max) | `employee_count_min`, `employee_count_max` | | 15 | Company headquarters country | Company headquarters country codes | `company_country_code_or` | | 16 | Company technologies | Technologies used by the company (see [Technology Catalog](/en/docs/api-reference/catalog/get_catalog_technologies_v0)) | `company_technology_slug_or`, `company_technology_slug_and`, `company_technology_slug_not` | Marketing content to help your users understand this action: Find job postings across multiple platforms (LinkedIn, Indeed, Workable, etc.) and apply over 25 filters to refine results by job role, company, and tech stack details. **Overview** Launch a comprehensive search on LinkedIn, Indeed, Glassdoor, and more than 16 other job sites. Maximize your reach and efficiency by targeting a broad spectrum of opportunities from the start. Refine your search with advanced filters: * Job filters: job title, keywords in the job description, salary ranges, technology, hiring managers… * Company filters: Industry, size, location, funding, revenue, technology usage, etc. **Common searches** Searching for jobs can be used by job seekers, but also many sales and marketing teams use it to find potential customers. Here are some searches that could be done: * Search for jobs filtering by the country of the job * Search for jobs filtering by job title * Search for jobs filtering by technologies mentioned in the job * Search for jobs filtering by job description * Search for jobs filtering by company domain * Search for jobs within a specific date range **Common use cases** Job posting data use cases are unlimited: lead generation, cross-selling and marketing campaigns. * Discover companies hiring. Harness the power of job data to identify potential clients by scanning over 40 million job listings in more than 195 countries. Target companies facing challenges that your offerings can address, turning job market insights into valuable sales opportunities. * Monitor your customers. Stay ahead with real-time notifications when your current or previous clients start hiring again. Leverage this data to spot upsell opportunities and re-engage with past customers, ensuring you maximize lifetime value and maintain strong client relationships. * Target companies hiring specific positions. Boost your sales with targeted LinkedIn advertising campaigns. Focus your ads on individuals at companies actively hiring for positions that match your services. By aligning your marketing efforts with real-time job data, you can ensure your message reaches the right audience, enhancing engagement and conversion rates. Find companies by tech stack [#find-companies-by-tech-stack] Use [Company Search API endpoint](/en/docs/api-reference/companies/technographics_v1) to build this feature. Recommended filters sorted by importance: | Order | Filter | Description | API Field | | ----- | ---------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | | 1 | Technologies used | Show logo, name, short description (one\_liner), category, and number of companies. | `company_technology_slug_or`, `company_technology_slug_and`, `company_technology_slug_not` | | 2 | Company headquarters country | Options to include or exclude countries. | `company_country_code_or`, `company_country_code_not` | | 3 | Industry | Options to include or exclude industries. | `industry_or`, `industry_not` | | 4 | Company headcount | Specify minimum or maximum employee count, with options for null values. | `min_employee_count`, `max_employee_count`, `min_employee_count_or_null`, `max_employee_count_or_null` | | 5 | Company revenue | | N/A | | 6 | Company type | | N/A | | 7 | Company location | | N/A | | 8 | Company website | | N/A | Use the following content to help your users understand this action. Find companies by the technology they use. **Overview:** Discover companies using any of our 32k technologies, including programming languages, databases, tools, SaaS, CRMs, and ERPs. Our comprehensive tracking allows you to pinpoint organizations by their tech stack, offering a strategic edge in market analysis and outreach. Leveraging job postings as a primary source, we meticulously track and reveal the internal tools that power companies globally, offering an unmatched depth of technographic intelligence. **Common use cases:** Sales and marketing teams often use this endpoint to find potential customers or gather market intelligence. Here are some example searches: * Find companies using particular technology: Salesforce, Clickhouse, Salesforce… * Find companies using a technology category: CRM, ERP, Database, Big Data, Cloud… **The most reliable technology usage source:** * Assured Accuracy: For each technology identified, we assign a confidence rating reflecting its data precision. This rating incorporates variables such as the frequency of technology mentions in job listings, the recency of these mentions, the diversity of its usage across companies, and its prevalence within specific categories. * Transparency and Validation: Gain direct access to our data sources. We facilitate verification by linking directly to the job postings that reference the technology, alongside details about the posting company and the date. This ensures you can trust and validate the data's accuracy. * Always Up-to-Date: Our platform is refreshed every 24 hours, guaranteeing that you have access to the most current data available. Stay ahead with real-time updates and insights. Enrichment [#enrichment] Get the tech stack of a company [#get-the-tech-stack-of-a-company] Use [Technographics API endpoint](/en/docs/api-reference/companies/technographics_v1) to build this feature. Recommended filters sorted by importance: | Order | Filter | Description | API Field | | ----- | ----------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | | 1 | Company website | Website of the company you want to get the technology list | `company_domain` | | 2 | Confidence level | Return only technologies with a confidence level of high, medium or low. | `confidence_level` | | 3 | Technologies used | Show logo, name, short description (one\_liner), category, and number of companies. | `company_technology_slug_or`, `company_technology_slug_and`, `company_technology_slug_not` | Marketing content to help your users understand this action: Lists all technologies used by a company or group of companies. For each technology, it returns the confidence level (low, medium, high), the number of jobs that mention the technology, and the first and last dates it was mentioned. **Overview** Lists all technologies used by a company or group of companies. For each technology, it returns the confidence level (low, medium, high), the number of jobs that mention the technology, and the first and last dates it was mentioned. **Common use cases:** Sales and marketing teams use this endpoint to: * Identifying the technologies used by a company or a group of companies * Finding all the technologies that belong to a certain category (such as databases, CRMs, programming languages, etc.) mentioned in the jobs of a company, and identifying the confidence level of the detection to infer the most likely one that is used by the company. * Identifying if a company uses one or several technologies from a list of technologies that you are interested in. Get all jobs posted by a company [#get-all-jobs-posted-by-a-company] Use [Job Search API endpoint](/en/docs/api-reference/jobs/search_jobs_v1) to build this feature. Same filters as the [Find jobs](#find-jobs) action but excluding the `company_domain` filter. Marketing content to help your users understand this action: Find job openings for a company using its domain or LinkedIn URL. Jobs are discovered in real time across 312k+ sources (LinkedIn, Indeed, Seek, Naukri, Workable, Join, etc.) with access to three years of historical data. A maximum of 20 job jobs will be returned. Integration page [#integration-page] Most sales intelligence software have a page where they list all data sources they have. This is the content we recommend you to add to this page to help your users understand what TheirStack is and how it can help them. TheirStack is the largest job posting and technographics database. What is TheirStack? TheirStack is the largest job posting and technographics database, empowering sales teams to uncover opportunities through real-time technographic and hiring signals. We process over 316k jobs per day from 312k sources and track 32k technologies across 10M companies. **The best job data platform** TheirStack goes beyond simple scrapers, we're a sophisticated platform delivering the most precise and current job market information. Our systems continuously collect new job postings across the internet every minute, processing approximately 316k new positions daily. * **312k+ job data sources** including job boards, company websites, and applicant tracking systems. We excel at standardizing job information, eliminating duplicates between sources, and implementing thorough quality checks to maintain data accuracy and reliability. Data quality and freshness are at the core of what we do. * **30+ advanced job and company filters** to precisely target your search needs. Beyond standard filters like job title, company, and location, we enable filtering by job description, hiring manager, and company details. Each job listing is enhanced with company information including revenue, industry, size, technology stack, and more. * **Fast and reliable API** With an average API response time of just 1.5 seconds. We serve enriched data directly from our database without real-time external calls, ensuring consistent, reliable responses that help you deliver excellent user experiences to your customers. **The best technographic database** We infer technology usage from millions of jobs worldwide. Our catalog of more than 32k technologies and 10M companies is the largest in the world. * **Assured Accuracy**. For each technology identified, we assign a confidence score reflecting its data precision. This score incorporates variables such as the frequency of technology mentions in job listings, the recency of these mentions, the diversity of its usage across companies, and its prevalence within specific categories. * **Transparency and Validation**. Gain direct access to our data sources. We facilitate verification by linking directly to the job postings that reference the technology, alongside details about the posting company and the date. This ensures you can trust and validate the data's accuracy. * **Always Up-to-Date**. Our platform receives new technographic signals every minute, ensuring you always have access to the latest data. Data freshness is at the core of what we do. --- title: Cookies Policy description: Cookies Policy for TheirStack url: https://theirstack.com/en/docs/legal/cookies-policy --- TheirStack is the commercial name under which THEIRSTACK SL manages the website [www.TheirStack.com](http://www.theirstack.com/) and all its properties, utilizes cookies to enhance online user experience (just like nearly every other website on the Internet today). Below, you will see detailed information about what types of cookies TheirStack uses, how to disable these cookies, and also how to disable third-party cookies. If you cannot find the specific information that you are looking for or if you have any questions or concerns, please feel free to contact us anytime at the email address [hi@theirstack.com](mailto:hi@theirstack.com) Who is responsible for the processing of your data? [#who-is-responsible-for-the-processing-of-your-data] **Name:** Xoel López Barata **E-mail:** [hi@theirstack.com](mailto:hi@theirstack.com) What are cookies and why does TheirStack use them? [#what-are-cookies-and-why-does-theirstack-use-them] Cookies are small text files that are generated by the website that you are viewing, allowing the website to store information as you navigate web pages. These text files contain session data that can be useful to improve your browsing experience. All of the cookies used by TheirStack are safe for your computer and they only store information that is used by the browser. These cookies cannot execute code and cannot be used to access content on your computer. Many of these cookies are necessary to ensure the proper functioning of the website. They do not contain malware or viruses. Other cookies improve user experience by storing site preferences, language preferences, as well as information about previously viewed content. This information is stored by cookies and used to enhance user experience, such as identifying and resolving errors and navigation problems What types of cookies does TheirStack use? [#what-types-of-cookies-does-theirstack-use] To enhance our understanding of your interaction with our Sites, we may use cookies and an IP tracking code to collect data for statistical purposes, including: date of first visit, number of visits, date of last visit, URL, domain, browser, and screen resolution. Cookies, by themselves, do not tell us any personally identifiable information other than your IP address, however they may store personal data that you provide us via the web forms. We may use these cookies to recognize you by name, to recognize our registered Application Providers, or to guarantee that users that click out to our partners’ Sites are not counted more than once in a 24 hours period. You may voluntarily de-activate and/or eliminate cookies by following your Internet browser’s instructions. We may partner with third-party ad networks to either display advertising on our Web site or to manage our advertising on other websites. Our ad network partners use cookies and Web beacons to collect non-personally identifiable information about your activities on this and other Websites to show you targeted advertising based on your interests. We may partner with third-party data providers to match IP addresses with company names and contact names. Our data partners may use cookies and Web beacons for the purpose of matching IP addresses. How can a user block or eliminate these cookies? [#how-can-a-user-block-or-eliminate-these-cookies] You can allow, eliminate, or block cookies in your computer's configuration settings according the internet browser you are using. In certain cases, some web services will be blocked when certain cookies are not allowed to operate correctly or when they are blocked by the consumer. These links explain how to deactivate or block cookies in common web browsers: * [Chrome](https://support.google.com/chrome/answer/95647?co=GENIE.Platform%3DDesktop\&hl=en) * [Microsoft Edge](https://support.microsoft.com/en-us/help/17442/windows-internet-explorer-delete-manage-cookies) * [Safari](https://support.apple.com/en-us/HT201265) * [Firefox](https://support.mozilla.org/en-US/kb/delete-cookies-remove-info-websites-stored) * [Opera](http://www.opera.com/help/tutorials/security/cookies) * [Android](https://support.google.com/chrome/answer/95647?co=GENIE.Platform%3DAndroid\&hl=en-GB\&oco=1) --- title: Data Processing Addendum description: undefined url: https://theirstack.com/en/docs/legal/dpa --- THIS DATA PROCESSING ADDENDUM ("**DPA**") is made between THEIRSTACK SL with offices at Sor Joaquina, 2, 15011 A Coruña, Spain ("**TheirStack**"), and the Customer identified in the Order Form. This DPA is incorporated into and made subject to the TheirStack Terms of Service or any other written agreement between TheirStack and Customer that governs Customer's use of the Services (as defined below) (the "**Agreement**"). BACKGROUND [#background] 1. TheirStack provides a technographic and job posting data platform ("**Services**") to the Customer under the Agreement. In connection with the Services, TheirStack processes certain personal data in respect of which Customer or any Customer Affiliate (as defined below), or customers of Customer or its Affiliates, may be a data controller under the Data Protection Laws (as defined below). 2. Customer and TheirStack have agreed to enter into this DPA in order to establish their respective responsibilities under the Data Protection Laws. 3. All capitalized terms used in this DPA but not otherwise defined have the meaning ascribed to them in the Agreement. 1. DEFINITIONS [#1-definitions] 1.1 For purposes of this DPA, the following initially capitalized words have the following meanings: 1. "**Adequate Country**" means a country or territory that is recognized under applicable Data Protection Laws from time to time as providing adequate protection for personal data. 2. "**Affiliate**" means any person, partnership, joint venture, corporation or other form of venture or enterprise, domestic or foreign, including subsidiaries, which directly or indirectly Control, are Controlled by, or are under common Control with a party. "**Control**" means the possession, directly or indirectly, of the power to direct or cause the direction of the management and operating policies of the entity in respect of which the determination is being made, through the ownership of more than fifty percent (50%) of its voting or equity securities, contract, voting trust or otherwise. 3. "**TheirStack Platform**" means the computer software applications, tools, application programming interfaces (APIs), databases, and connectors provided by TheirStack as its technographic and job posting data platform as a service offering, together with the programs, networks and equipment that TheirStack uses to make such platform available to its customers. 4. "**Authorized Affiliate**" means any of Customer's Affiliate(s) which (a) is subject to the data protection laws and regulations of the European Union, the European Economic Area, their member states, Switzerland, and/or the United Kingdom, and (b) is permitted to use the Services pursuant to the Agreement between Customer and TheirStack, but has not signed its own Sales Order with TheirStack and is not a "Customer" as defined under this DPA. 5. "**Customer**" means the entity that executed the Agreement, together with its Affiliates (for so long as they remain Affiliates) that have signed Sales Orders with TheirStack. 6. "**Customer Data**" means any data that Customer or its Users input into the TheirStack Platform for Processing as part of the Services, including any Personal Data forming part of such data. 7. "**Data Protection Laws**" means all laws and regulations in any relevant jurisdiction applicable to the DPA, the Agreement, or the processing of Personal Data, including laws and regulations of the European Union, the European Economic Area, their member states, Switzerland, and/or the United Kingdom and California, including (where applicable) (i) the California Consumer Privacy Act ("CCPA"), as amended by the California Privacy Rights Act ("CPRA"), (ii) the General Data Protection Regulation (Regulation (EU) 2016/679) ("GDPR"), (iii) the Swiss Federal Act on Data Protection; (iv) the UK Data Protection Act 2018; and (v) the Privacy and Electronic Communications (EC Directive) Regulations 2003; in each case, as updated, amended or replaced from time to time. 8. "**GDPR**" means the General Data Protection Regulation (Regulation (EU) 2016/679) ("EU GDPR") and the EU GDPR as it forms part of the law of England and Wales by virtue of section 3 of the European Union (Withdrawal) Act 2018 (the "UK GDPR") (together, collectively, the "GDPR"). 9. "**Personal Data**" means Customer Data consisting of any information relating to (i) an identified or identifiable natural person and, (ii) an identified or identifiable legal entity (where such information is protected similarly as personal data or personally identifiable information under applicable Data Protection Laws). 10. "**Standard Contractual Clauses**" or ("**SCCs**") means the standard contractual clauses annexed to the European Commission's Implementing Decision 2021/914 of 4 June on standard contractual clauses for the transfer of personal data to third countries pursuant to Regulation (EU) 2016/679 of the European Parliament and of the Council ("**EU SCCs**"). 11. "**Processing**", "**data controller**", "**data subject**", "**supervisory authority**" and "**data processor**" have the meanings ascribed to them in the GDPR. 2. STATUS OF THE PARTIES [#2-status-of-the-parties] 2.1 The type of Personal Data processed pursuant to this DPA and the subject matter, duration, nature and purpose of the processing, and the categories of data subjects, are as described in **Annex A**. 2.2 In respect of the parties' rights and obligations under this DPA regarding the Personal Data, the parties acknowledge and agree that Customer is the Data Controller and TheirStack is the Data Processor. TheirStack agrees that it will process all Personal Data in accordance with its obligations pursuant to this DPA. 2.3 As between the parties, Customer is solely responsible for obtaining, and has obtained or will obtain, all necessary consents, licenses and approvals for the processing, or otherwise has a valid legal basis under Data Protection Laws for the Processing of Personal Data. Without limiting the foregoing, each of Customer and TheirStack warrant in relation to Personal Data that it will comply with (and will ensure that any of its personnel comply with), the Data Protection Laws applicable to it. 3. THEIRSTACK OBLIGATIONS [#3-theirstack-obligations] 3.1 **Instructions**. TheirStack will only process the Personal Data in order to provide the Services and will act only in accordance with the Agreement and Customer's written instructions. The Agreement, this DPA, and Customer's use of the TheirStack Platform's features and functionality, are Customer's written instructions to TheirStack in relation to the processing of Personal Data. 3.2 **Contrary Laws**. If the Data Protection Laws require TheirStack to process Personal Data other than pursuant to Customer's instructions, TheirStack will notify Customer prior to processing (unless prohibited from so doing by applicable law). 3.3 **Infringing Instructions**. TheirStack will immediately inform Customer if, in TheirStack's opinion, any instructions provided by Customer under Clause 3.1 infringe the GDPR or other applicable Data Protection Laws. 3.4 **Appropriate Technical and Organizational Measures**. Taking into account the state of the art, the costs of implementation and the nature, scope, context and purposes of processing, TheirStack will implement appropriate technical and organisational measures to ensure a level of security appropriate to the risks that are presented by the processing, in particular from accidental or unlawful destruction, loss, alteration, unauthorised disclosure of, or access to Personal Data in TheirStack's possession or under its control. Such measures include security measures equal to or better than those specified in **Annex B** below. 3.5 **Confidentiality**. TheirStack will ensure that any person who has access to Personal Data has committed to confidentiality or is under an appropriate statutory obligation of confidentiality. 3.6 **Sub-processors**. Customer provides general authorization for TheirStack to engage sub-processors to process Personal Data, provided that TheirStack: (a) provides at least 30 days' prior written notice of the addition of any new sub-processor; (b) ensures that every sub-processor is bound by a written agreement that requires the sub-processor to provide at least the same level of data protection as is required by this DPA; and (c) remains fully liable for the performance of each sub-processor. Customer may object to TheirStack's appointment of a new sub-processor by notifying TheirStack in writing within 30 days of such notice, provided that such objection is based on reasonable grounds relating to data protection. 3.7 **Data Subject Rights**. TheirStack will assist Customer in responding to requests for exercising the data subject's rights under the Data Protection Laws by implementing appropriate technical and organisational measures, insofar as this is possible, taking into account the nature of the processing. 3.8 **Data Breach Notification**. TheirStack will notify Customer without undue delay after becoming aware of any accidental or unlawful destruction, loss, alteration, unauthorised disclosure of, or access to Personal Data processed by TheirStack on behalf of Customer ("**Personal Data Breach**"). TheirStack will provide Customer with sufficient information to allow Customer to meet any obligations to report or inform data subjects of the Personal Data Breach under the Data Protection Laws. 3.9 **Data Protection Impact Assessment**. TheirStack will provide reasonable assistance to Customer with any data protection impact assessments, and prior consultations with supervisory authorities or other competent data protection authorities, which Customer reasonably considers to be required by article 35 or 36 of the GDPR or equivalent provisions of other Data Protection Laws. 3.10 **Records of Processing**. TheirStack will maintain records of all categories of processing activities carried out on behalf of Customer, containing the information specified in Article 30(2) of the GDPR. 4. CUSTOMER OBLIGATIONS [#4-customer-obligations] 4.1 **Instructions and Compliance**. Customer will ensure that its instructions comply with Data Protection Laws. Customer will have sole responsibility for the accuracy, quality, and legality of Personal Data and the means by which Customer acquired Personal Data. 4.2 **Data Subject Rights**. Customer will be responsible for complying with any data subject request, and will not disclose TheirStack's confidential information to any data subject or third party. 4.3 **Data Transfers**. If Personal Data is transferred outside the EEA, Customer acknowledges that TheirStack will process such Personal Data in accordance with the safeguards set out in Section 6 below. 5. INTERNATIONAL TRANSFERS [#5-international-transfers] 5.1 **Cross-Border Transfers**. TheirStack may transfer Personal Data to, and process Personal Data in, countries other than the country in which the Personal Data was collected, including countries that may not have been deemed to provide an adequate level of protection by the European Commission or other relevant supervisory authority. 5.2 **Safeguards**. For transfers of Personal Data subject to the GDPR from the EEA to countries that have not received an adequacy decision from the European Commission, the parties will ensure that appropriate safeguards are in place. Where such transfers occur, the Standard Contractual Clauses will apply, as detailed in **Annex C**. 6. AUDIT RIGHTS [#6-audit-rights] 6.1 **Audit Rights**. Customer may, no more than once per year, during normal business hours and with reasonable prior notice, conduct an audit of TheirStack's compliance with this DPA. Customer may also request information regarding TheirStack's compliance with this DPA. TheirStack will provide reasonable cooperation and assistance in relation to such audits. 6.2 **Third-Party Audits**. Customer acknowledges that TheirStack undergoes regular third-party security audits and certifications. Upon request, TheirStack will provide Customer with copies of relevant audit reports or summaries thereof. 7. TERM AND TERMINATION [#7-term-and-termination] 7.1 **Term**. This DPA will remain in effect until the termination of the Agreement. 7.2 **Data Return and Deletion**. Upon termination of the Agreement, TheirStack will, at Customer's choice, return or delete all Personal Data in its possession or control, except where TheirStack is required by law to retain copies of Personal Data. 7.3 **Survival**. The provisions of this DPA will survive termination of the Agreement to the extent necessary to comply with Data Protection Laws. 8. LIABILITY AND INDEMNIFICATION [#8-liability-and-indemnification] 8.1 **Liability**. Each party's liability under this DPA will be subject to the limitations and exclusions set out in the Agreement. 8.2 **Indemnification**. Customer will indemnify, defend and hold harmless TheirStack from and against all claims, costs, damages, losses, liabilities and expenses arising out of or in connection with any breach of this DPA by Customer. 9. MISCELLANEOUS [#9-miscellaneous] 9.1 **Amendments**. This DPA may only be amended in writing signed by both parties. 9.2 **Governing Law**. This DPA will be governed by and construed in accordance with the laws specified in the Agreement. 9.3 **Severability**. If any provision of this DPA is held to be invalid or unenforceable, the remaining provisions will continue in full force and effect. *** ANNEX A - PROCESSING DETAILS [#annex-a---processing-details] **Categories of data subjects whose personal data is processed:** * End users or individuals purporting to be end users of Customer's applications or services * Employees, consultants, agents and representatives of companies in TheirStack's database * Customer's employees, consultants, agents and representatives authorized to use the Services * Individuals whose personal data is contained in job postings collected by TheirStack **Categories of personal data processed:** * Contact information (names, job titles, email addresses, LinkedIn profiles) * Professional information (employment history, skills, qualifications) * Company affiliation information * Any other personal data that Customer uploads to or accesses through the TheirStack Platform **Sensitive data processed:** None intentionally, although job postings may occasionally contain sensitive personal data which is processed only to the extent necessary to provide the Services. **Frequency of transfer:** Continuous during the term of the Agreement. **Nature of processing:** TheirStack provides a technographic data platform that analyzes job postings and company information to create business intelligence about technology adoption and usage patterns. TheirStack processes Personal Data to: * Provide access to company and job posting databases * Generate analytics and insights about technology adoption * Enable Customer to search and filter data * Provide API access to data * Maintain and improve the Services **Purpose of processing:** The processing is necessary for the provision of the TheirStack Services to Customer and the performance of TheirStack's obligations under the Agreement. **Retention period:** Personal Data will be retained for the duration of the Agreement and as necessary to provide the Services, unless earlier deletion is required by applicable law or requested by Customer. *** ANNEX B - SECURITY MEASURES [#annex-b---security-measures] **Infrastructure Security:** * TheirStack hosts its services in secure, geographically distributed data centers operated by leading cloud providers (AWS) * Automated monitoring systems detect failure conditions and trigger failover mechanisms * Regular backups are performed **Access Controls:** * Role-based access control with principle of least privilege * Regular access reviews and automatic deprovisioning of unused accounts * Encrypted communications for all administrative access **Data Protection:** * Encryption in transit using TLS 1.2 or higher for all data transmissions * Encryption at rest for all databases and storage systems * Logical data isolation between customer environments * Secure key management with regular key rotation **Network Security:** * Web application firewall and DDoS protection * Intrusion detection and prevention systems * Network segmentation and micro-segmentation * Regular vulnerability scanning and penetration testing **Application Security:** * Secure software development lifecycle (SDLC) practices * Code review requirements for all changes * Regular security testing and vulnerability assessments * Automated security scanning in CI/CD pipelines **Monitoring and Incident Response:** * 24/7 security monitoring and alerting * Incident response plan and procedures * Regular security training for all personnel * Annual third-party security audits **Compliance:** * Regular compliance assessments * Privacy by design principles in system architecture * Data minimization and purpose limitation controls *** ANNEX C - STANDARD CONTRACTUAL CLAUSES [#annex-c---standard-contractual-clauses] **DATA EXPORTER:** * Name: \[Customer Name] * Address: \[Customer Address] * Contact person: \[Customer Contact] * Role: Controller **DATA IMPORTER:** * Name: THEIRSTACK SL * Address: Sor Joaquina, 2, 15011 A Coruña, Spain * Contact person: Legal Team, hi @ theirstack.com * Role: Processor **DESCRIPTION OF TRANSFER:** As detailed in Annex A above. **COMPETENT SUPERVISORY AUTHORITY:** Spanish Data Protection Authority (Agencia Española de Protección de Datos) --- title: GDPR description: Ensuring GDPR compliance, TheirStack.com prioritizes lawful data processing, transparency, data minimization, robust security, and respect for individual rights. Our practices include regular audits to maintain the highest standards of data protection and privacy. url: https://theirstack.com/en/docs/legal/gdpr --- At TheirStack, we prioritize the privacy and data protection rights of individuals. We are committed to ensuring that our job scraping practices are fully compliant with the General Data Protection Regulation (GDPR). Our approach to data scraping is governed by the following principles: 1. **Lawful Basis for Processing:** TheirStack.com only scrapes job data where there is a legitimate interest or other lawful basis, as permitted under GDPR. We obtain consent where necessary and ensure that our practices are transparent and fair. 2. **Transparency and Fairness:** We are dedicated to clear and open communication about our data collection processes. Our privacy notice and policy detail our scraping activities and explain how the data will be used, ensuring that users are well-informed. 3. **Data Minimization:** We adhere to the principle of data minimization by collecting only the information necessary for the purpose of providing accurate and relevant job listings. We avoid gathering excessive personal information that is not pertinent to the job postings. 4. **Data Security:** Protecting the data we collect is paramount. TheirStack.com employs robust security measures to safeguard the data from unauthorized access, breaches, and other security threats. 5. **Data Subject Rights:** We respect the rights of individuals as outlined in the GDPR. This includes the right to access, rectify, and erase their personal data. We provide mechanisms for individuals to easily exercise these rights. 6. **Regular Audits and Compliance Checks:** To maintain our commitment to GDPR compliance, TheirStack.com conducts regular audits of our scraping activities. We continuously review and update our practices to ensure they remain aligned with GDPR requirements and reflect any regulatory changes. By adhering to these principles, we ensure that our job scraping practices are conducted responsibly and in full compliance with GDPR, upholding the highest standards of data protection and privacy. --- title: Privacy Policy description: Privacy Policy for TheirStack url: https://theirstack.com/en/docs/legal/privacy-policy --- This is the Privacy Policy of the [TheirStack.com](https://theirstack.com) [](https://asgard.ai/)website and any affiliated software and mobile applications (collectively, the “Platform”), operated by THEIRSTACK SL(together with our affiliates and subsidiaries, “TheirStack”, “we”, “us”, “our” and terms of similar meaning) and our related products and services (collectively, the “Service” or “Services”). It describes the information that we collect as part of the normal operation of our Platform, and how we use and disclose this information. All of the different forms of data, content, and information described below are collectively referred to as “information.” The Information We Collect And Store [#the-information-we-collect-and-store] We collect Business Information: [#we-collect-business-information] TheirStack creates profiles of business people and companies (”Business Information”) from different data sources that we make available to the users of the Platform. Business Information that may be provided includes company information that may include company financial data, company business sector, technologies used by the company, ongoing or planned projects in the company, or any information made available to the public by the company. Business Information may also include contact information of the company representatives (name, job title, company department, and LinkedIn URL). We obtain the data needed to gather this Business Information in several ways: (i) by scanning the web and gathering publicly-available information (company website, company press releases, company jobs, company LinkedIn site or any other material made available to the public by the company or its representatives) (ii) through market research surveys conducted by our in-house research team (iii) by licensing information from other third-party companies We may collect and store Customer Information when running our Service: [#we-may-collect-and-store-customer-information-when-running-our-service] Information You Provide.  We may collect personal information that can be used to contact or identify you and may include information such as an individual’s name, email address, mailing address, telephone number, and payment or bank account details (“Personal Information”). When you register an Account, we may collect some Personal Information, such as your name, your phone number, a credit card or other billing information, your email address, and postal addresses. The Site may allow you to link your Third-Party Accounts. We may use OAuth (as defined below), if available, to access Third-Party Accounts in order to limit our collection of your passwords. “OAuth” is an open protocol for authorization, commonly used as a way for users to log in to sites using their accounts with third-party services, such as Google, but without exposing their third-party-service passwords to such sites. For a Third-Party Account that does not support OAuth, we will ask for your login credentials for such Third-Party Account, which may include your email address and password. In all cases, we may collect your name and email address and the names and email addresses of your email contacts, subject to the terms of this Privacy Policy. If you create an Account using your login credentials from one of your Third-Party Accounts, we may access and collect your name and email address, and other Personal Information that your privacy settings on the Third-Party Account permit us to access, subject to the terms of this Privacy Policy. When you use the Service, we may automatically record information from your Device, its software, and your activity using the Services. This may include the Device’s Internet Protocol (“IP”) address, browser type, the web page visited before you came to our website, information you select or search for on our website, locale preferences, identification numbers associated with your Devices, your mobile carrier, date and time stamps associated with transactions, system configuration information, metadata concerning your files, and other interactions with the Service. We also use technologies such as cookies, JavaScript, local storage (as defined below), pixel tags, and scripts to collect information, provide a better user experience, and improve our Services. A cookie is a small data file that we transfer to your Device. We may use “persistent cookies” to save your registration ID and login password for future logins to the Service. We may use “session ID cookies” to enable certain features of the Service, to better understand how you interact with the Service, and to monitor aggregate usage and web traffic routing on the Service. You can instruct your browser, by changing its options, to stop accepting cookies or to prompt you before accepting a cookie from the websites you visit. If you do not accept cookies, however, you may not be able to use all aspects of the Service. “Local storage” is a way for a website to collect and store information “locally” (e.g., on the user’s device rather than on the website’s server) and then later retrieve it again. Local storage includes “localStorage” and “sessionStorage.” By using local storage, a user’s visits can, for example, be stored on their own computer, counted, and then given to us. How We Use Personal Information [#how-we-use-personal-information] Personal Information is or may be used: (i) to provide and improve our Service, (ii) to administer your use of the Service, (iii) to better understand your needs and interests, (iv) to personalize and improve your experience, and (v) to provide or offer software updates and product announcements. If you no longer wish to receive communications from us, please follow the “unsubscribe” instructions provided in any of those communications, or update your account settings information. Analytics. We also collect some information (ourselves or using third-party services) using logging and cookies, such as IP address, which can sometimes be correlated with Personal Information. We use this information for the above purposes and to monitor and analyze the use of the Service, for the Service’s technical administration, to increase our Service’s functionality and user-friendliness, and to verify users have the authorization needed for the Service to process their requests. Information Sharing and Disclosure [#information-sharing-and-disclosure] We may disclose to parties outside TheirStack information that you provide and that we collect when we have a good faith belief that disclosure is reasonably necessary to: (a) comply with a law, regulation, or compulsory legal request; (b) protect the safety of any person from death or serious bodily injury; (c) prevent fraud or abuse of TheirStack or its users; or (d) to protect TheirStack property rights. Changing or Deleting Your Information [#changing-or-deleting-your-information] You can access and modify the Personal Information associated with your Account by contacting us at [hi@theirstack.com](mailto:hi@theirstack.com). Please note that if you signed up using Third-Party Account, you may have to access and modify the Personal Information associated with your Third-Party Account in order to modify certain of the Personal Information associated with your Account. If you want us to delete your Personal Information and your Account, please contact us at [hi@theirstack.com](mailto:hi@theirstack.com) with your request. We will take steps to delete your information as soon as is practicable, but some information may remain in archived/backup copies for our records or as otherwise required by law. Data Retention [#data-retention] We will retain your information for as long as your Account is active or as needed to provide you the Services. If you are a User and wish to cancel your account or request that we no longer use your information to provide you Services, you may delete your account. We may retain and use your information as necessary to comply with our legal obligations, resolve disputes, and enforce our agreements. Consistent with these requirements, we will try to delete your information quickly upon request. Please note, however, that there might be latency in deleting information from our servers and backed-up versions might exist after deletion. Only the User may request that an Account be deleted. Security [#security] The security of your information is important to us. We follow generally accepted standards to protect the information submitted to us, both during transmission and once we receive it. No method of electronic transmission or storage is 100% secure, however. Therefore, we cannot guarantee its absolute security. If you have any questions about security on our website, you can contact us at [hi@theirstack.com](mailto:hi@theirstack.com). Contacting Us [#contacting-us] If you have any questions about this Privacy Policy, please contact us at [hi@theirstack.com](mailto:hi@theirstack.com) Changes to our Privacy Policy [#changes-to-our-privacy-policy] This Privacy Policy may change from time to time, and the most current version will be posted on our Site, so please check our Site regularly. We may provide notice of changes in other circumstances as well. By continuing to use the Service after those changes become effective, you agree to be bound by the revised Privacy Policy. --- title: Refunds and Cancellations description: Refunds and Cancellations Policy for TheirStack url: https://theirstack.com/en/docs/legal/refunds-and-cancellations --- Refunds [#refunds] Our refund policy is designed to be straightforward and fair. We offer refunds under specific conditions to ensure we can continue providing quality service to all our users. Standard Refund Conditions [#standard-refund-conditions] Refunds are available when **all** of the following conditions are met: * **No usage of credits**: You have not used any credits from the invoice you're requesting a refund for * **Within 90 days**: You request the refund within 90 days of when the invoice was paid Refund Amount [#refund-amount] If you're eligible, you'll receive a full refund of the amount you paid, minus payment processing fees (approximately 3% for Stripe transactions). Refunds are processed within 5-10 business days of approval. How to Request a Refund [#how-to-request-a-refund] To request a refund: 1. Email us at hi @ theirstack.com with "Refund Request" in the subject line 2. Include your invoice number and reason for the refund request 3. Our team will review your request and respond within 2 business days Cancellations [#cancellations] You can cancel your subscription at any time without penalties. We've made the process simple and straightforward. How to Cancel [#how-to-cancel] 1. Navigate to the [Billing page](https://app.theirstack.com/settings/billing) 2. Go to the "Plans" section and click the 'Cancel Plan' button 3. Complete the brief cancellation form (optional feedback helps us improve) 4. Confirm your cancellation What Happens After Cancellation [#what-happens-after-cancellation] * **Immediate effect**: Your subscription is marked as cancelled and won't renew * **Access continues**: You keep full access to TheirStack. Credits will rollover for 12 months. * **Data retention**: Your account data remains accessible during your remaining billing period * **No automatic refunds**: Cancellation doesn't trigger a refund unless you meet the refund conditions above Need Help? [#need-help] Our support team is here to help with any questions about refunds or cancellations. Contact Us [#contact-us] * **Email**: hi @ theirstack.com * **Response time**: Within 2 business days * **For fastest service**: Include your account email and invoice number in your message --- title: Data Sub-processors description: undefined url: https://theirstack.com/en/docs/legal/subprocessors --- TheirStack may engage the third-party organizations below (each, a “Sub-processor”) to process personal data on behalf of our customers and in accordance with TheirStack’s commitments set forth in our [data processing addendum](/en/docs/legal/dpa) or other written agreement(s) between you and TheirStack. Sub-Processors [#sub-processors] | Name | Purpose | Location | | ------------------------------- | ------------------------------------------------------------------- | ------------- | | Cloudflare, Inc. | Web monitoring, WAF, Denial of Service protection, and CDN provider | United States | | Render Services, Inc. | Infrastructure provider and primary hosting provider | United States | | Vercel Inc. | Infrastructure provider and primary hosting provider | United States | | Snowflake Inc. (Crunchy Bridge) | Database | United States | | ClickHouse, Inc. | Database (job postings, company, and technographics data) | United States | | Posthog Inc. | Web analytics provider | United States | | Grafana Labs Inc. | Monitoring and observability provider | United States | | Kinde Inc. | Identity provider | United States | | Stripe, Inc. | Payment processing and billing | United States | | Loops.io | Email service provider | United States | | OpenAI, Inc. | AI services provider | United States | | Slack Technologies, Inc. | Communication platform | United States | --- title: Terms and Conditions description: Terms and Conditions for TheirStack url: https://theirstack.com/en/docs/legal/terms-and-conditions --- TheirStack is an online service that delivers company insights and aggregates jobs collected from publicly available sources. The present conditions expose the rights and obligations of the user and of TheirStack as the provider of the service. TheirStack will assume that any user who uses the service has read and accepted the conditions of use, and TheirStack reserves the right to update and modify the Terms of Use without any prior notice, which are always available at [www.theirstack.com](http://www.theirstack.com). TheirStack is the commercial name under which THEIRSTACK SL, with tax identification number ESB56963697, provides access to the TheirStack Web Site and its related services according to the terms and conditions set forth below. This agreement will be valid from the date you check the box for acceptance of this agreement that appears at the bottom of this document. New features that could be added to the Services will be subject to the Terms of Use. In case the user continues to make use of the Service after any modification, it will assume their agreement with said modifications. Failure to comply with any of the Conditions of Use may lead to cancellation of your account. 1. Account Terms [#1-account-terms] To access the service it is essential to be over eighteen (18) years old. A complete legal name, an email address, and all information required by TheirStack in the account creation process must be provided. It is the responsibility of the user to provide truthful information, and TheirStack reserves the right to delete any account if it is suspected of its veracity or could breach any of the rules of use of TheirStack. The user is responsible for maintaining the privacy of his account. TheirStack shall not be liable for any damage or loss that may be the result of user error in protecting your login information. The parties agree to legally equate the signature of the client with the signature made by any other type of code, code, or element of security identification. Notwithstanding the foregoing, the service provider may require, when deemed necessary, written confirmation to the client. Agreements TheirStack offers a rating system that adapts to the volume of documents that the user performs. The limits of each tariff are specified in the prices section. If the user exceeds any of the limits of his tariff, he will have to increase the rate. TheirStack reserves the right to modify the rates unilaterally and at any time, without granting such change any right to compensation by the users. 2. Payment and Access [#2-payment-and-access] A valid bank card is required to make payments. It is not required to create or use a free account. TheirStack will periodically charge you a recurring fee depending on the type of account you have contracted. The Service is charged each period in advance. Refunds may be available only under the conditions described in the [Refunds and Cancellations Policy](/en/docs/legal/refunds-and-cancellations). No credits are provided for partial months or periods of non-use. **Unused API Credits**: Unused API credits roll over and can be used for up to 12 months from the date they were purchased. This ensures you get full value from your purchased credits even if you don't use them immediately. **Refunds**: For information about our refund policy, including specific conditions under which refunds may be available, please refer to our [Refunds and Cancellations Policy](/en/docs/legal/refunds-and-cancellations). Refunds [#refunds] Refunds are available only under the conditions described below and in the [Refunds and Cancellations Policy](/en/docs/legal/refunds-and-cancellations): * **No usage of credits**: No credits from the invoice for which a refund is requested have been used. * **Within 90 days**: The refund request is made within 90 days of the invoice payment date. If eligible, the refund amount is the amount paid minus payment processing fees (approximately 3% for Stripe transactions). Approved refunds are processed within 5–10 business days. To request a refund, email hi @ theirstack.com with “Refund Request” in the subject, include the invoice number and the reason for the request. TheirStack will review and reply within 2 business days. The customer agrees that it will not be necessary to confirm receipt of the acceptance of the contract when it has been concluded exclusively by means of electronic communication. In case the user charges an account level for their volume of documents, a charge will not be made on their card with the new amount until the next billing date. From now on, the next billing will be charged on your card for the new amount, unless the account is canceled. In case of non-payment or return of the receipt, you will be notified of the default and will automatically lose the ability to access the Service. The data will be deleted within thirty (30) days from the date of default. No fee includes any taxes or duties required by your governmental authorities. The user is responsible for paying these taxes or obligations. The user decides who has the right to enter his account with the role he deems appropriate. 3. Products Provided [#3-products-provided] TheirStack delivers data via 4 different products: * **Web application (app.theirstack.com)**: User interface to perform job and company searches, technographic searches, filter jobs by company, view company details, perform company enrichment, create and manage saved searches, configure webhooks, and export data as CSV or Excel. * **API (api.theirstack.com)**: Programmatic access to the capabilities listed above for integration into customer systems. * **Webhooks**: Mechanism to receive notifications when new jobs or companies are identified that match a saved search. * **Datasets**: Historical datasets for jobs and companies with daily updates, delivered as flat files via cloud storage. 4. Authorized use of licensed materials and TheirStack technology, restrictions [#4-authorized-use-of-licensed-materials-and-theirstack-technology-restrictions] 4.1 Authorized Users [#41-authorized-users] Licensee shall be entitled to designate persons as Authorized Users up to the number of Authorized Users subscribed as stated in the Ordering Document. If Licensee designates additional persons as Authorized Users beyond the number subscribed, such designation may be deemed by TheirStack, to be confirmed by notice to Licensee, as Licensee's subscription to such additional number of Authorized Users. In the event of such subscription, TheirStack may charge Licensee a corresponding additional Subscription Fee equal to the prevailing per-Authorized User rate multiplied by the period from the date of notice hereunder until the end of the then-current Term. Each Authorized User will be provided a unique username and password. Such usernames and passwords may not be shared and may not under any circumstances be used by anyone who is not an Authorized User. If any Authorized User's login credentials are disclosed to any person who is not an Authorized User but who would satisfy the qualification requirements of Section 4.2 hereof, TheirStack may, upon notice to Licensee, deem such sharing to be Licensee's subscription to the number of additional Authorized Users equal to the number of persons to whom such credentials were disclosed. Licensee shall be responsible for compliance with the terms of this Agreement by all Authorized Users, including, without limitation, the restrictions on use and transfer of Licensed Materials set forth herein. Licensee acknowledges and agrees that Authorized Users must provide TheirStack with certain identifying information, including their name and a business email address, and that Authorized Users may be required to accept an end-user license agreement agreeing to TheirStack's privacy policy and representing that they are authorized to access the Services on Licensee's behalf. 4.2 Qualification of Authorized Users [#42-qualification-of-authorized-users] Licensee shall not designate any person as an Authorized User unless such person is: (1) a natural person and (2) an employee of Licensee. Licensee may designate a non-employee (i.e., an independent contractor) as an Authorized User only with prior written notice to TheirStack and provided Licensee takes reasonable steps to ensure such non-employee uses the Services only as permitted under this Agreement. If the employment of any Authorized User that was in effect as of the date such person was designated as an Authorized User terminates, such person's authorization to access the Services shall be revoked automatically without any further action by TheirStack. In the event of a termination, the Licensee shall take all reasonable steps to ensure that such person ceases accessing the Services. Licensee may reassign Authorized User designations at any time subject to the foregoing qualification requirements. 4.3 Authorized Uses and Restrictions [#43-authorized-uses-and-restrictions] Licensee may use the Services for the following purposes: * Business-to-business sales, marketing, recruiting, or business development activities * Reposting and redistributing jobs * Reselling TheirStack data partially through their own platform * Viewing and analyzing Licensed Materials * Communicating with Licensed Materials Contacts in a professional manner * Identifying prospective sales opportunities * Researching existing customers and prospects Licensee is expressly prohibited from: * Creating or offering a competing product or service to TheirStack's core services * Distributing, sublicensing, reselling, or otherwise making available TheirStack data in a way that competes with TheirStack's primary business * Providing any single customer with the TheirStack dataset in whole or substantially all, including in a form that enables reconstruction of the dataset (only partial extracts or subsets may be delivered) * Sharing login credentials, account access, API keys, or other access methods with any person who is not an Authorized User * Publishing, displaying, or otherwise making TheirStack data publicly accessible on any website, application, or platform without requiring user authentication (login) or a paid subscription (paywall) * Using TheirStack data for search engine optimization (SEO) purposes, including creating publicly indexable content (e.g., indexed pages or landing pages) designed to attract organic search traffic, unless the content is protected behind a login or paywall * Reverse engineering, decompiling, disassembling, or otherwise attempting to derive source code from TheirStack Technology * Scraping, copying, reproducing, or recreating TheirStack's website content, data, or landing pages, whether through automated means (including but not limited to web crawlers, bots, or scrapers) or manual processes, for use on any other domain, website, or platform * Copying, reproducing, or mimicking TheirStack's SEO-related elements (including meta tags, meta descriptions, title tags, structured data markup such as JSON-LD/schema.org, canonical tags, or other technical SEO implementations) for use in connection with any competing or similar service 4.4 Limitations on Use of the Services [#44-limitations-on-use-of-the-services] Licensee shall use the Services in a responsible and professional manner consistent with the intended and permissible uses herein and consistent with standard industry practice. Licensee shall not override or circumvent, or attempt to override or circumvent, any security feature, control, or use limits of the TheirStack Technology. Licensee will not use the Licensed Materials or TheirStack Technology for commercial purposes not permitted under this Agreement and shall not designate any person as an Authorized User if Licensee has reason to believe such person is likely to use the Services on behalf of a third party or otherwise in violation of this Agreement. TheirStack may use technological means to place reasonable use limits to prohibit excessive use, including excessive downloads or screen views that indicate a violation of this Agreement, such as sharing with third parties or attempting to circumvent limitations to purchased credits (if applicable). TheirStack has the right to limit the access to the Services, if Licensee does not remedy the breach within fifteen (15) days after receipt of notice in writing, except if TheirStack has to do so for any security reasons. 4.5 Identification of Licensed Materials [#45-identification-of-licensed-materials] Licensee shall not integrate Licensed Materials into any CRM, marketing automation, or sales enablement system for the purpose of allowing persons who are not Authorized Users to access or use the Licensed Materials. Any Licensed Materials that are downloaded and/or integrated into any CRM system must be maintained with identifying information indicating that such materials originated with TheirStack by, for example, maintaining a lead source of "TheirStack." 4.6 Unauthorized Access and Use [#46-unauthorized-access-and-use] In the event TheirStack has a reasonable belief that Licensee or any Authorized User is engaged in any unauthorized access or use of the Licensed Materials or TheirStack Technology in violation of this Agreement, TheirStack may suspend Licensee's access to the Licensed Materials and/or TheirStack Technology after a prior written notice remained without effect for fifteen (15) days, except if TheirStack has to do so without undue delay for any security reasons or personal data breach. TheirStack will have, in the event of an actual breach of this Agreement, no liability to Licensee for such period of suspension and a suspension shall have no effect on the Term of this Agreement nor on Licensee's obligation to pay the Subscription Fee. 5. Service and pricing modifications [#5-service-and-pricing-modifications] TheirStack reserves the right to modify or suspend, temporarily or permanently, the Service at any time for any reason with or without notice if it deems it convenient. TheirStack reserves the right to change monthly fees with a notice of 15 days. Notification of quota changes will be posted on TheirStack's website and in writing. 6. Cancelation [#6-cancelation] The user is responsible for the proper cancellation of his account. You can cancel your account at any time by going to app.theirstack.com/settings/billing. Once your account is canceled, you won't be charged anymore. The user can cancel his account at any time but will be responsible for all the charges made until that moment, including the full monthly charge for the month in which he suspends the service. Thereafter, you will not be charged. TheirStack reserves the right to cancel an account or prevent the use of the Software to those who do not comply with the present conditions of use. 7. Copyright and intellectual property [#7-copyright-and-intellectual-property] TheirStack owns all the Intellectual Property rights of all and any of the components of the Service that may be protected, including but not limited to the name of the Service, graphic material, all software associated with the Service, and the elements of the user interface contents In the Service, many of the individual characteristics and related documentation. The user undertakes not to copy, adapt, reproduce, distribute, reverse engineer, decompile, or disguise any facet of the Service that TheirStack owns. The user also accepts and agrees not to use robots, spiders, other automated devices, or manual processes to control or copy any content of the Service. TheirStack will not claim rights over the Intellectual Property of the Content that the user uploads or provides to the Service. However, by using the Service to send content, the user accepts that third parties can view and share this content sent by the user. 8. Liability [#8-liability] TheirStack shall be liable only for direct damages resulting from the proven non-performance of its essential contractual obligations under this agreement, and only to the extent such non-performance is due to gross negligence or willful misconduct. Neither party shall be liable for indirect, consequential, or immaterial damages. Each Party shall be responsible for the proper performance of its obligations and agrees to compensate the other only for direct and reasonably foreseeable damages arising from its breach of this agreement. 9. Marketing Consent [#9-marketing-consent] By using the Service, the user agrees that TheirStack may use the user's company name, logo, and domain name in marketing materials. This includes, but is not limited to, use on the TheirStack website, presentations, and promotional content. If the user wishes to opt out of this usage, they may contact TheirStack at [hi@theirstack.com](mailto:hi@theirstack.com). 10. General Terms [#10-general-terms] The user is fully responsible for the access and correct use of TheirStack subject to the current legality, whether national or international, as well as the principles of good faith, morality, good customs, and public order. And specifically, it acquires the commitment to diligently observe the present General Conditions of use. The user agrees not to resell, duplicate, reproduce, or exploit any part of the Service without the express written consent of TheirStack. TheirStack makes no warranties with respect to its ability to use the Service, its satisfaction with the Service, that the Service is available at all times, uninterruptedly and without errors, the accuracy of the mathematical calculations performed by the Service, and the correction Of the errors of the Service. Neither TheirStack nor its partners nor its sponsors are liable for any direct, indirect, consequential, special, exemplary, punitive, or other damages arising out of or in any way connected with the use made by the user of the service. The user can only solve his dissatisfaction with the Service by not using it and canceling his account. If any of the conditions described here are invalidated or can not be applied, the application of any of the remaining ones should not be affected in any case. Any questions regarding the Terms of Use should be directed to TheirStack via email at hi - at - theirstack - dot - com The Terms of Use establish an absolute understanding between you and TheirStack regarding the Service and prevail over any prior agreement reached between you and TheirStack. The Terms, and your relationship with TheirStack under these Terms, shall be governed by the laws of Spain. The user and TheirStack agree to submit to the exclusive jurisdiction of the courts of Vigo, Spain to resolve any legal questions regarding the Conditions. --- title: Auto recharge credits description: Learn how to set up auto rechage rules to prevent running out of credits in production url: https://theirstack.com/en/docs/pricing/auto-recharge-credits --- Auto recharge rules allows you to automatically recharge credits when your credit balance are bellow a specific number. You can set up one rule for each credit type (Company credits or API credits). Add rule How to set up auto recharge rules [#how-to-set-up-auto-recharge-rules] 1. Go to the [billing page](https://app.theirstack.com/settings/billing) 2. Go to the "Auto Recharge" section 3. Click on the "Add Rule" button 4. Select the credit type (Company credits or API credits) 5. Insert the amount of credits to recharge when bellow 6. Insert the amount of credits to recharge 7. Click on the "Save" button Billing page Cost of the auto recharge [#cost-of-the-auto-recharge] Auto recharge uses the same credit prices as API credits in the recurring pricing plan. Check the [pricing here](https://www.theirstack.com/en/pricing) How to delete an auto recharge rule [#how-to-delete-an-auto-recharge-rule] 1. Go to the [billing page](https://app.theirstack.com/settings/billing) 2. Go to the "Auto Recharge" section 3. Click on the trash icon button to delete the rule FAQs [#faqs] Your next request will fail, but it will trigger the auto-recharge. Once the payment processes (usually a few seconds), your new credit pack will be added and subsequent requests will succeed. --- title: Credits description: Learn the difference between API credits and Company credits and how to view your credit usage. url: https://theirstack.com/en/docs/pricing/credits --- TheirStack credits are the virtual currency system used for running actions in TheirStack. Depending on your [TheirStack plan](https://www.theirstack.com/en/pricing) you will have a different amount of credits to run actions. Credits types [#credits-types] There are 2 types of credits: company credits and API credits. Both are included in the free trial and subscription plans. Company credits [#company-credits]
Credits type
API credits [#api-credits]
Credits type
View credit usage [#view-credit-usage] You can view your credit usage by going to the [usage page](https://app.theirstack.com/settings/usage). --- title: Pricing description: Learn more about plans, credit system and repurchase rules. url: https://theirstack.com/en/docs/pricing --- FAQs [#faqs] When you reveal a company, a company credit is used. This allows you to view all their jobs, technologies, and firmographics, or export that company as many times as you want for 90 days. Since collecting new jobs or technologies incurs a cost, it's not feasible to offer unlimited access to new data indefinitely. However, we are planning an enhancement to offer you a better experience: after 90 days, you will still be able to see the company, but any new jobs or technologies discovered after that period will not be accessible. This ensures you retain the data you've paid for, without receiving updates beyond the initial access period. You can cancel your subscription at any time. Please go to [this page](https://app.theirstack.com/settings/billing) and click on the "Cancel Subscription" button. Once you complete the cancellation form, you will see that the status plan will be updated to "Cancelled". You can set to auto recharge credits at any time. Please go to [this page](https://app.theirstack.com/settings/billing) and click on the "Auto Recharge" button. You can configure to auto-recharge when company credits or api credits are bellow a specific number(eg:1000 credits) and you can select the amount. The cost of this credits package auto-charge will be the same credit prices as it was a recurren price. Check the [pricing here](https://www.theirstack.com/en/pricing) Updating a subscription isn't currently supported, but you can cancel your current plan and subscribe to a new one. Credits from the new plan will be available immediately, and unused credits from the current plan can be used for up to 12 months from the date they were purchased, even if you cancel your subscription. Here's how it works: 1. Visit your [billing page](https://app.theirstack.com/settings/billing) anytime 2. Click "Update Subscription" to cancel your current plan 3. Select a new plan with more or fewer credits based on your needs 4. You'll pay the full amount for the new plan when your current cycle ends **Important:** Credits from your current billing period aren't prorated or refunded when you make changes. You can change the billing information at any time: billing address, billing email, tax ID and phone number. 1. Go to [the billing page](https://app.theirstack.com/settings/billing) 2. Click on "Manage Billing" and you will be redirected to the Stripe billing portal. 3. Click on "Update information" 4. Update any of the fields: name, email, address, phone number and tax ID 5. Click on the "Save" button The changes will be applied to the next invoice. Our platform operates on a self-service model, which means we don't offer custom quotes for company lists. Instead, you can easily calculate the cost yourself: 1. Visit our [company search page](https://app.theirstack.com/search/companies/new) and use filters to find companies matching your criteria (e.g., technologies used, location, size). 2. Note the total number of companies in your filtered results (shown in the top left corner). This represents the number of company credits you'll need. 3. Check our [pricing page](https://www.theirstack.com/en/pricing) to find the plan that best fits your credit needs. You can get a receipt or invoice of your purchases at any time through the [invoices page](https://app.theirstack.com/settings/invoices). Every time you reveal a company, it is added to a company list called "Companies seen". Go to this [company list](https://app.theirstack.com/company-list) to see all your revealed companies. --- title: Plans description: Learn about the different plans available on TheirStack. url: https://theirstack.com/en/docs/pricing/plans --- **Free Plan** Start exploring with 50 company credits and 200 API credits every month - completely free, forever. Perfect for getting started, but with a few gentle limits to keep things fair: * Browse up to 5 pages of search results * View 25 results per page > The free plan is only for users who have never paid for any credits. Once you make your first payment, you become a paid plan member from that moment forward. **Paid Plan** Unlock the potential with any paid plan (app, API, or dataset) and enjoy full access to all features. Comparison [#comparison] Compare the features and limitations between free and paid plans: | Feature | Free Plan | Paid Plan | | -------------------------------------------------------------------------- | ------------- | -------------------------------- | | **Credits (monthly)** | | | | Company credits | 50 per month | 50 per month + purchased amount | | API credits | 200 per month | 200 per month + purchased amount | | **[Job Search](/en/docs/api-reference/jobs/search_jobs_v1)** | | | | Results per page | Up to 25 | Up to 500 | | Maximum pages | 5 pages | Unlimited | | Rate limit | 2 req/sec | 4 req/sec | | **[Company Search](/en/docs/api-reference/companies/search_companies_v1)** | | | | Results per page | Up to 25 | Up to 500 | | Maximum pages | 5 pages | Unlimited | | Rate limit | 2 req/sec | 4 req/sec | | **[Technographics](/en/docs/api-reference/companies/technographics_v1)** | | | | Results per page | Unlimited | Unlimited | | Maximum pages | Unlimited | Unlimited | | Rate limit | 2 req/sec | 4 req/sec | To upgrade your plan and access higher limits, visit the [billing settings](https://app.theirstack.com/settings/billing/purchase?defaultTab=app). --- title: Usage description: Learn how to view your credit usage, webhook events, and API requests with detailed charts showing breakdowns by status, type, and time period. url: https://theirstack.com/en/docs/pricing/usage --- Usage page You can view your credit usage through the [usage page](https://app.theirstack.com/settings/usage). Use the date range picker to see the usage for a specific period. Credits usage [#credits-usage] In the credits usage section you can see the total credits consumed for your account for company credits and API credits. Credits usage Webhook events [#webhook-events] With the webhook events chart you can see the total number of webhook events triggered for your account. You can see a breakdown of the webhook events by: * **Event Status**: success, in progress, failed, not triggered. Learn more about the [webhook events statuses](/en/docs/webhooks/monitor-your-webhooks#webhook-events-statuses). Webhook events chart * **Webhook**: name of the webhook that triggered the event. Webhook events chart Requests [#requests] The requests chart shows the total number of API requests and UI requests for your account. Click "View request" to see the CURL command for any request. Requests usage chart --- title: Company Dataset description: Learn about the dictionary of the Companies Dataset. url: https://theirstack.com/en/docs/datasets/options/company --- --- title: Job Dataset description: Explore all 60 job dataset fields including column names, data types, descriptions, and fill rates showing data completeness metrics for each field url: https://theirstack.com/en/docs/datasets/options/job --- FAQS [#faqs] Currently, we scrape all jobs only once. To be able to offer what you're asking for, we'd have to constantly be scraping millions of jobs every day for many days, which would increase our costs by 10x, 20x or even more. Those costs would have to be passed to customers, and no customers would be willing to pay for that. So the best solution at the moment is that you check yourself for each job if they're active or not. You could use something like getting the markdown of the page with Firecrawl and then passing that to an LLM asking if the job is still active or not. If you only want jobs that are likely to be still active, the more recent the jobs are, the more likely it'll be that they're still active. So another recommendation is to keep the range of dates you're passing to posted\_at filters recent, to something like the past 15 days. The completeness of certain fields depends a lot on how our sources structure and share their data. * **City / exact location**: Many job boards only expose country-level information or make detailed locations optional, so we can’t always infer a precise city. * **Salary range**: Salary transparency rules vary by region and company, which means this data is simply not present in many postings. Whenever the data is available in a consistent way, we extract and normalize it. When it isn’t, we prefer to leave the field empty rather than guess. --- title: Dictionary description: Complete reference for 41 technographic fields tracking company technology adoption through job postings, including v2 schema and migration guide from v1 url: https://theirstack.com/en/docs/datasets/options/technographic --- Technographics v2 [#technographics-v2] Differences from v1.0.0 [#differences-from-v100] The following columns are renamed: * `technology_id` → `keyword_id` * `technology_rank` → `technology_rank_source_jobs` * `technology_rank_180_days` → `technology_rank_180_days_source_jobs` * `rank_1_tie` → `rank_1_tie_source_jobs` * `rank_180_days_tie` → `rank_180_days_tie_source_jobs` * `relative_occurrence_within_category` → `relative_occurrence_within_category_source_jobs` * `jobs_source_final_url` → `jobs_source_url` * `first_date_found_source_final_url` → `first_date_found_source_job_url` * `last_date_found_source_final_url` → `last_date_found_source_job_url` The following columns are added: * `keyword_slug` - Slug identifier for the technology * `subcategory_slug` - Slug identifier for the technology subcategory * `is_recruiting_agency` - Indicates if the company is a recruiting agency * `jobs_source_description_last_180_days` - Number of jobs mentioning this technology in the job description in the last 180 days * `jobs_source_description_last_30_days` - Number of jobs mentioning this technology in the job description in the last 30 days * `jobs_source_description_last_7_days` - Number of jobs mentioning this technology in the job description in the last 7 days * `jobs_source_title` - Number of jobs mentioning this technology in the job title * `jobs_source_title_last_180_days` - Number of jobs mentioning this technology in the job title in the last 180 days * `jobs_source_title_last_30_days` - Number of jobs mentioning this technology in the job title in the last 30 days * `jobs_source_title_last_7_days` - Number of jobs mentioning this technology in the job title in the last 7 days * `jobs_source_url_last_180_days` - Number of jobs mentioning this technology in the ATS URL in the last 180 days * `jobs_source_url_last_30_days` - Number of jobs mentioning this technology in the ATS URL in the last 30 days * `jobs_source_url_last_7_days` - Number of jobs mentioning this technology in the ATS URL in the last 7 days * `first_date_found_source_job_title` - Date when the job title first mentioned the technology * `last_date_found_source_job_title` - Date when the job title last mentioned the technology * `rank_last_date_found_source_job_url` - Rank of the technology within its category based on mentions in job ATS URLs as of the last date found * `relative_occurrence_within_category_180_days_source_jobs` - Measures the relative occurrence of this technology among other technologies in the same category, in jobs by this company over the last 180 days Technographics v1 (deprecated) [#technographics-v1-deprecated] Technologies [#technologies] --- title: Company.New description: Triggered when a new company matching your saved search criteria is discovered. [Learn more about webhooks](https://theirstack.com/en/docs/webhooks). url: https://theirstack.com/en/docs/webhooks/event-type/company_newcompany_new_post --- {/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */} --- title: Job.New description: Triggered when a new job matching your saved search criteria is discovered. [Learn more about webhooks](https://theirstack.com/en/docs/webhooks). url: https://theirstack.com/en/docs/webhooks/event-type/job_newjob_new_post --- {/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */} --- title: Get Credit Balance description: Get your current credits balance url: https://theirstack.com/en/docs/api-reference/billing/get_billing_credit_balance_v0 --- ## OpenAPI Specification ```json { "path": "/v0/billing/credit-balance", "method": "GET", "tags": [ "Billing" ], "summary": "Get Credit Balance", "description": "Get your current credits balance", "operationId": "get_billing_credit_balance_v0", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "ui_credits": { "type": "integer", "minimum": 0, "title": "Ui Credits", "description": "Number of credits available to the team" }, "used_ui_credits": { "type": "integer", "minimum": 0, "title": "Used Ui Credits", "description": "Number of credits used in the current billing cycle" }, "api_credits": { "type": "integer", "minimum": 0, "title": "Api Credits", "description": "Number of API credits available to the team" }, "used_api_credits": { "type": "integer", "minimum": 0, "title": "Used Api Credits", "description": "Number of API credits used in the current billing cycle" } }, "type": "object", "required": [ "ui_credits", "used_ui_credits", "api_credits", "used_api_credits" ], "title": "CreditsBalance" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } } }, "security": [ { "Bearer": [] } ] } ``` --- title: Get Companies Per Company Country Code description: This endpoint will return all country codes and the number of companies whose HQ is in that country. url: https://theirstack.com/en/docs/api-reference/catalog/get_catalog_companies_per_company_country_code_v0 --- Calls to this endpoint don't cost you credits. ## OpenAPI Specification ```json { "path": "/v0/catalog/companies_per_company_country_code", "method": "GET", "tags": [ "Catalog" ], "summary": "Get Companies Per Company Country Code", "description": "This endpoint will return all country codes and the number of companies whose HQ is in that country.\n\nCalls to this endpoint don't cost you credits.", "operationId": "get_catalog_companies_per_company_country_code_v0", "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Name of a country. Will return the country matching their name in English", "title": "Country" }, "description": "Name of a country. Will return the country matching their name in English" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Page number.", "default": 0, "title": "Page" }, "description": "Page number." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Number of results per page", "default": 25, "title": "Limit" }, "description": "Number of results per page" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "data": { "items": { "properties": { "iso2": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Iso2", "description": "ISO2 country code" }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country", "description": "Country name" }, "num_companies": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Num Companies", "description": "Number of companies in the country" } }, "type": "object", "title": "CompaniesPerCountryCode" }, "type": "array", "title": "Data" }, "metadata": { "properties": { "total_results": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Results", "description": "Total number of results", "examples": [ 2034 ] } }, "type": "object", "title": "BaseMetadata" } }, "type": "object", "required": [ "data", "metadata" ], "title": "CompaniesPerCountryCodeResponse" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Get Industries description: This endpoint lets you list all the industries and their codes, see how many jobs and companies we have per industry and search for an industry. url: https://theirstack.com/en/docs/api-reference/catalog/get_catalog_industries_v0 --- Calls to this endpoint don't cost you credits. Our industries catalogue comes from [LinkedIn Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2) ## OpenAPI Specification ```json { "path": "/v0/catalog/industries", "method": "GET", "tags": [ "Catalog" ], "summary": "Get Industries", "description": "This endpoint lets you list all the industries and their codes, see how many jobs and companies we have per industry and search for an industry.\n\nCalls to this endpoint don't cost you credits.\n\nOur industries catalogue comes from [LinkedIn Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2)", "operationId": "get_catalog_industries_v0", "parameters": [ { "name": "industry", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Name of an industry, case-insensitive. Will return industries that contain the given string either in their name, hierarchy or description", "default": "", "title": "Industry" }, "description": "Name of an industry, case-insensitive. Will return industries that contain the given string either in their name, hierarchy or description" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Page number.", "default": 0, "title": "Page" }, "description": "Page number." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Number of results per page", "default": 25, "title": "Limit" }, "description": "Number of results per page" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "data": { "items": { "properties": { "industry_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Industry Id", "description": "ID of the industry" }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Industry", "description": "Name of the industry" }, "hierarchy": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Hierarchy", "description": "Hierarchy of the industry, according to LinkedIn's taxonomy" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the industry" }, "parent_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Parent Id", "description": "ID of the parent industry" }, "companies": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Companies", "description": "Number of companies in the industry" }, "jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Jobs", "description": "Number of jobs in the industry" } }, "type": "object", "title": "IndustryStats" }, "type": "array", "title": "Data" }, "metadata": { "properties": { "total_results": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Results", "description": "Total number of results", "examples": [ 2034 ] } }, "type": "object", "title": "BaseMetadata" } }, "type": "object", "required": [ "data", "metadata" ], "title": "IndustryStatsResponseV0" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "properties": { "detail": { "items": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" } } } } } } ``` --- title: Get Jobs And Companies Per Job Country Code description: This endpoint will return all the country codes and the number of jobs whose location's country code is the given one, and the number of companies with jobs in that country. url: https://theirstack.com/en/docs/api-reference/catalog/get_catalog_jobs_companies_per_job_country_code_v0 --- Calls to this endpoint don't cost you credits. ## OpenAPI Specification ```json { "path": "/v0/catalog/jobs_companies_per_job_country_code", "method": "GET", "tags": [ "Catalog" ], "summary": "Get Jobs And Companies Per Job Country Code", "description": "This endpoint will return all the country codes and the number of jobs whose location's country code is the given one, and the number of companies with jobs in that country.\n\nCalls to this endpoint don't cost you credits.", "operationId": "get_catalog_jobs_companies_per_job_country_code_v0", "parameters": [ { "name": "country", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Name of a country. Will return the country matching their name in English", "title": "Country" }, "description": "Name of a country. Will return the country matching their name in English" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Page number.", "default": 0, "title": "Page" }, "description": "Page number." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Number of results per page", "default": 25, "title": "Limit" }, "description": "Number of results per page" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "data": { "items": { "properties": { "iso2": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Iso2", "description": "ISO2 country code" }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country", "description": "Country name" }, "num_jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Num Jobs", "description": "Number of jobs with the location in the country" }, "num_companies": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Num Companies", "description": "Number of companies from jobs with the location in the country" } }, "type": "object", "title": "JobsCompaniesPerJobCountryCode" }, "type": "array", "title": "Data" }, "metadata": { "properties": { "total_results": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Results", "description": "Total number of results", "examples": [ 2034 ] } }, "type": "object", "title": "BaseMetadata" } }, "type": "object", "required": [ "data", "metadata" ], "title": "JobsCompaniesPerJobCountryCodeResponse" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Get Geographic Locations description: Search for geographic locations by name or ID to retrieve standardized location data. url: https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0 --- The returned location data can be used with the [Job Search](https://api.theirstack.com/#tag/jobs/post/v1/jobs/search) and [Company Search](https://api.theirstack.com/#tag/companies/post/v1/companies/search) endpoints. This endpoint does not consume API credits. Location data is sourced from [GeoNames](https://www.geonames.org/). Examples [#examples] Search for locations by name: ```bash curl "https://api.theirstack.com/v0/catalog/locations?name=Paris" --header "Authorization: Bearer YOUR_API_KEY" ``` Retrieve location details by ID: ```bash curl "https://api.theirstack.com/v0/catalog/locations?id=2968815" --header "Authorization: Bearer YOUR_API_KEY" ``` ## OpenAPI Specification ```json { "path": "/v0/catalog/locations", "method": "GET", "tags": [ "Catalog" ], "summary": "Get Geographic Locations", "description": "Search for geographic locations by name or ID to retrieve standardized location data.\n\nThe returned location data can be used with the [Job Search](https://theirstack.com/en/docs/api-reference/jobs/search_jobs_v1) and [Company Search](https://theirstack.com/en/docs/api-reference/companies/search_companies_v1) endpoints.\n\nThis endpoint does not consume API credits.\n\nLocation data is sourced from [GeoNames](https://www.geonames.org/).\n\n### Examples\n\nSearch for locations by name:\n\n```bash\ncurl \"https://api.theirstack.com/v0/catalog/locations?name=Paris\" --header \"Authorization: Bearer YOUR_API_KEY\"\n```\n\nRetrieve location details by ID:\n\n```bash\ncurl \"https://api.theirstack.com/v0/catalog/locations?id=2968815\" --header \"Authorization: Bearer YOUR_API_KEY\"\n```", "operationId": "get_catalog_locations_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "array", "items": { "type": "integer" } }, { "type": "null" } ], "description": "The ids of the locations", "examples": [ 1, [ 2, 3 ] ], "title": "Id" }, "description": "The ids of the locations" }, { "name": "name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Search value for the location, this will be used to filter the locations by name", "title": "Name" }, "description": "Search value for the location, this will be used to filter the locations by name", "example": "Paris" }, { "name": "country_code", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The country code of the location, all the returned locations will be filtered by this country code", "title": "Country Code" }, "description": "The country code of the location, all the returned locations will be filtered by this country code", "example": "FR" }, { "name": "feature_code", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "description": "GeoNames feature code(s) to filter by location type (e.g. PPL=populated place, ADM1=first-order admin division). See https://www.geonames.org/export/codes.html", "examples": [ "PPL", [ "PPL", "PPLA" ], "ADM1" ], "title": "Feature Code" }, "description": "GeoNames feature code(s) to filter by location type (e.g. PPL=populated place, ADM1=first-order admin division). See https://www.geonames.org/export/codes.html" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "The offset of the results", "examples": [ 0, 10 ], "default": 0, "title": "Offset" }, "description": "The offset of the results" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100000, "minimum": 1, "description": "The limit of the results", "examples": [ 10, 5 ], "default": 5, "title": "Limit" }, "description": "The limit of the results" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "id": { "type": "integer", "title": "Id", "description": "The unique identifier for the location, is based on the geonameid field from the geonames database", "examples": [ 5128581 ] }, "name": { "type": "string", "title": "Name", "description": "The name of the location", "examples": [ "New York", "Paris", "Tokyo" ] }, "admin1_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Admin1 Name", "description": "The name of the first-level administrative division (e.g., state or province) of the location", "examples": [ "New York", "Île-de-France", "Tokyo" ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Code", "description": "The ISO 3166-1 alpha-2 code of the country of the location", "examples": [ "US", "FR", "JP" ] }, "feature_code": { "type": "string", "title": "Feature Code", "description": "The feature code of the location", "examples": [ "PPL", "PCL", "PCLD" ] }, "feature_name": { "type": "string", "enum": [ "city", "region", "country", "continent" ], "title": "GeonameType" }, "display_name": { "type": "string", "title": "Display Name", "readOnly": true }, "country_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Name", "readOnly": true } }, "type": "object", "required": [ "id", "name", "feature_code", "feature_name", "display_name", "country_name" ], "title": "GeonameCatalogResponse" }, "title": "Response Get Catalog Locations V0" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: List Technologies description: This endpoint lets you list all the technologies we track, search for any given technology and list the technologies within one or several categories. url: https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_v0 --- Calls to this endpoint don't cost you credits. ## OpenAPI Specification ```json { "path": "/v0/catalog/technologies", "method": "GET", "tags": [ "Catalog" ], "summary": "List Technologies", "description": "This endpoint lets you list all the technologies we track, search for any given technology and list the technologies within one or several categories.\n\nCalls to this endpoint don't cost you credits.", "operationId": "get_catalog_technologies_v0", "parameters": [ { "name": "name_pattern", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Case-insensitive text to search for in the technology name", "title": "Name Pattern" }, "description": "Case-insensitive text to search for in the technology name" }, { "name": "slug", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "description": "Technology slug of a single technology", "deprecated": true, "title": "Slug" }, "description": "Technology slug of a single technology", "deprecated": true }, { "name": "slugs", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "description": "Technology slugs of one or many technologies", "title": "Slugs" }, "description": "Technology slugs of one or many technologies" }, { "name": "category_pattern", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Case-insensitive text to search for in the technology category. For example, `data` to find 'data tools'.", "title": "Category Pattern" }, "description": "Case-insensitive text to search for in the technology category. For example, `data` to find 'data tools'." }, { "name": "category_slug", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Technology category slug", "title": "Category Slug" }, "description": "Technology category slug" }, { "name": "parent_category_slug", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Technology parent category slug", "title": "Parent Category Slug" }, "description": "Technology parent category slug" }, { "name": "parent_category_pattern", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Case-insensitive text to search for in the technology parent category name", "title": "Parent Category Pattern" }, "description": "Case-insensitive text to search for in the technology parent category name" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Page number.", "default": 0, "title": "Page" }, "description": "Page number." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Number of results per page", "default": 25, "title": "Limit" }, "description": "Number of results per page" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "name": { "type": "string", "title": "Name", "examples": [ "PostgreSQL" ] }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category", "description": "Category of the technology", "examples": [ "Relational Database" ] }, "slug": { "type": "string", "title": "Slug", "description": "Slug of the technology", "examples": [ "kafka", "snowflake" ] }, "category_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category Slug", "description": "Slug of the category of the technology", "examples": [ "message-queue" ] }, "parent_category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Category", "description": "Parent category of the technology", "examples": [ "Data Stores" ] }, "parent_category_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Category Slug", "description": "Slug of the parent category of the technology", "examples": [ "data-stores" ] }, "logo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logo", "description": "Logo of the technology" }, "logo_thumbnail": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logo Thumbnail", "description": "Thumbnail of the technology" }, "one_liner": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "One Liner", "description": "One-line description of the technology", "examples": [ "Apache Kafka" ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url", "description": "URL of the technology" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the technology" }, "jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Jobs", "description": "Number of jobs found mentioning this technology" }, "companies": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Companies", "description": "Number of companies using this technology" }, "companies_found_last_week": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Companies Found Last Week", "description": "Number of companies found using this technology in the last week for the first time" } }, "type": "object", "required": [ "name", "slug" ], "title": "TechnologyAggregated" }, "title": "Response Get Catalog Technologies V0" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Get Industries description: This endpoint lets you: - List all the industries and their codes - See how many jobs and companies we have per industry - Search for an industry url: https://theirstack.com/en/docs/api-reference/catalog/get_industries_v0 --- Calls to this endpoint don't cost you credits. Our industries catalogue comes from [LinkedIn Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2) ## OpenAPI Specification ```json { "path": "/v0/catalog/industries", "method": "GET", "tags": [ "Catalog" ], "summary": "Get Industries", "description": "This endpoint lets you list all the industries and their codes, see how many jobs and companies we have per industry and search for an industry.\n\nCalls to this endpoint don't cost you credits.\n\nOur industries catalogue comes from [LinkedIn Industry Codes V2](https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2)", "operationId": "get_catalog_industries_v0", "parameters": [ { "name": "industry", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Name of an industry, case-insensitive. Will return industries that contain the given string either in their name, hierarchy or description", "default": "", "title": "Industry" }, "description": "Name of an industry, case-insensitive. Will return industries that contain the given string either in their name, hierarchy or description" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Page number.", "default": 0, "title": "Page" }, "description": "Page number." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Number of results per page", "default": 25, "title": "Limit" }, "description": "Number of results per page" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "data": { "items": { "properties": { "industry_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Industry Id", "description": "ID of the industry" }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Industry", "description": "Name of the industry" }, "hierarchy": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Hierarchy", "description": "Hierarchy of the industry, according to LinkedIn's taxonomy" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the industry" }, "parent_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Parent Id", "description": "ID of the parent industry" }, "companies": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Companies", "description": "Number of companies in the industry" }, "jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Jobs", "description": "Number of jobs in the industry" } }, "type": "object", "title": "IndustryStats" }, "type": "array", "title": "Data" }, "metadata": { "properties": { "total_results": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Results", "description": "Total number of results", "examples": [ 2034 ] } }, "type": "object", "title": "BaseMetadata" } }, "type": "object", "required": [ "data", "metadata" ], "title": "IndustryStatsResponseV0" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "properties": { "detail": { "items": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" } } } } } } ``` --- title: List Technology Categories description: Returns a list of main technology categories with the number of technologies and companies in each category. Optionally filters to return a specific category if category_slug is provided. url: https://theirstack.com/en/docs/api-reference/catalog/list_categories_v1 --- ## OpenAPI Specification ```json { "path": "/v1/catalog/technologies/categories", "method": "GET", "tags": [ "Catalog" ], "summary": "List Technology Categories", "description": "Returns a list of main technology categories with the number of technologies and companies in each category. Optionally filters to return a specific category if category_slug is provided.", "operationId": "list_categories_v1", "parameters": [ { "name": "category_slug", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional category slug to filter and return only a specific category", "title": "Category Slug" }, "description": "Optional category slug to filter and return only a specific category", "example": "finance-and-accounting" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "data": { "items": { "properties": { "name": { "type": "string", "title": "Name", "description": "Name of the parent category" }, "slug": { "type": "string", "title": "Slug", "description": "Slug of the parent category" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the category" }, "number_of_technologies": { "type": "integer", "title": "Number Of Technologies", "description": "Number of technologies in the category" }, "number_of_companies": { "type": "integer", "title": "Number Of Companies", "description": "Number of companies using technologies in the category" } }, "type": "object", "required": [ "name", "slug", "number_of_technologies", "number_of_companies" ], "title": "TechnologyParentCategoryItem" }, "type": "array", "title": "Data" }, "metadata": { "properties": { "total_results": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Results", "description": "Total number of results", "examples": [ 2034 ] } }, "type": "object", "title": "BaseMetadata" } }, "type": "object", "required": [ "data", "metadata" ], "title": "TechnologyParentCategoryResponse" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: List Technology Subcategories description: Returns a list of technology subcategories with their technologies. Behavior: returns all subcategories if no parameters are provided; returns all subcategories for a specific parent category if only category_slug is provided; returns a specific subcategory if both category_slug and subcategory_slug are provided. url: https://theirstack.com/en/docs/api-reference/catalog/list_subcategories_v1 --- ## OpenAPI Specification ```json { "path": "/v1/catalog/technologies/subcategories", "method": "GET", "tags": [ "Catalog" ], "summary": "List Technology Subcategories", "description": "Returns a list of technology subcategories with their technologies. Behavior: returns all subcategories if no parameters are provided; returns all subcategories for a specific parent category if only category_slug is provided; returns a specific subcategory if both category_slug and subcategory_slug are provided.", "operationId": "list_subcategories_v1", "parameters": [ { "name": "subcategory_slug", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Subcategory slug to filter by a specific subcategory. Must be used together with category_slug.", "title": "Subcategory Slug" }, "description": "Subcategory slug to filter by a specific subcategory. Must be used together with category_slug.", "example": "account-reconciliation" }, { "name": "category_slug", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Parent category slug to filter subcategories. If provided with subcategory_slug, returns only that specific subcategory. If provided alone, returns all subcategories for that parent category.", "title": "Category Slug" }, "description": "Parent category slug to filter subcategories. If provided with subcategory_slug, returns only that specific subcategory. If provided alone, returns all subcategories for that parent category.", "example": "finance-and-accounting" }, { "name": "num_technologies_per_category", "in": "query", "required": false, "schema": { "type": "integer", "description": "Number of technologies per category to include in the response", "default": 5, "title": "Num Technologies Per Category" }, "description": "Number of technologies per category to include in the response" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "data": { "items": { "properties": { "name": { "type": "string", "title": "Name", "description": "Name of the category" }, "slug": { "type": "string", "title": "Slug", "description": "Slug of the category" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the category or subcategory" }, "number_of_technologies": { "type": "integer", "title": "Number Of Technologies", "description": "Number of technologies in the category" }, "number_of_companies": { "type": "integer", "title": "Number Of Companies", "description": "Number of companies using technologies in the category" }, "technologies": { "items": { "properties": { "name": { "type": "string", "title": "Name", "description": "Names of the top 5 technologies" }, "logo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logo", "description": "Logos of the top 5 technologies" }, "slug": { "type": "string", "title": "Slug", "description": "Slugs of the top 5 technologies" } }, "type": "object", "required": [ "name", "slug" ], "title": "TechnologyFromCategorySmallDetails" }, "type": "array", "title": "Technologies", "description": "List of technologies in this category" }, "category_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category Slug", "description": "Slug of the parent category" } }, "type": "object", "required": [ "name", "slug", "number_of_technologies", "number_of_companies", "technologies" ], "title": "TechnologyCategoryItem" }, "type": "array", "title": "Data" }, "metadata": { "properties": { "total_results": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Results", "description": "Total number of results", "examples": [ 2034 ] } }, "type": "object", "title": "BaseMetadata" } }, "type": "object", "required": [ "data", "metadata" ], "title": "TechnologyCategoryResponse" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Company Search description: 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. url: https://theirstack.com/en/docs/api-reference/companies/search_companies_v1 --- It consumes **3 API credits** for each company returned in the response. Useful resources: [Preview data mode](https://theirstack.com/en/docs/api/preview-data-mode), [Free count mode](https://theirstack.com/en/docs/api/free-count) The response includes both company data and any matching jobs or technologies based on your filters. ## OpenAPI Specification ```json { "path": "/v1/companies/search", "method": "POST", "tags": [ "Companies" ], "summary": "Company Search", "description": "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.\n\nIt consumes **3 API credits** for each company returned in the response.\n\nUseful resources: [Preview data mode](https://theirstack.com/en/docs/api/preview-data-mode), [Free count mode](https://theirstack.com/en/docs/api/free-count)\n\nThe response includes both company data and any matching jobs or technologies based on your filters.", "operationId": "search_companies_v1", "requestBody": { "content": { "application/json": { "schema": { "properties": { "expand_technology_slugs": { "items": { "type": "string" }, "type": "array", "title": "Expand Technology Slugs", "description": "Specify technology slugs to include detailed technology usage information for each company. The response will include a 'technologies_found' field containing metrics like confidence score, ranking, and job count for each specified technology. Note: If a technology is not listed for a company, it means that company does not use that technology. This feature is useful for enriching company data with their technology stack details.", "default": [] }, "order_by": { "items": { "properties": { "desc": { "type": "boolean", "title": "Desc", "description": "Whether to order by descending or ascending values", "default": true }, "field": { "type": "string", "enum": [ "name", "num_jobs", "num_jobs_last_30_days", "num_jobs_found", "employee_count", "alexa_ranking", "founded_year", "annual_revenue_usd", "total_funding_usd", "last_funding_round_date", "confidence", "jobs", "first_date_found" ], "title": "Field", "description": "Order the results by some of these fields" } }, "additionalProperties": false, "type": "object", "required": [ "field" ], "title": "ColumnSortCompanySearch" }, "type": "array", "title": "Order By", "description": "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", "default": [ { "desc": true, "field": "confidence" }, { "desc": true, "field": "num_jobs_found" }, { "desc": true, "field": "num_jobs" }, { "desc": true, "field": "num_jobs" }, { "desc": true, "field": "employee_count" } ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "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.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_case_insensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Case Insensitive Or", "description": "Only return companies that match these names exactly, case-insensitively.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_id_or": { "items": { "type": "string" }, "type": "array", "title": "Company Id Or", "description": "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.", "default": [], "examples": [ [], [ "1234567890", "1234567891" ] ] }, "company_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Or", "description": "Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.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.", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Not", "description": "Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_name_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Not", "description": "Only return companies that don't match these names exactly, case-sensitively.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Or", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_name_partial_match_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Not", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_linkedin_url_or": { "items": { "type": "string" }, "type": "array", "title": "Company Linkedin Url Or", "description": "Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.", "default": [], "examples": [ [], [ "https://www.linkedin.com/company/google/" ] ] }, "blur_company_data": { "type": "boolean", "title": "Blur Company Data", "description": "Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)", "default": false }, "property_exists_or": { "items": { "type": "string", "enum": [ "domain", "linkedin_url" ] }, "type": "array", "title": "Property Exists Or", "description": "Return companies that have any of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have a domain OR a linkedin_url set.", "default": [], "examples": [ [], [ "domain", "linkedin_url" ] ] }, "property_exists_and": { "items": { "type": "string", "enum": [ "domain", "linkedin_url" ] }, "type": "array", "title": "Property Exists And", "description": "Return companies that have all of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have both domain AND linkedin_url set.", "default": [], "examples": [ [], [ "domain", "linkedin_url" ] ] }, "offset": { "type": "integer", "minimum": 0, "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "page": { "type": "integer", "minimum": 0, "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "title": "Limit", "description": "Number of results per page", "default": 25, "examples": [ 25 ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cursor", "description": "Cursor for pagination" }, "company_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Or", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Not", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_accent_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Description Pattern Accent Insensitive", "description": "Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.", "default": false, "examples": [ null, true, false ] }, "min_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Revenue Usd", "description": "Minimum company revenue, in USD", "examples": [ null ] }, "max_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Revenue Usd", "description": "Maximum company revenue, in USD", "examples": [ null ] }, "min_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count", "description": "Minimum number of employees in a company", "examples": [ null, 100 ] }, "max_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count", "description": "Maximum number of employees in a company", "examples": [ null, 100 ] }, "min_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count Or Null", "description": "Minimum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "max_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count Or Null", "description": "Maximum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "min_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Funding Usd", "description": "Minimum company funding, in USD", "examples": [ null, 1000000000 ] }, "max_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Funding Usd", "description": "Maximum company funding, in USD", "examples": [ null, 1000000000 ] }, "funding_stage_or": { "items": { "type": "string" }, "type": "array", "title": "Funding Stage Or", "description": "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']", "default": [] }, "industry_or": { "items": { "type": "string" }, "type": "array", "title": "Industry Or", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_or field instead. ", "default": [], "deprecated": true }, "industry_not": { "items": { "type": "string" }, "type": "array", "title": "Industry Not", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_not field instead. ", "default": [], "deprecated": true }, "industry_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Or", "description": "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)", "default": [] }, "industry_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Not", "description": "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)", "default": [] }, "company_tags_or": { "items": { "type": "string" }, "type": "array", "title": "Company Tags Or", "description": "Return companies that match any of these keywords", "default": [] }, "company_type": { "anyOf": [ { "type": "string", "enum": [ "recruiting_agency", "direct_employer", "all" ] }, { "type": "null" } ], "title": "Company Type", "description": "Filter by company type." }, "company_investors_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Or", "description": "Investors of the company", "default": [] }, "company_investors_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Partial Match Or", "description": "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).", "default": [] }, "company_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Or", "description": "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)", "default": [] }, "company_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug And", "description": "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)", "default": [] }, "company_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Not", "description": "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)", "default": [] }, "only_yc_companies": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Yc Companies", "description": "Only return YC companies", "default": false }, "company_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Location Pattern Or", "description": "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.", "default": [] }, "company_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Or", "description": "Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Not", "description": "Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_list_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Or", "description": "Return companies that belong to any of the company lists passed here", "default": [] }, "company_list_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Not", "description": "Return companies that don't belong to any of the company lists passed here", "default": [] }, "company_linkedin_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Linkedin Url Exists", "description": "(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL", "deprecated": true, "examples": [ null ] }, "revealed_company_data": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Revealed Company Data", "description": "This field is deprecated and has no effect.", "deprecated": true, "examples": [ null ] }, "last_funding_round_date_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Lte", "description": "Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "last_funding_round_date_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Gte", "description": "Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "include_total_results": { "type": "boolean", "title": "Include Total Results", "description": "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.", "default": false }, "job_filters": { "anyOf": [ { "properties": { "job_title_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Or", "description": "Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Not", "description": "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.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_pattern_and": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern And", "description": "Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Or", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Not", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Or", "description": "2-letter ISO country code of the location of the job. Can pass more than 1", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "job_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Not", "description": "2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "posted_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Posted At Max Age Days", "description": "Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "posted_at_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Gte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.", "examples": [ null, "2025-05-25" ] }, "posted_at_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Lte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.", "examples": [ null, "2025-05-25" ] }, "discovered_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Max Age Days", "description": "If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_min_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Min Age Days", "description": "If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_gte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Gte", "description": "Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "discovered_at_lte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Lte", "description": "Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "job_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Or", "description": "Regex patterns to look for in job descriptions. Case-insensitive. Results will include jobs whose description matches any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Not", "description": "Regex patterns to look for in job descriptions. Results will include jobs whose description don't match any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_is_case_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Job Description Pattern Is Case Insensitive", "description": "Whether to make searches on job descriptions case-sensitive or insensitive. Deprecated field and won't work, use job_description_pattern_case_sensitive_or instead.", "default": true, "deprecated": true, "examples": [ null, true, false ] }, "job_description_contains_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Or", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_contains_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Not", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_pattern_case_sensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Case Sensitive Or", "description": "Regex patterns to look for in job descriptions. Case-sensitive. If patterns are uppercase, they will be searched case-sensitively. Results will include jobs whose description matches any of these patterns.", "default": [], "examples": [ [], [ "Python", "JavaScript" ], [ "API", "REST" ] ] }, "remote": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remote", "description": "True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.", "examples": [ null, true, false ] }, "only_jobs_with_reports_to": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Reports To", "description": "Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.", "deprecated": true, "examples": [ null, true, false ] }, "reports_to_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Reports To Exists", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "final_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Final Url Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "only_jobs_with_hiring_managers": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Hiring Managers", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "hiring_managers_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hiring Managers Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "job_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Or", "description": "Get jobs with these IDs only.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Not", "description": "Exclude jobs with these IDs.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_ids": { "items": { "type": "integer" }, "type": "array", "title": "Job Ids", "description": "Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.", "default": [], "deprecated": true }, "job_seniority_or": { "items": { "type": "string", "enum": [ "c_level", "staff", "senior", "junior", "mid_level" ] }, "type": "array", "title": "Job Seniority Or", "description": "Will return jobs where the seniority is any of the ones passed here", "default": [], "examples": [ [], [ "intern", "entry", "mid", "senior", "principal" ] ] }, "min_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Salary Usd", "description": "Minimum annual salary in USD. For example, 100000 means $100,000.", "examples": [ null, 100000, 150000 ] }, "max_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Salary Usd", "description": "Maximum annual salary in USD. For example, 150000 means $150,000.", "examples": [ null, 100000, 150000 ] }, "job_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Or", "description": "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.", "default": [] }, "job_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Not", "description": "Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug And", "description": "Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Or", "description": "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. Use this to find jobs in specific cities, states, or regions.", "default": [], "examples": [ [], [ "san francisco" ], [ "california", "new york" ], [ "madrid" ] ] }, "job_location_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Not", "description": "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.", "default": [], "examples": [ [], [ "new york", "california" ], [ "madrid" ] ] }, "job_location_or": { "items": { "properties": { "id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Id", "description": "Filter by location id. You can discover all the locations from the locations catalog endpoint [GET /v0/catalog/locations](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0)", "examples": [ 3117735 ] } }, "type": "object", "title": "JobLocationFilter" }, "type": "array", "title": "Job Location Or", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "job_location_not": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Not", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "url_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Or", "description": "Include jobs only if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "url_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Not", "description": "Exclude jobs if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "scraper_name_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Scraper Name Pattern Or", "description": "Regex patterns to match job sources. Case-insensitive.", "default": [], "deprecated": true }, "easy_apply": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Easy Apply", "description": "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.", "examples": [ null, true, false ] }, "employment_statuses_or": { "anyOf": [ { "items": { "type": "string", "enum": [ "full_time", "part_time", "temporary", "internship", "contract", "freelance", "co_founder", "apprenticeship", "seasonal", "volunteer", "other" ], "title": "Commitment" }, "type": "array" }, { "type": "null" } ], "title": "Employment Statuses Or", "description": "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.", "examples": [ [], [ "full_time" ], [ "full_time", "part_time" ] ] } }, "additionalProperties": false, "type": "object", "title": "JobFilters" }, { "type": "null" } ] }, "tech_filters": { "anyOf": [ { "properties": { "technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Slug Or", "description": "Will return jobs from companies that that have 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)", "default": [] }, "technology_category_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Category Slug Or", "description": "Will return jobs from companies that that have mentioned any technology from any of these categories in their jobs Case sensitive. Pass slugs. Check out all the technology categories we track at [GET /v0/catalog/technologies/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_categories_v0)", "default": [] }, "technology_parent_category_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Parent Category Slug Or", "description": "Will return jobs from companies that that have mentioned any technology from any of these parent categories in their jobs Case sensitive. Pass slugs. Check out all the technology parent categories we track at [GET /v0/catalog/technologies/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_categories_v0)", "default": [] }, "max_rank": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Rank", "description": "The rank measures how common is a technology within its category. The technology most used among similar ones by a company will have a rank of 1, the second: 2, etc. This is useful to filter results by technology and get only results for the primary technology. ", "examples": [ null ] }, "min_jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Jobs", "description": "Minimum number of jobs found by each company using a technology", "examples": [ null ] }, "max_jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Jobs", "description": "Maximum number of jobs found by each company using a technology", "examples": [ null ] }, "min_relative_occurrence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Relative Occurrence", "description": "Minimum value of relative_occurrence_within_category for each technology. Higher values increase the probability that this technology is actually used by the company, because it means a higher percentage of mentions to technologies among this category are of this technology.", "examples": [ null ] }, "first_date_found_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "First Date Found Gte", "description": "Only return technologies where the first time they were found was after or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "first_date_found_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "First Date Found Lte", "description": "Only return technologies where the first time they were found was before or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "last_date_found_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Date Found Gte", "description": "Only return technologies where the last time they were found was after or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "last_date_found_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Date Found Lte", "description": "Only return technologies where the last time they were found was before or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "confidence_or": { "items": { "type": "string", "enum": [ "low", "medium", "high" ] }, "type": "array", "title": "Confidence Or", "description": "Returns technologies with any of these confidence values that the companies use them. Available values: \"high\", \"medium\", \"low\"", "default": [] } }, "type": "object", "title": "TechnographicsTechnologyFilters" }, { "type": "null" } ] } }, "additionalProperties": false, "type": "object", "title": "CompanySearchFilters" }, "examples": { "us_companies": { "summary": "US companies", "value": { "order_by": [ { "desc": true, "field": "employee_count" } ], "page": 0, "limit": 25, "company_country_code_or": [ "US" ] } }, "us_companies_using_snowflake": { "summary": "US companies using Snowflake", "value": { "order_by": [ { "desc": true, "field": "employee_count" } ], "page": 0, "limit": 25, "company_technology_slug_or": [ "snowflake" ] } }, "startups_with_recent_funding": { "summary": "Companies with $1M - $10M in funding", "value": { "order_by": [ { "desc": true, "field": "total_funding_usd" } ], "page": 0, "limit": 25, "min_funding_usd": 1000000, "max_funding_usd": 10000000 } }, "companies_hiring_software_engineers_recently": { "summary": "Companies hiring software engineers in the last 30 days", "value": { "order_by": [ { "desc": true, "field": "employee_count" } ], "page": 0, "limit": 25, "job_filters": { "job_title_or": [], "job_title_not": [], "job_title_pattern_and": [], "job_title_pattern_or": [ "software engineer" ], "job_title_pattern_not": [], "job_country_code_or": [], "job_country_code_not": [], "posted_at_gte": "2026-01-10", "job_description_pattern_or": [], "job_description_pattern_not": [], "job_description_pattern_is_case_insensitive": true, "job_description_contains_or": [], "job_description_contains_not": [], "job_description_pattern_case_sensitive_or": [], "job_id_or": [], "job_id_not": [], "job_ids": [], "job_seniority_or": [], "job_technology_slug_or": [], "job_technology_slug_not": [], "job_technology_slug_and": [], "job_location_pattern_or": [], "job_location_pattern_not": [], "job_location_or": [], "job_location_not": [], "url_domain_or": [], "url_domain_not": [], "scraper_name_pattern_or": [] } } }, "ai_companies_with_recent_job_postings": { "summary": "AI companies with recent job postings", "value": { "order_by": [ { "desc": true, "field": "employee_count" } ], "page": 0, "limit": 25, "company_description_pattern_or": [ "artificial intelligence", "machine learning", "deep learning", "neural networks", "reinforcement learning", "natural language processing", "computer vision", "generative models", "transformer models", "\\bllms?\\b", "\\bnlp\\b" ], "job_filters": { "job_title_or": [], "job_title_not": [], "job_title_pattern_and": [], "job_title_pattern_or": [], "job_title_pattern_not": [], "job_country_code_or": [], "job_country_code_not": [], "posted_at_max_age_days": 30, "job_description_pattern_or": [], "job_description_pattern_not": [], "job_description_pattern_is_case_insensitive": true, "job_description_contains_or": [], "job_description_contains_not": [], "job_description_pattern_case_sensitive_or": [], "job_id_or": [], "job_id_not": [], "job_ids": [], "job_seniority_or": [], "job_technology_slug_or": [], "job_technology_slug_not": [], "job_technology_slug_and": [], "job_location_pattern_or": [], "job_location_pattern_not": [], "job_location_or": [], "job_location_not": [], "url_domain_or": [], "url_domain_not": [], "scraper_name_pattern_or": [] } } }, "companies_using_react_recently_with_high_confidence": { "summary": "Companies that started using or showing interest in React lately", "value": { "order_by": [ { "desc": true, "field": "employee_count" } ], "page": 0, "limit": 25, "company_technology_slug_or": [ "react" ], "tech_filters": { "technology_slug_or": [], "technology_category_slug_or": [], "technology_parent_category_slug_or": [], "confidence_or": [ "high" ] } } }, "companies_using_aws_and_react": { "summary": "Companies using both AWS and React", "value": { "order_by": [ { "desc": true, "field": "employee_count" } ], "page": 0, "limit": 25, "company_technology_slug_and": [ "aws", "react" ] } }, "large_companies_in_finance": { "summary": "Large companies in the finance sector", "value": { "order_by": [ { "desc": true, "field": "annual_revenue_usd" } ], "page": 0, "limit": 25, "min_employee_count": 10000, "industry_id_or": [ 43 ] } }, "companies_with_yc_backing": { "summary": "Y Combinator backed companies", "value": { "order_by": [ { "desc": true, "field": "employee_count" } ], "page": 0, "limit": 25, "only_yc_companies": true } }, "default_params": { "summary": "All available parameters", "value": { "expand_technology_slugs": [], "order_by": [ { "desc": true, "field": "employee_count" } ], "company_name_or": [], "company_name_case_insensitive_or": [], "company_id_or": [], "company_domain_or": [], "company_domain_not": [], "company_name_not": [], "company_name_partial_match_or": [], "company_name_partial_match_not": [], "company_linkedin_url_or": [], "blur_company_data": false, "property_exists_or": [], "property_exists_and": [], "offset": 0, "page": 0, "limit": 25, "company_description_pattern_or": [], "company_description_pattern_not": [], "company_description_pattern_accent_insensitive": false, "funding_stage_or": [], "industry_or": [], "industry_not": [], "industry_id_or": [], "industry_id_not": [], "company_tags_or": [], "company_investors_or": [], "company_investors_partial_match_or": [], "company_technology_slug_or": [], "company_technology_slug_and": [], "company_technology_slug_not": [], "only_yc_companies": false, "company_location_pattern_or": [], "company_country_code_or": [], "company_country_code_not": [], "company_list_id_or": [], "company_list_id_not": [], "include_total_results": false, "job_filters": { "job_title_or": [], "job_title_not": [], "job_title_pattern_and": [], "job_title_pattern_or": [], "job_title_pattern_not": [], "job_country_code_or": [], "job_country_code_not": [], "job_description_pattern_or": [], "job_description_pattern_not": [], "job_description_pattern_is_case_insensitive": true, "job_description_contains_or": [], "job_description_contains_not": [], "job_description_pattern_case_sensitive_or": [], "job_id_or": [], "job_id_not": [], "job_ids": [], "job_seniority_or": [], "job_technology_slug_or": [], "job_technology_slug_not": [], "job_technology_slug_and": [], "job_location_pattern_or": [], "job_location_pattern_not": [], "job_location_or": [], "job_location_not": [], "url_domain_or": [], "url_domain_not": [], "scraper_name_pattern_or": [] }, "tech_filters": { "technology_slug_or": [], "technology_category_slug_or": [], "technology_parent_category_slug_or": [], "confidence_or": [] } } } } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "metadata": { "properties": { "total_results": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Results", "description": "Total number of results", "examples": [ 2034 ] }, "truncated_results": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Truncated Results", "description": "Number of results that were not returned because the user doesn't have enough credits to fetch them all the possible results the API could have returned", "default": 0 }, "truncated_companies": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Truncated Companies", "description": "Number of companies that were not returned because the user doesn't have enough credits to fetch all the possible results the API could have returned", "default": 0 }, "total_companies": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Companies", "description": "Total number of companies", "examples": [ 1045 ] } }, "type": "object", "title": "Metadata" }, "data": { "items": { "properties": { "id": { "type": "string", "title": "Id", "description": "Company ID", "examples": [ "google" ] }, "name": { "type": "string", "title": "Name", "description": "Company name", "examples": [ "Google" ] }, "domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Domain", "description": "Company domain", "examples": [ "google.com" ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Industry", "description": "Industry of the company", "examples": [ "internet" ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country", "description": "Country of the company's HQ", "examples": [ "United States" ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Code", "description": "ISO2 country code. E.g. \"US\"" }, "employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Employee Count", "description": "Number of employees of the company", "examples": [ 7543 ] }, "logo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logo", "description": "Stable CDN-hosted company logo URL suitable for display in applications", "examples": [ "https://example.com/logo.png" ] }, "num_jobs": { "type": "integer", "title": "Num Jobs", "description": "Number of jobs from this company in our database", "default": 0, "examples": [ 746 ] }, "num_technologies": { "type": "integer", "title": "Num Technologies", "description": "Number of technologies mentioned in the jobs of this company", "default": 0, "examples": [ 746 ] }, "possible_domains": { "items": { "type": "string" }, "type": "array", "title": "Possible Domains", "description": "List of possible domains for the company", "default": [] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url", "description": "Company domain. Same as the \"domain\" field. Will be deprecated in the future.", "examples": [ "google.com" ] }, "industry_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Industry Id", "description": "Code of the industry. One of LinkedIn's Industry Codes V2 from https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2" }, "linkedin_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Linkedin Url", "examples": [ "http://www.linkedin.com/company/google" ] }, "num_jobs_last_30_days": { "type": "integer", "title": "Num Jobs Last 30 Days", "description": "Number of jobs from this company in our database posted in the last 30 days", "default": 0, "examples": [ 34 ] }, "num_jobs_found": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Num Jobs Found", "description": "When filtering companies by jobs, number of jobs found for this company", "examples": [ 23 ] }, "yc_batch": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Yc Batch", "description": "If the company went through YC, this is its batch", "examples": [ "W21" ] }, "apollo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Apollo Id", "description": "ID of the company in Apollo", "examples": [ "5b839bd0324d4445051f9a5a" ] }, "linkedin_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Linkedin Id", "description": "ID of the company in LinkedIn" }, "url_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url Source", "description": "Source of the company URL" }, "is_recruiting_agency": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Recruiting Agency", "description": "Is a recruiting agency" }, "founded_year": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Founded Year", "description": "Year the company was founded", "examples": [ 2019 ] }, "annual_revenue_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Annual Revenue Usd", "description": "Annual revenue of the company in USD", "examples": [ 189000000 ] }, "annual_revenue_usd_readable": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Annual Revenue Usd Readable", "description": "Annual revenue of the company in USD, formated as an easily readable string", "examples": [ "189M" ] }, "total_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Funding Usd", "description": "Funding of the company in USD", "examples": [ 500000 ] }, "last_funding_round_date": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date", "description": "Date of the last funding round of the company", "examples": [ "2020-01-01" ] }, "last_funding_round_amount_readable": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Funding Round Amount Readable", "description": "Amount of the last funding round of the company, formated as an easily readable string", "examples": [ "$1.2M" ] }, "employee_count_range": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Employee Count Range", "description": "Number range of employees at the company", "examples": [ "1001-5000" ] }, "long_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Long Description", "description": "Short description of the company", "examples": [ "Google is a California-based multinational technology company that offers internet-related services such as a search engine, online advertising and cloud computing." ] }, "seo_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Seo Description", "description": "SEO description of the company, extracted from their website" }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "City", "description": "City of the company's HQ", "examples": [ "Mountain View" ] }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Postal Code", "description": "Postal code of the company's HQ", "examples": [ "28040" ] }, "company_keywords": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Company Keywords", "description": "Company keywords, related to what the company does" }, "alexa_ranking": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Alexa Ranking", "description": "Alexa ranking", "examples": [ 1 ] }, "publicly_traded_symbol": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Publicly Traded Symbol", "examples": [ "GOOG" ] }, "publicly_traded_exchange": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Publicly Traded Exchange", "examples": [ "NASDAQ" ] }, "investors": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Investors", "description": "List of investors in this company" }, "funding_stage": { "anyOf": [ { "type": "string", "enum": [ "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" ], "title": "FundingStage" }, { "type": "null" } ], "description": "Latest funding stage of the company" }, "has_blurred_data": { "type": "boolean", "title": "Has Blurred Data", "description": "Whether the returned object has company identifiable data blurred or not", "default": false }, "technology_slugs": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Technology Slugs", "description": "slugs of the technologies found to be used by the company", "examples": [ [ "kafka", "elasticsearch" ] ] }, "technology_names": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Technology Names", "description": "Names of the technologies found to be used by the company", "deprecated": true, "examples": [ [ "Kafka", "Elasticsearch" ] ] }, "technologies_found": { "items": { "properties": { "technology": { "properties": { "name": { "type": "string", "title": "Name", "examples": [ "PostgreSQL" ] }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category", "description": "Category of the technology", "examples": [ "Relational Database" ] }, "slug": { "type": "string", "title": "Slug", "description": "Slug of the technology", "examples": [ "kafka", "snowflake" ] }, "category_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category Slug", "description": "Slug of the category of the technology", "examples": [ "message-queue" ] }, "parent_category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Category", "description": "Parent category of the technology", "examples": [ "Data Stores" ] }, "parent_category_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Category Slug", "description": "Slug of the parent category of the technology", "examples": [ "data-stores" ] }, "logo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logo", "description": "Logo of the technology" }, "logo_thumbnail": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logo Thumbnail", "description": "Thumbnail of the technology" } }, "type": "object", "required": [ "name", "slug" ], "title": "KeywordExtended" }, "confidence": { "type": "string", "enum": [ "low", "medium", "high" ], "title": "Confidence", "description": "How confident we are that the company uses this technology" }, "jobs": { "type": "integer", "title": "Jobs", "description": "Number of jobs found mentioning this technology", "examples": [ 54 ] }, "jobs_last_7_days": { "type": "integer", "title": "Jobs Last 7 Days", "description": "Number of jobs from the given company mentioning this technology in the last 7 days" }, "jobs_last_30_days": { "type": "integer", "title": "Jobs Last 30 Days", "description": "Number of jobs from the given company mentioning this technology in the last 30 days" }, "jobs_last_180_days": { "type": "integer", "title": "Jobs Last 180 Days", "description": "Number of jobs from the given company mentioning this technology in the last 180 days" }, "first_date_found": { "type": "string", "format": "date", "title": "First Date Found", "description": "Date when the keyword was first mentioned by the company in a job post" }, "last_date_found": { "type": "string", "format": "date", "title": "Last Date Found", "description": "Date when the keyword was last mentioned by the company in a job post" }, "rank_within_category": { "type": "integer", "title": "Rank Within Category", "description": "Measures how common this technology is among the company's jobs, compared to other technologies in the same category. The most mentioned technology in its category will have a rank of 1. This helps you infer which is the technology the company is most likely to be using, when they mention several technologies that belong to the same category." }, "relative_occurrence_within_category": { "type": "number", "title": "Relative Occurrence Within Category", "description": "Measures the relative occurance of this technology among other technologies in the same category, in jobs by this company. If there are 10 jobs where a company mentions 3 categories, and they appear in 8, 3 and 2 jobs respectively, its relative occurrences will be 0.8, 0.3 and 0.2. This helps you infer how likely it is that the company is using this technology, when they mention several technologies that belong to the same category." }, "theirstack_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Theirstack Score", "description": "[DEPRECATED] This is a score we assign to every technology used by each company to assess how likely it is that they're using it, combining the value of `jobs` and `relative_occurrence_within_category`. The higher this value is, the higher the chances that the company uses this technology. Values lower than 1 mean it's not very likely they use it. Then, the higher the value of theirstack_score, the more likely it is that they actually use it.", "deprecated": true }, "company_name": { "type": "string", "title": "Company Name", "description": "Company name. This field is deprecated, please don't use it", "deprecated": true, "examples": [ "Google" ] } }, "type": "object", "required": [ "technology", "confidence", "jobs", "jobs_last_7_days", "jobs_last_30_days", "jobs_last_180_days", "first_date_found", "last_date_found", "rank_within_category", "relative_occurrence_within_category", "company_name" ], "title": "KeywordFound" }, "type": "array", "title": "Technologies Found", "description": "List of technologies found to be used by the company, relevant to the current search", "default": [] }, "jobs_found": { "items": { "properties": { "id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Id", "description": "ID of the job", "examples": [ 1234 ] }, "job_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Title", "description": "Job title", "examples": [ "Senior Data Engineer" ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url", "description": "URL of the job post", "examples": [ "https://example.com/job/1234" ] }, "date_posted": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Date Posted", "description": "Date when the job was posted", "examples": [ "2021-01-01" ] }, "has_blurred_data": { "type": "boolean", "title": "Has Blurred Data", "description": "Whether the returned object has company identifiable data blurred or not", "default": false }, "company": { "type": "string", "title": "Company" } }, "type": "object", "required": [ "company" ], "title": "JobBaseOut" }, "type": "array", "title": "Jobs Found", "description": "List of the last 5 jobs posted by the company, relevant to the current search", "default": [] } }, "type": "object", "required": [ "id", "name" ], "title": "CompanyWithTechnologiesAndJobs" }, "type": "array", "title": "Data" } }, "type": "object", "required": [ "metadata", "data" ], "title": "CompanySearchResponse" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } } }, "security": [ { "Bearer": [] } ] } ``` --- title: Technographics description: This endpoint lists the technologies used by a company. For each technology, it returns the confidence level (`low`, `medium`, `high`), the number of jobs that mention the technology, and the first and last dates it was mentioned. url: https://theirstack.com/en/docs/api-reference/companies/technographics_v1 --- You must specify `company_domain`, `company_name`, `company_linkedin_url`. It consumes **3 API credits** per company lookup, regardless of the number of technologies returned. It doesn't consume credits if there is no response. ## OpenAPI Specification ```json { "path": "/v1/companies/technologies", "method": "POST", "tags": [ "Companies" ], "summary": "Technographics", "description": "This endpoint lists the technologies used by a company. For each technology, it returns the confidence level (`low`, `medium`, `high`), the number of jobs that mention the technology, and the first and last dates it was mentioned.\n\nYou must specify `company_domain`, `company_name`, `company_linkedin_url`.\n\nIt consumes **3 API credits** per company lookup, regardless of the number of technologies returned. It doesn't consume credits if there is no response.", "operationId": "technographics_v1", "requestBody": { "content": { "application/json": { "schema": { "properties": { "company_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Company Id", "description": "Only return companies that match this TheirStack Company ID exactly. This ID is temporary and internal and will change in the future and become stable. Until then, it is only meant to be used internally by our UI (app.theirstack.com). For deduplication logic, use company_domain or company_linkedin_url instead.", "examples": [ null, "1234567890" ] }, "company_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Company Name", "description": "Only return companies that match this name exactly, case-sensitively.", "examples": [ null, "Google", "Stripe" ] }, "company_domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Company Domain", "description": "Only return companies that match this domain exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "examples": [ null, "google.com", "https://www.google.com/", "andrew@stripe.com" ] }, "company_linkedin_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Company Linkedin Url", "description": "Return companies whose LinkedIn URL matches this URL exactly.", "examples": [ null, "https://www.linkedin.com/company/openai/", "https://www.linkedin.com/company/google/" ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "Only return companies that match these names exactly, case-sensitively. Deprecated, use the `company_name` filter instead.", "default": [], "deprecated": true, "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "order_by": { "items": { "properties": { "desc": { "type": "boolean", "title": "Desc", "description": "Whether to order by descending or ascending values", "default": true }, "field": { "enum": [ null, "jobs", "jobs_last_7_days", "jobs_last_30_days", "jobs_last_180_days", "last_date_found", "first_date_found", "relative_occurrence_within_category", "theirstack_score", "confidence" ], "title": "Field", "description": "Order the results by some of these fields" } }, "additionalProperties": false, "type": "object", "title": "ColumnSortCompanyTechDetails" }, "type": "array", "title": "Order By", "description": "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.", "default": [ { "desc": true, "field": "confidence" }, { "desc": true, "field": "jobs" } ] }, "include_total_results": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Include Total Results", "description": "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.", "default": false }, "offset": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "examples": [ null, 0 ] }, "page": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "examples": [ null, 0 ] }, "limit": { "anyOf": [ { "type": "integer", "minimum": 1 }, { "type": "null" } ], "title": "Limit", "description": "Number of results per page", "examples": [ null, 50, 500 ] }, "technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Slug Or", "description": "Will return jobs from companies that that have 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)", "default": [] }, "technology_category_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Category Slug Or", "description": "Will return jobs from companies that that have mentioned any technology from any of these categories in their jobs Case sensitive. Pass slugs. Check out all the technology categories we track at [GET /v0/catalog/technologies/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_categories_v0)", "default": [] }, "technology_parent_category_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Parent Category Slug Or", "description": "Will return jobs from companies that that have mentioned any technology from any of these parent categories in their jobs Case sensitive. Pass slugs. Check out all the technology parent categories we track at [GET /v0/catalog/technologies/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_categories_v0)", "default": [] }, "max_rank": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Rank", "description": "The rank measures how common is a technology within its category. The technology most used among similar ones by a company will have a rank of 1, the second: 2, etc. This is useful to filter results by technology and get only results for the primary technology. ", "examples": [ null ] }, "min_jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Jobs", "description": "Minimum number of jobs found by each company using a technology", "examples": [ null ] }, "max_jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Jobs", "description": "Maximum number of jobs found by each company using a technology", "examples": [ null ] }, "min_relative_occurrence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Relative Occurrence", "description": "Minimum value of relative_occurrence_within_category for each technology. Higher values increase the probability that this technology is actually used by the company, because it means a higher percentage of mentions to technologies among this category are of this technology.", "examples": [ null ] }, "first_date_found_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "First Date Found Gte", "description": "Only return technologies where the first time they were found was after or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "first_date_found_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "First Date Found Lte", "description": "Only return technologies where the first time they were found was before or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "last_date_found_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Date Found Gte", "description": "Only return technologies where the last time they were found was after or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "last_date_found_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Date Found Lte", "description": "Only return technologies where the last time they were found was before or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "confidence_or": { "items": { "type": "string", "enum": [ "low", "medium", "high" ] }, "type": "array", "title": "Confidence Or", "description": "Returns technologies with any of these confidence values that the companies use them. Available values: \"high\", \"medium\", \"low\"", "default": [] } }, "additionalProperties": false, "type": "object", "title": "TechDetailsFilters" }, "examples": { "google_technographics": { "summary": "Technologies used by google.com (Domain)", "value": { "company_domain": "google.com" } }, "databases_used_by_microsoft": { "summary": "Databases used by Microsoft (Name)", "value": { "company_name": "Microsoft", "technology_category_slug_or": [ "relational-databases" ] } }, "open_ai_technographics": { "summary": "Technologies used by OpenAI (LinkedIn URL)", "value": { "company_linkedin_url": "https://www.linkedin.com/company/openai/" } }, "is_apple_using_python": { "summary": "Is Apple using Python?", "value": { "company_domain": "apple.com", "technology_slug_or": [ "python" ] } }, "default_params": { "summary": "All available parameters", "value": { "company_name_or": [ "Google" ], "order_by": [ { "desc": true, "field": "confidence" }, { "desc": true, "field": "jobs" } ], "include_total_results": false, "technology_slug_or": [], "technology_category_slug_or": [], "technology_parent_category_slug_or": [], "confidence_or": [] } } } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "data": { "items": { "properties": { "technology": { "properties": { "name": { "type": "string", "title": "Name", "examples": [ "PostgreSQL" ] }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category", "description": "Category of the technology", "examples": [ "Relational Database" ] }, "slug": { "type": "string", "title": "Slug", "description": "Slug of the technology", "examples": [ "kafka", "snowflake" ] }, "category_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category Slug", "description": "Slug of the category of the technology", "examples": [ "message-queue" ] }, "parent_category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Category", "description": "Parent category of the technology", "examples": [ "Data Stores" ] }, "parent_category_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Category Slug", "description": "Slug of the parent category of the technology", "examples": [ "data-stores" ] }, "logo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logo", "description": "Logo of the technology" }, "logo_thumbnail": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logo Thumbnail", "description": "Thumbnail of the technology" } }, "type": "object", "required": [ "name", "slug" ], "title": "KeywordExtended" }, "confidence": { "type": "string", "enum": [ "low", "medium", "high" ], "title": "Confidence", "description": "How confident we are that the company uses this technology" }, "jobs": { "type": "integer", "title": "Jobs", "description": "Number of jobs found mentioning this technology", "examples": [ 54 ] }, "jobs_last_7_days": { "type": "integer", "title": "Jobs Last 7 Days", "description": "Number of jobs from the given company mentioning this technology in the last 7 days" }, "jobs_last_30_days": { "type": "integer", "title": "Jobs Last 30 Days", "description": "Number of jobs from the given company mentioning this technology in the last 30 days" }, "jobs_last_180_days": { "type": "integer", "title": "Jobs Last 180 Days", "description": "Number of jobs from the given company mentioning this technology in the last 180 days" }, "first_date_found": { "type": "string", "format": "date", "title": "First Date Found", "description": "Date when the keyword was first mentioned by the company in a job post" }, "last_date_found": { "type": "string", "format": "date", "title": "Last Date Found", "description": "Date when the keyword was last mentioned by the company in a job post" }, "rank_within_category": { "type": "integer", "title": "Rank Within Category", "description": "Measures how common this technology is among the company's jobs, compared to other technologies in the same category. The most mentioned technology in its category will have a rank of 1. This helps you infer which is the technology the company is most likely to be using, when they mention several technologies that belong to the same category." }, "relative_occurrence_within_category": { "type": "number", "title": "Relative Occurrence Within Category", "description": "Measures the relative occurance of this technology among other technologies in the same category, in jobs by this company. If there are 10 jobs where a company mentions 3 categories, and they appear in 8, 3 and 2 jobs respectively, its relative occurrences will be 0.8, 0.3 and 0.2. This helps you infer how likely it is that the company is using this technology, when they mention several technologies that belong to the same category." }, "theirstack_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Theirstack Score", "description": "[DEPRECATED] This is a score we assign to every technology used by each company to assess how likely it is that they're using it, combining the value of `jobs` and `relative_occurrence_within_category`. The higher this value is, the higher the chances that the company uses this technology. Values lower than 1 mean it's not very likely they use it. Then, the higher the value of theirstack_score, the more likely it is that they actually use it.", "deprecated": true }, "company_name": { "type": "string", "title": "Company Name", "description": "Company name. This field is deprecated, please don't use it", "deprecated": true, "examples": [ "Google" ] } }, "type": "object", "required": [ "technology", "confidence", "jobs", "jobs_last_7_days", "jobs_last_30_days", "jobs_last_180_days", "first_date_found", "last_date_found", "rank_within_category", "relative_occurrence_within_category", "company_name" ], "title": "KeywordFound" }, "type": "array", "title": "Data" }, "metadata": { "properties": { "total_results": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Results", "description": "Total number of results", "examples": [ 2034 ] }, "truncated_results": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Truncated Results", "description": "Number of results that were not returned because the user doesn't have enough credits to fetch them all the possible results the API could have returned", "default": 0 }, "truncated_companies": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Truncated Companies", "description": "Number of companies that were not returned because the user doesn't have enough credits to fetch all the possible results the API could have returned", "default": 0 }, "total_companies": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Companies", "description": "Total number of companies", "examples": [ 1045 ] } }, "type": "object", "title": "Metadata" } }, "type": "object", "required": [ "data", "metadata" ], "title": "CompanyTechDetailsResponse" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } } }, "security": [ { "Bearer": [] } ] } ``` --- title: Get Credits Consumption description: Get the API records returned per day url: https://theirstack.com/en/docs/api-reference/credit-consumption/get_teams_credits_consumption_v0 --- ## OpenAPI Specification ```json { "path": "/v0/teams/credits_consumption", "method": "GET", "tags": [ "Credit Consumption" ], "summary": "Get Credits Consumption", "description": "Get the API records returned per day", "operationId": "get_teams_credits_consumption_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "start_datetime", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "description": "Start datetime in ISO format (e.g., 2023-01-01T00:00:00)", "title": "Start Datetime" }, "description": "Start datetime in ISO format (e.g., 2023-01-01T00:00:00)" }, { "name": "end_datetime", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "description": "End datetime in ISO format (e.g., 2023-01-01T23:59:59)", "title": "End Datetime" }, "description": "End datetime in ISO format (e.g., 2023-01-01T23:59:59)" }, { "name": "timezone", "in": "query", "required": false, "schema": { "type": "string", "description": "IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')", "default": "UTC", "title": "Timezone" }, "description": "IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "period_start": { "type": "string", "format": "date-time", "title": "Period Start", "description": "Start of the period." }, "api_credits_consumed": { "type": "integer", "title": "Api Credits Consumed", "description": "Number of API credits consumed." }, "ui_credits_consumed": { "type": "integer", "title": "Ui Credits Consumed", "description": "Number of UI credits consumed." } }, "type": "object", "required": [ "period_start", "api_credits_consumed", "ui_credits_consumed" ], "title": "CreditsConsumption" }, "title": "Response Get Teams Credits Consumption V0" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Delete Company List description: undefined url: https://theirstack.com/en/docs/api-reference/company-lists/delete_company_lists_by_id_v0 --- ## OpenAPI Specification ```json { "path": "/v0/company_lists/{list_id}", "method": "DELETE", "tags": [ "Company Lists" ], "summary": "Delete Company List", "operationId": "delete_company_lists_by_id_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "list_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "List Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Get List description: undefined url: https://theirstack.com/en/docs/api-reference/company-lists/get_company_lists_by_id_v0 --- ## OpenAPI Specification ```json { "path": "/v0/company_lists/{list_id}", "method": "GET", "tags": [ "Company Lists" ], "summary": "Get List", "operationId": "get_company_lists_by_id_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "list_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "List Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "name": { "type": "string", "title": "Name", "description": "Name of the company list" }, "id": { "type": "integer", "title": "Id" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "deletable": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Deletable", "description": "Whether the list can be deleted" }, "companies_count": { "type": "integer", "title": "Companies Count", "description": "Number of companies in the list", "default": 0 }, "user_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "User Id", "description": "User ID of the list owner" }, "type": { "anyOf": [ { "type": "string", "enum": [ "REVEALED_COMPANIES", "WEBHOOK_TRIGGERED", "MANUAL_CREATION" ], "title": "CompanyListType" }, { "type": "null" } ], "description": "Type of the list: MANUAL_CREATION, WEBHOOK_TRIGGERED, REVEALED_COMPANIES" }, "webhook_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Webhook Id", "description": "Webhook ID of the list" } }, "type": "object", "required": [ "name", "id", "created_at" ], "title": "CompanyList" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Export Companies From List description: Export companies from a list to a CSV or XLSX file url: https://theirstack.com/en/docs/api-reference/company-lists/get_company_lists_companies_export_v0 --- ## OpenAPI Specification ```json { "path": "/v0/company_lists/{list_id}/companies/export", "method": "GET", "tags": [ "Company Lists" ], "summary": "Export Companies From List", "description": "Export companies from a list to a CSV or XLSX file", "operationId": "get_company_lists_companies_export_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "list_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "List Id" } }, { "name": "file_format", "in": "query", "required": false, "schema": { "enum": [ "csv", "xlsx" ], "type": "string", "description": "Export format", "default": "csv", "title": "File Format" }, "description": "Export format" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Number of results per page", "default": 25, "title": "Limit" }, "description": "Number of results per page" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "title": "Page" }, "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination)." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "title": "Offset" }, "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination)." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "title": "Url", "description": "The URL of the file with the companies report." } }, "type": "object", "required": [ "url" ], "title": "CompanyListExportResponse" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Get Companies From List description: undefined url: https://theirstack.com/en/docs/api-reference/company-lists/get_company_lists_companies_v0 --- ## OpenAPI Specification ```json { "path": "/v0/company_lists/{list_id}/companies", "method": "GET", "tags": [ "Company Lists" ], "summary": "Get Companies From List", "operationId": "get_company_lists_companies_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "list_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "List Id" } }, { "name": "order_by", "in": "query", "required": false, "schema": { "enum": [ "revealed_at", "name" ], "type": "string", "description": "Order by field", "default": "revealed_at", "title": "Order By" }, "description": "Order by field" }, { "name": "order_direction", "in": "query", "required": false, "schema": { "enum": [ "asc", "desc" ], "type": "string", "description": "Order direction", "default": "desc", "title": "Order Direction" }, "description": "Order direction" }, { "name": "company_name_partial", "in": "query", "required": false, "schema": { "type": "string", "description": "Pass a partial company name to filter the list of companies", "title": "Company Name Partial" }, "description": "Pass a partial company name to filter the list of companies" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "description": "Number of results per page", "default": 25, "title": "Limit" }, "description": "Number of results per page" }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "title": "Page" }, "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination)." }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "title": "Offset" }, "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination)." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "company_name": { "type": "string", "title": "Company Name" }, "added_at": { "type": "string", "format": "date-time", "title": "Added At", "description": "Date when the company was added to the list." }, "revealed_at": { "type": "string", "format": "date-time", "title": "Revealed At", "description": "Date when the company was revealed." }, "company_object": { "properties": { "id": { "type": "string", "title": "Id", "description": "Company ID", "examples": [ "google" ] }, "name": { "type": "string", "title": "Name", "description": "Company name", "examples": [ "Google" ] }, "domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Domain", "description": "Company domain", "examples": [ "google.com" ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Industry", "description": "Industry of the company", "examples": [ "internet" ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country", "description": "Country of the company's HQ", "examples": [ "United States" ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Code", "description": "ISO2 country code. E.g. \"US\"" }, "employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Employee Count", "description": "Number of employees of the company", "examples": [ 7543 ] }, "logo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logo", "description": "Stable CDN-hosted company logo URL suitable for display in applications", "examples": [ "https://example.com/logo.png" ] }, "num_jobs": { "type": "integer", "title": "Num Jobs", "description": "Number of jobs from this company in our database", "default": 0, "examples": [ 746 ] }, "num_technologies": { "type": "integer", "title": "Num Technologies", "description": "Number of technologies mentioned in the jobs of this company", "default": 0, "examples": [ 746 ] }, "possible_domains": { "items": { "type": "string" }, "type": "array", "title": "Possible Domains", "description": "List of possible domains for the company", "default": [] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url", "description": "Company domain. Same as the \"domain\" field. Will be deprecated in the future.", "examples": [ "google.com" ] }, "industry_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Industry Id", "description": "Code of the industry. One of LinkedIn's Industry Codes V2 from https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2" }, "linkedin_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Linkedin Url", "examples": [ "http://www.linkedin.com/company/google" ] }, "num_jobs_last_30_days": { "type": "integer", "title": "Num Jobs Last 30 Days", "description": "Number of jobs from this company in our database posted in the last 30 days", "default": 0, "examples": [ 34 ] }, "num_jobs_found": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Num Jobs Found", "description": "When filtering companies by jobs, number of jobs found for this company", "examples": [ 23 ] }, "yc_batch": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Yc Batch", "description": "If the company went through YC, this is its batch", "examples": [ "W21" ] }, "apollo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Apollo Id", "description": "ID of the company in Apollo", "examples": [ "5b839bd0324d4445051f9a5a" ] }, "linkedin_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Linkedin Id", "description": "ID of the company in LinkedIn" }, "url_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url Source", "description": "Source of the company URL" }, "is_recruiting_agency": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Recruiting Agency", "description": "Is a recruiting agency" }, "founded_year": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Founded Year", "description": "Year the company was founded", "examples": [ 2019 ] }, "annual_revenue_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Annual Revenue Usd", "description": "Annual revenue of the company in USD", "examples": [ 189000000 ] }, "annual_revenue_usd_readable": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Annual Revenue Usd Readable", "description": "Annual revenue of the company in USD, formated as an easily readable string", "examples": [ "189M" ] }, "total_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Funding Usd", "description": "Funding of the company in USD", "examples": [ 500000 ] }, "last_funding_round_date": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date", "description": "Date of the last funding round of the company", "examples": [ "2020-01-01" ] }, "last_funding_round_amount_readable": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Funding Round Amount Readable", "description": "Amount of the last funding round of the company, formated as an easily readable string", "examples": [ "$1.2M" ] }, "employee_count_range": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Employee Count Range", "description": "Number range of employees at the company", "examples": [ "1001-5000" ] }, "long_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Long Description", "description": "Short description of the company", "examples": [ "Google is a California-based multinational technology company that offers internet-related services such as a search engine, online advertising and cloud computing." ] }, "seo_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Seo Description", "description": "SEO description of the company, extracted from their website" }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "City", "description": "City of the company's HQ", "examples": [ "Mountain View" ] }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Postal Code", "description": "Postal code of the company's HQ", "examples": [ "28040" ] }, "company_keywords": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Company Keywords", "description": "Company keywords, related to what the company does" }, "alexa_ranking": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Alexa Ranking", "description": "Alexa ranking", "examples": [ 1 ] }, "publicly_traded_symbol": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Publicly Traded Symbol", "examples": [ "GOOG" ] }, "publicly_traded_exchange": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Publicly Traded Exchange", "examples": [ "NASDAQ" ] }, "investors": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Investors", "description": "List of investors in this company" }, "funding_stage": { "anyOf": [ { "type": "string", "enum": [ "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" ], "title": "FundingStage" }, { "type": "null" } ], "description": "Latest funding stage of the company" }, "has_blurred_data": { "type": "boolean", "title": "Has Blurred Data", "description": "Whether the returned object has company identifiable data blurred or not", "default": false }, "technology_slugs": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Technology Slugs", "description": "slugs of the technologies found to be used by the company", "examples": [ [ "kafka", "elasticsearch" ] ] }, "technology_names": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Technology Names", "description": "Names of the technologies found to be used by the company", "deprecated": true, "examples": [ [ "Kafka", "Elasticsearch" ] ] } }, "type": "object", "required": [ "id", "name" ], "title": "CompanyWithTechnologySlugs" } }, "type": "object", "required": [ "company_name", "added_at", "revealed_at", "company_object" ], "title": "CompanyListItem" }, "title": "Response Get Company Lists Companies V0" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: List All Lists description: Get all the lists for the current user url: https://theirstack.com/en/docs/api-reference/company-lists/get_company_lists_v0 --- ## OpenAPI Specification ```json { "path": "/v0/company_lists", "method": "GET", "tags": [ "Company Lists" ], "summary": "List All Lists", "description": "Get all the lists for the current user", "operationId": "get_company_lists_v0", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "properties": { "name": { "type": "string", "title": "Name", "description": "Name of the company list" }, "id": { "type": "integer", "title": "Id" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "deletable": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Deletable", "description": "Whether the list can be deleted" }, "companies_count": { "type": "integer", "title": "Companies Count", "description": "Number of companies in the list", "default": 0 }, "user_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "User Id", "description": "User ID of the list owner" }, "type": { "anyOf": [ { "type": "string", "enum": [ "REVEALED_COMPANIES", "WEBHOOK_TRIGGERED", "MANUAL_CREATION" ], "title": "CompanyListType" }, { "type": "null" } ], "description": "Type of the list: MANUAL_CREATION, WEBHOOK_TRIGGERED, REVEALED_COMPANIES" }, "webhook_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Webhook Id", "description": "Webhook ID of the list" } }, "type": "object", "required": [ "name", "id", "created_at" ], "title": "CompanyList" }, "type": "array", "title": "Response Get Company Lists V0" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } } }, "security": [ { "Bearer": [] } ] } ``` --- title: Rename Company List description: undefined url: https://theirstack.com/en/docs/api-reference/company-lists/patch_company_lists_by_id_v0 --- ## OpenAPI Specification ```json { "path": "/v0/company_lists/{list_id}", "method": "PATCH", "tags": [ "Company Lists" ], "summary": "Rename Company List", "operationId": "patch_company_lists_by_id_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "list_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "List Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "new_name": { "type": "string", "title": "New Name", "description": "New name of the company list" } }, "type": "object", "required": [ "new_name" ], "title": "CompanyListRename" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "name": { "type": "string", "title": "Name", "description": "Name of the company list" }, "id": { "type": "integer", "title": "Id" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "deletable": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Deletable", "description": "Whether the list can be deleted" }, "companies_count": { "type": "integer", "title": "Companies Count", "description": "Number of companies in the list", "default": 0 }, "user_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "User Id", "description": "User ID of the list owner" }, "type": { "anyOf": [ { "type": "string", "enum": [ "REVEALED_COMPANIES", "WEBHOOK_TRIGGERED", "MANUAL_CREATION" ], "title": "CompanyListType" }, { "type": "null" } ], "description": "Type of the list: MANUAL_CREATION, WEBHOOK_TRIGGERED, REVEALED_COMPANIES" }, "webhook_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Webhook Id", "description": "Webhook ID of the list" } }, "type": "object", "required": [ "name", "id", "created_at" ], "title": "CompanyList" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Add Companies To Multiple Lists description: undefined url: https://theirstack.com/en/docs/api-reference/company-lists/post_company_lists_add_companies_multiple_v0 --- ## OpenAPI Specification ```json { "path": "/v0/company_lists/add_companies", "method": "POST", "tags": [ "Company Lists" ], "summary": "Add Companies To Multiple Lists", "operationId": "post_company_lists_add_companies_multiple_v0", "requestBody": { "content": { "application/json": { "schema": { "properties": { "list_ids": { "items": { "type": "integer" }, "type": "array", "title": "List Ids", "description": "List ids to add companies to", "default": [] }, "company_ids": { "items": { "type": "string" }, "type": "array", "title": "Company Ids", "description": "Company IDs (encrypted slugs) to add to the list", "default": [] } }, "type": "object", "title": "Body_post_company_lists_add_companies_multiple_v0" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } } }, "security": [ { "Bearer": [] } ] } ``` --- title: Add Companies To List description: undefined url: https://theirstack.com/en/docs/api-reference/company-lists/post_company_lists_add_companies_v0 --- ## OpenAPI Specification ```json { "path": "/v0/company_lists/{list_id}/add_companies", "method": "POST", "tags": [ "Company Lists" ], "summary": "Add Companies To List", "operationId": "post_company_lists_add_companies_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "list_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "List Id" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "company_ids": { "items": { "type": "string" }, "type": "array", "title": "Company Ids", "description": "Company IDs (encrypted slugs) to add to the list", "default": [], "examples": [ [ "jzZtZUAlXO/EX2wK4o6/Jw==" ], [ "Zhp1blVM6WuoHvhFmHlRww==", "EYu9fMqOIuJkmaLobIjPqA==" ] ] }, "company_names": { "items": { "type": "string" }, "type": "array", "title": "Company Names", "description": "Company names to add to the list. Please don't use this filter anymore, use the `company_ids` filter instead.", "default": [], "deprecated": true } }, "type": "object", "title": "Body_post_company_lists_add_companies_v0" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "name": { "type": "string", "title": "Name", "description": "Name of the company list" }, "id": { "type": "integer", "title": "Id" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "deletable": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Deletable", "description": "Whether the list can be deleted" }, "companies_count": { "type": "integer", "title": "Companies Count", "description": "Number of companies in the list", "default": 0 }, "user_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "User Id", "description": "User ID of the list owner" }, "type": { "anyOf": [ { "type": "string", "enum": [ "REVEALED_COMPANIES", "WEBHOOK_TRIGGERED", "MANUAL_CREATION" ], "title": "CompanyListType" }, { "type": "null" } ], "description": "Type of the list: MANUAL_CREATION, WEBHOOK_TRIGGERED, REVEALED_COMPANIES" }, "webhook_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Webhook Id", "description": "Webhook ID of the list" } }, "type": "object", "required": [ "name", "id", "created_at" ], "title": "CompanyList" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Duplicate List description: undefined url: https://theirstack.com/en/docs/api-reference/company-lists/post_company_lists_duplicate_v0 --- ## OpenAPI Specification ```json { "path": "/v0/company_lists/{list_id}/duplicate", "method": "POST", "tags": [ "Company Lists" ], "summary": "Duplicate List", "operationId": "post_company_lists_duplicate_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "list_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "List Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "name": { "type": "string", "title": "Name", "description": "Name of the company list" }, "id": { "type": "integer", "title": "Id" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "deletable": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Deletable", "description": "Whether the list can be deleted" }, "companies_count": { "type": "integer", "title": "Companies Count", "description": "Number of companies in the list", "default": 0 }, "user_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "User Id", "description": "User ID of the list owner" }, "type": { "anyOf": [ { "type": "string", "enum": [ "REVEALED_COMPANIES", "WEBHOOK_TRIGGERED", "MANUAL_CREATION" ], "title": "CompanyListType" }, { "type": "null" } ], "description": "Type of the list: MANUAL_CREATION, WEBHOOK_TRIGGERED, REVEALED_COMPANIES" }, "webhook_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Webhook Id", "description": "Webhook ID of the list" } }, "type": "object", "required": [ "name", "id", "created_at" ], "title": "CompanyList" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Remove Companies From List description: undefined url: https://theirstack.com/en/docs/api-reference/company-lists/post_company_lists_remove_companies_v0 --- ## OpenAPI Specification ```json { "path": "/v0/company_lists/{list_id}/remove_companies", "method": "POST", "tags": [ "Company Lists" ], "summary": "Remove Companies From List", "operationId": "post_company_lists_remove_companies_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "list_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "List Id" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "company_ids": { "items": { "type": "string" }, "type": "array", "title": "Company Ids", "description": "Company names to remove from the list", "default": [], "examples": [ [ "jzZtZUAlXO/EX2wK4o6/Jw==" ], [ "Zhp1blVM6WuoHvhFmHlRww==", "EYu9fMqOIuJkmaLobIjPqA==" ] ] } }, "type": "object", "title": "Body_post_company_lists_remove_companies_v0" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "name": { "type": "string", "title": "Name", "description": "Name of the company list" }, "id": { "type": "integer", "title": "Id" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "deletable": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Deletable", "description": "Whether the list can be deleted" }, "companies_count": { "type": "integer", "title": "Companies Count", "description": "Number of companies in the list", "default": 0 }, "user_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "User Id", "description": "User ID of the list owner" }, "type": { "anyOf": [ { "type": "string", "enum": [ "REVEALED_COMPANIES", "WEBHOOK_TRIGGERED", "MANUAL_CREATION" ], "title": "CompanyListType" }, { "type": "null" } ], "description": "Type of the list: MANUAL_CREATION, WEBHOOK_TRIGGERED, REVEALED_COMPANIES" }, "webhook_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Webhook Id", "description": "Webhook ID of the list" } }, "type": "object", "required": [ "name", "id", "created_at" ], "title": "CompanyList" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Create Company List description: undefined url: https://theirstack.com/en/docs/api-reference/company-lists/post_company_lists_v0 --- ## OpenAPI Specification ```json { "path": "/v0/company_lists", "method": "POST", "tags": [ "Company Lists" ], "summary": "Create Company List", "operationId": "post_company_lists_v0", "requestBody": { "content": { "application/json": { "schema": { "properties": { "name": { "type": "string", "title": "Name", "description": "Name of the company list" } }, "type": "object", "required": [ "name" ], "title": "CompanyListCreate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "name": { "type": "string", "title": "Name", "description": "Name of the company list" }, "id": { "type": "integer", "title": "Id" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "deletable": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Deletable", "description": "Whether the list can be deleted" }, "companies_count": { "type": "integer", "title": "Companies Count", "description": "Number of companies in the list", "default": 0 }, "user_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "User Id", "description": "User ID of the list owner" }, "type": { "anyOf": [ { "type": "string", "enum": [ "REVEALED_COMPANIES", "WEBHOOK_TRIGGERED", "MANUAL_CREATION" ], "title": "CompanyListType" }, { "type": "null" } ], "description": "Type of the list: MANUAL_CREATION, WEBHOOK_TRIGGERED, REVEALED_COMPANIES" }, "webhook_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Webhook Id", "description": "Webhook ID of the list" } }, "type": "object", "required": [ "name", "id", "created_at" ], "title": "CompanyList" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } } }, "security": [ { "Bearer": [] } ] } ``` --- title: List Datasets description: Get all the datasets available for your team. Datasets are updated daily. Use this endpoint to get the latest dataset url. url: https://theirstack.com/en/docs/api-reference/datasets/get_datasets_v1 --- ## OpenAPI Specification ```json { "path": "/v1/datasets", "method": "GET", "tags": [ "Datasets" ], "summary": "List Datasets", "description": "Get all the datasets available for your team. Datasets are updated daily. Use this endpoint to get the latest dataset url.", "operationId": "get_datasets_v1", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "properties": { "type": { "anyOf": [ { "type": "string", "enum": [ "jobs", "companies", "technologies", "technographics" ] }, { "type": "null" } ], "title": "Type", "description": "Dataset type" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the dataset" }, "is_accessible": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Accessible", "description": "Is this dataset accessible for the user based on their paid plan?" }, "options": { "anyOf": [ { "items": { "properties": { "id": { "type": "string", "title": "Id", "description": "ID of the dataset option" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the dataset option" }, "item_type": { "type": "string", "enum": [ "file", "folder" ], "title": "Item Type", "description": "Type of the dataset option. If it is a folder, it means that the dataset is a folder and the path is the path of the folder. In this case, path will have a value and dataset_url will be null. If it is a file, it means that the dataset is a file and the dataset_url will have a value, and path will be null.", "default": "file" }, "format": { "type": "string", "enum": [ "csv", "parquet" ], "title": "Format", "description": "Format of the dataset" }, "frequency": { "anyOf": [ { "type": "string", "enum": [ "daily", "weekly", "monthly" ], "title": "DatasetUpdateFrequency" }, { "type": "null" } ], "description": "Update frequency of the dataset", "default": "daily" }, "version": { "type": "string", "title": "Version", "description": "Version of the dataset" }, "is_deprecated": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Deprecated", "description": "Is this dataset deprecated? If yes, it means that this dataset is no longer available for download." }, "dataset_prefix": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Dataset Prefix", "description": "S3/R2 path prefix URL for listing and accessing datasets (for use with temporary credentials to list files)" }, "dataset_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Dataset Url", "description": "URL of the dataset" }, "dictionary_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Dictionary Url", "description": "URL of the dictionary", "deprecated": true }, "sample_dataset_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sample Dataset Url", "description": "URL of the sample dataset" }, "last_updated": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Updated", "description": "Last updated date of the dataset" }, "size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Size", "description": "Size of the dataset in bytes" } }, "type": "object", "required": [ "id", "format", "version" ], "title": "DatasetOption", "description": "Dataset option for v1 API. Extends base config with runtime fields." }, "type": "array" }, { "type": "null" } ], "title": "Options", "description": "Options of the dataset" } }, "type": "object", "title": "DatasetGroup" }, "type": "array", "title": "Response Get Datasets V1" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } } }, "security": [ { "Bearer": [] } ] } ``` --- title: Generate Dataset Credentials description: Generate credentials to access datasets. By default the credentials are valid for 7 days. url: https://theirstack.com/en/docs/api-reference/datasets/post_datasets_credentials_v1 --- ## OpenAPI Specification ```json { "path": "/v1/datasets/credentials", "method": "POST", "tags": [ "Datasets" ], "summary": "Generate Dataset Credentials", "description": "Generate credentials to access datasets. By default the credentials are valid for 7 days.", "operationId": "post_datasets_credentials_v1", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "access_key_id": { "type": "string", "title": "Access Key Id", "description": "The access key id for the temporary credential", "examples": [ "a3f8b2c9d1e4f5a6b7c8d9e0f1a2b3c4" ] }, "secret_access_key": { "type": "string", "title": "Secret Access Key", "description": "The secret access key for the temporary credential", "examples": [ "7e9a2b4c6d8e0f1a3b5c7d9e1f3a5b7c9d1e3f5a" ] }, "session_token": { "type": "string", "title": "Session Token", "description": "The session token for the temporary credential", "examples": [ "ZXlKaGJHY2lPaUpTVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5LmV5SmlkV05yWlhRa" ] }, "expiration": { "type": "string", "format": "date-time", "title": "Expiration", "description": "The expiration date of the temporary credential", "examples": [ "2025-01-15T14:30:00Z" ] }, "storage": { "properties": { "bucket_name": { "type": "string", "title": "Bucket Name", "description": "The S3/R2 bucket name where the datasets are stored", "examples": [ "datasets" ] }, "endpoint_url": { "type": "string", "title": "Endpoint Url", "description": "The S3-compatible endpoint URL to use for accessing the bucket", "examples": [ "https://example-datasets-url.com" ] }, "prefixes": { "items": { "type": "string" }, "type": "array", "title": "Prefixes", "description": "The prefixes to use for the temporary credential", "examples": [ [ "jobs/daily" ] ] } }, "type": "object", "required": [ "bucket_name", "endpoint_url", "prefixes" ], "title": "StorageConfig" } }, "type": "object", "required": [ "access_key_id", "secret_access_key", "session_token", "expiration", "storage" ], "title": "BucketCredentials" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } } }, "security": [ { "Bearer": [] } ] } ``` --- title: Free count description: Learn how to get the count of records that match your search criteria without consuming API credits. url: https://theirstack.com/en/docs/api-reference/features/free-count --- Our [Job Search](/en/docs/api-reference/jobs/search_jobs_v1) and [Company Search](/en/docs/api-reference/companies/search_companies_v1) endpoints include a free count feature that allows you to estimate the number of records that match your search criteria without consuming API credits. Steps to use free count [#steps-to-use-free-count] To effectively use the Free Count feature, follow these steps: 1. Enable Total Results: Set the `include_total_results` field to `true`. This will ensure that the total number of matching records is included in the response. 2. Blur Company Data: Set the `blur_company_data` field to `true`. This makes the request free for you. When `blur_company_data` is true, all company identifiers are blurred and the request doesn't cost any credits. 3. Limit Results: Set the `limit` field to `1`. This minimizes the data returned and makes the request faster, focusing solely on the count. By following these steps, you can efficiently estimate the number of records that match your search criteria without consuming any API credits. --- title: Preview data mode description: Learn how to preview TheirStack data without consuming API credits. url: https://theirstack.com/en/docs/api-reference/features/preview-data-mode --- Our [Job Search](/en/docs/api-reference/jobs/search_jobs_v1) and [Company Search](/en/docs/api-reference/companies/search_companies_v1) endpoints include a preview mode that return the same data but some fields are blurred. This mode is useful for [sales software](/en/docs/guides/sales-software-integration-guide) building products with TheirStack data. It allows you to show a preview of the data to your end users without consuming credits. It's the same we use in our own [app](https://app.theirstack.com). How to use preview mode [#how-to-use-preview-mode] To use preview mode, you need to set the `blur_company_data` field to `true` in the request body. Company search preview [#company-search-preview] When doing a company search with preview mode, the response will return all fields but the `name`, `logo`, `url`, `domain`, `long_description`, `seo_description`, `linkedin_url`, `publicly_traded_symbol`, `apollo_id`, `linkedin_id` fields will be blurred. Preview data mode Job search preview [#job-search-preview] When doing a job search with preview mode, the response will return all fields but the `description`, `url`, `final_url`, `source_url`, `company`, `company_domain`, `company_object.name`, `company_object.domain`, `company_object.linkedin_url`, `company_object.linkedin_id`, `company_object.url`, `company_object.long_description`, `company_object.seo_description`, `company_object.possible_domains` fields will be blurred. Preview data mode Limitations [#limitations] This mode is not available when filtering by company identifiers (company\_name, company\_domain, company\_linkedin\_url, company\_id). --- title: Avoiding getting the same job twice description: Learn how to avoid duplicate jobs when making repeated calls to the Job Search endpoint. url: https://theirstack.com/en/docs/api-reference/guides/avoid-getting-same-jobs-twice --- We don't cache results, so making repeated calls without using these filters will charge you API credits for the same jobs multiple times. Using one of the filters below ensures you only pay for new or different jobs. **Use the `discovered_at_gte` filter**: Passing a value higher than the last time you made a call will return jobs that were discovered only after that timestamp. This is useful when you want to fetch only new jobs since your last request. **Use the `job_id_not` filter**: Passing a list of job IDs that you don't want to get will return jobs that are not in that list. This gives you more control over which specific jobs to exclude from your results. Passing a list of job IDs that you don't want to get will return jobs that are not in that list. This gives you more control over which specific jobs to exclude from your results. --- title: Job Search description: This endpoint lets you search for jobs posted on thousands of websites and filter by multiple filters, such as job titles, companies, locations, company attributes, dates and many more. url: https://theirstack.com/en/docs/api-reference/jobs/search_jobs_v1 --- It consumes **1 API credit** for each job returned in the response. You must specify at least one of the following filters, or otherwise your request will fail: `posted_at_max_age_days`, `posted_at_gte`, `posted_at_lte`, `company_domain_or`, `company_linkedin_url_or`, `company_name_or`. This is for performance reasons. To retrieve jobs from a specific company or a list of companies, you can apply any of the following filters: `company_domain_or`, `company_linkedin_url_or`, `company_name_or`, `company_name_case_insensitive_or`. When using multiple company identifier filters, the endpoint will return jobs from companies that match any of the specified identifiers. Therefore, it is advisable to create a separate request for each company if you intend to use more than one identifier. This endpoint is used by job seekers and sales/marketing teams to search for jobs filtered by country, job title, technologies, job description, company name, company domain, or date range—see the payload examples below for specific use cases. Useful resources: [Avoiding getting the same job twice](https://theirstack.com/en/docs/api/avoid-getting-same-jobs-twice), [Fetching jobs periodically](https://theirstack.com/en/docs/guides/fetch-jobs-periodically), [Preview data mode](https://theirstack.com/en/docs/api/preview-data-mode), [Free count mode](https://theirstack.com/en/docs/api/free-count) ## OpenAPI Specification ```json { "path": "/v1/jobs/search", "method": "POST", "tags": [ "Jobs" ], "summary": "Job Search", "description": "This endpoint lets you search for jobs posted on thousands of websites and filter by multiple filters, such as job titles, companies, locations, company attributes, dates and many more.\n\nIt consumes **1 API credit** for each job returned in the response.\n\nYou must specify at least one of the following filters, or otherwise your request will fail: `posted_at_max_age_days`, `posted_at_gte`, `posted_at_lte`, `company_domain_or`, `company_linkedin_url_or`, `company_name_or`. This is for performance reasons.\n\nTo retrieve jobs from a specific company or a list of companies, you can apply any of the following filters: `company_domain_or`, `company_linkedin_url_or`, `company_name_or`, `company_name_case_insensitive_or`. When using multiple company identifier filters, the endpoint will return jobs from companies that match any of the specified identifiers. Therefore, it is advisable to create a separate request for each company if you intend to use more than one identifier.\n\nThis endpoint is used by job seekers and sales/marketing teams to search for jobs filtered by country, job title, technologies, job description, company name, company domain, or date range—see the payload examples below for specific use cases.\n\nUseful resources: [Avoiding getting the same job twice](https://theirstack.com/en/docs/api/avoid-getting-same-jobs-twice), [Fetching jobs periodically](https://theirstack.com/en/docs/guides/fetch-jobs-periodically), [Preview data mode](https://theirstack.com/en/docs/api/preview-data-mode), [Free count mode](https://theirstack.com/en/docs/api/free-count)", "operationId": "search_jobs_v1", "requestBody": { "content": { "application/json": { "schema": { "properties": { "order_by": { "items": { "properties": { "desc": { "type": "boolean", "title": "Desc", "description": "Whether to order by descending or ascending values", "default": true }, "field": { "type": "string", "enum": [ "date_posted", "discovered_at", "salary", "job_title", "company", "num_jobs" ], "title": "Field", "description": "Field to order by", "default": "date_posted" } }, "additionalProperties": false, "type": "object", "title": "ColumnSortJobSearch" }, "type": "array", "title": "Order By", "description": "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.", "default": [ { "desc": true, "field": "date_posted" }, { "desc": true, "field": "discovered_at" } ], "deprecated": true }, "offset": { "type": "integer", "minimum": 0, "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "page": { "type": "integer", "minimum": 0, "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "title": "Limit", "description": "Number of results per page", "default": 25, "examples": [ 25 ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cursor", "description": "Cursor for pagination" }, "job_title_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Or", "description": "Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Not", "description": "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.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_pattern_and": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern And", "description": "Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Or", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Not", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Or", "description": "2-letter ISO country code of the location of the job. Can pass more than 1", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "job_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Not", "description": "2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "posted_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Posted At Max Age Days", "description": "Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "posted_at_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Gte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.", "examples": [ null, "2025-05-25" ] }, "posted_at_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Lte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.", "examples": [ null, "2025-05-25" ] }, "discovered_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Max Age Days", "description": "If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_min_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Min Age Days", "description": "If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_gte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Gte", "description": "Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "discovered_at_lte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Lte", "description": "Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "job_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Or", "description": "Regex patterns to look for in job descriptions. Case-insensitive. Results will include jobs whose description matches any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Not", "description": "Regex patterns to look for in job descriptions. Results will include jobs whose description don't match any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_is_case_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Job Description Pattern Is Case Insensitive", "description": "Whether to make searches on job descriptions case-sensitive or insensitive. Deprecated field and won't work, use job_description_pattern_case_sensitive_or instead.", "default": true, "deprecated": true, "examples": [ null, true, false ] }, "job_description_contains_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Or", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_contains_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Not", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_pattern_case_sensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Case Sensitive Or", "description": "Regex patterns to look for in job descriptions. Case-sensitive. If patterns are uppercase, they will be searched case-sensitively. Results will include jobs whose description matches any of these patterns.", "default": [], "examples": [ [], [ "Python", "JavaScript" ], [ "API", "REST" ] ] }, "remote": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remote", "description": "True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.", "examples": [ null, true, false ] }, "only_jobs_with_reports_to": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Reports To", "description": "Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.", "deprecated": true, "examples": [ null, true, false ] }, "reports_to_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Reports To Exists", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "final_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Final Url Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "only_jobs_with_hiring_managers": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Hiring Managers", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "hiring_managers_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hiring Managers Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "job_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Or", "description": "Get jobs with these IDs only.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Not", "description": "Exclude jobs with these IDs.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_ids": { "items": { "type": "integer" }, "type": "array", "title": "Job Ids", "description": "Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.", "default": [], "deprecated": true }, "job_seniority_or": { "items": { "type": "string", "enum": [ "c_level", "staff", "senior", "junior", "mid_level" ] }, "type": "array", "title": "Job Seniority Or", "description": "Will return jobs where the seniority is any of the ones passed here", "default": [], "examples": [ [], [ "intern", "entry", "mid", "senior", "principal" ] ] }, "min_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Salary Usd", "description": "Minimum annual salary in USD. For example, 100000 means $100,000.", "examples": [ null, 100000, 150000 ] }, "max_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Salary Usd", "description": "Maximum annual salary in USD. For example, 150000 means $150,000.", "examples": [ null, 100000, 150000 ] }, "job_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Or", "description": "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.", "default": [] }, "job_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Not", "description": "Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug And", "description": "Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Or", "description": "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. Use this to find jobs in specific cities, states, or regions.", "default": [], "examples": [ [], [ "san francisco" ], [ "california", "new york" ], [ "madrid" ] ] }, "job_location_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Not", "description": "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.", "default": [], "examples": [ [], [ "new york", "california" ], [ "madrid" ] ] }, "job_location_or": { "items": { "properties": { "id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Id", "description": "Filter by location id. You can discover all the locations from the locations catalog endpoint [GET /v0/catalog/locations](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0)", "examples": [ 3117735 ] } }, "type": "object", "title": "JobLocationFilter" }, "type": "array", "title": "Job Location Or", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "job_location_not": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Not", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "url_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Or", "description": "Include jobs only if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "url_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Not", "description": "Exclude jobs if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "scraper_name_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Scraper Name Pattern Or", "description": "Regex patterns to match job sources. Case-insensitive.", "default": [], "deprecated": true }, "easy_apply": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Easy Apply", "description": "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.", "examples": [ null, true, false ] }, "employment_statuses_or": { "anyOf": [ { "items": { "type": "string", "enum": [ "full_time", "part_time", "temporary", "internship", "contract", "freelance", "co_founder", "apprenticeship", "seasonal", "volunteer", "other" ], "title": "Commitment" }, "type": "array" }, { "type": "null" } ], "title": "Employment Statuses Or", "description": "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.", "examples": [ [], [ "full_time" ], [ "full_time", "part_time" ] ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "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.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_case_insensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Case Insensitive Or", "description": "Only return companies that match these names exactly, case-insensitively.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_id_or": { "items": { "type": "string" }, "type": "array", "title": "Company Id Or", "description": "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.", "default": [], "examples": [ [], [ "1234567890", "1234567891" ] ] }, "company_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Or", "description": "Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.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.", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Not", "description": "Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_name_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Not", "description": "Only return companies that don't match these names exactly, case-sensitively.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Or", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_name_partial_match_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Not", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_linkedin_url_or": { "items": { "type": "string" }, "type": "array", "title": "Company Linkedin Url Or", "description": "Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.", "default": [], "examples": [ [], [ "https://www.linkedin.com/company/google/" ] ] }, "blur_company_data": { "type": "boolean", "title": "Blur Company Data", "description": "Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)", "default": false }, "property_exists_or": { "items": { "type": "string", "enum": [ "company_object.domain", "company_object.linkedin_url", "final_url", "hiring_team", "employment_statuses" ] }, "type": "array", "title": "Property Exists Or", "description": "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.", "default": [], "examples": [ [], [ "company_object.domain", "company_object.linkedin_url", "final_url" ] ] }, "property_exists_and": { "items": { "type": "string", "enum": [ "company_object.domain", "company_object.linkedin_url", "final_url", "hiring_team", "employment_statuses" ] }, "type": "array", "title": "Property Exists And", "default": [], "examples": [ [], [ "company_object.domain", "company_object.linkedin_url", "final_url" ] ] }, "company_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Or", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Not", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_accent_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Description Pattern Accent Insensitive", "description": "Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.", "default": false, "examples": [ null, true, false ] }, "min_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Revenue Usd", "description": "Minimum company revenue, in USD", "examples": [ null ] }, "max_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Revenue Usd", "description": "Maximum company revenue, in USD", "examples": [ null ] }, "min_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count", "description": "Minimum number of employees in a company", "examples": [ null, 100 ] }, "max_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count", "description": "Maximum number of employees in a company", "examples": [ null, 100 ] }, "min_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count Or Null", "description": "Minimum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "max_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count Or Null", "description": "Maximum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "min_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Funding Usd", "description": "Minimum company funding, in USD", "examples": [ null, 1000000000 ] }, "max_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Funding Usd", "description": "Maximum company funding, in USD", "examples": [ null, 1000000000 ] }, "funding_stage_or": { "items": { "type": "string" }, "type": "array", "title": "Funding Stage Or", "description": "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']", "default": [] }, "industry_or": { "items": { "type": "string" }, "type": "array", "title": "Industry Or", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_or field instead. ", "default": [], "deprecated": true }, "industry_not": { "items": { "type": "string" }, "type": "array", "title": "Industry Not", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_not field instead. ", "default": [], "deprecated": true }, "industry_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Or", "description": "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)", "default": [] }, "industry_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Not", "description": "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)", "default": [] }, "company_tags_or": { "items": { "type": "string" }, "type": "array", "title": "Company Tags Or", "description": "Return companies that match any of these keywords", "default": [] }, "company_type": { "anyOf": [ { "type": "string", "enum": [ "recruiting_agency", "direct_employer", "all" ] }, { "type": "null" } ], "title": "Company Type", "description": "Filter by company type." }, "company_investors_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Or", "description": "Investors of the company", "default": [] }, "company_investors_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Partial Match Or", "description": "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).", "default": [] }, "company_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Or", "description": "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)", "default": [] }, "company_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug And", "description": "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)", "default": [] }, "company_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Not", "description": "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)", "default": [] }, "only_yc_companies": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Yc Companies", "description": "Only return YC companies", "default": false }, "company_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Location Pattern Or", "description": "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.", "default": [] }, "company_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Or", "description": "Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Not", "description": "Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_list_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Or", "description": "Return companies that belong to any of the company lists passed here", "default": [] }, "company_list_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Not", "description": "Return companies that don't belong to any of the company lists passed here", "default": [] }, "company_linkedin_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Linkedin Url Exists", "description": "(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL", "deprecated": true, "examples": [ null ] }, "revealed_company_data": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Revealed Company Data", "description": "This field is deprecated and has no effect.", "deprecated": true, "examples": [ null ] }, "last_funding_round_date_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Lte", "description": "Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "last_funding_round_date_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Gte", "description": "Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "include_total_results": { "type": "boolean", "title": "Include Total Results", "description": "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.", "default": false } }, "additionalProperties": false, "type": "object", "title": "JobSearchFilters" }, "examples": { "country_us_last_7_days": { "summary": "Jobs posted in the US in the last 7 days", "value": { "page": 0, "limit": 25, "job_country_code_or": [ "US" ], "posted_at_max_age_days": 7 } }, "country_us_last_7_days_with_total_results": { "summary": "Jobs posted in the US in the last 7 days, including total results (will be slower)", "value": { "page": 0, "limit": 25, "job_country_code_or": [ "US" ], "posted_at_max_age_days": 7, "include_total_results": true } }, "software_engineer_last_7_days": { "summary": "Jobs posted in the last 7 days from UK companies with 'software engineer' in the title", "value": { "page": 0, "limit": 25, "job_title_or": [ "Software engineer" ], "posted_at_max_age_days": 7, "company_country_code_or": [ "GB" ] } }, "analytics_jobs_last_30_days": { "summary": "Jobs posted in the last 30 days with 'analytics' in the description", "value": { "page": 0, "limit": 25, "posted_at_max_age_days": 30, "job_description_pattern_or": [ "analytics" ] } }, "postgres_jobs_current_month": { "summary": "Jobs posted in the current month that mention Postgres or MySQL", "value": { "page": 0, "limit": 25, "posted_at_gte": "2026-02-01", "posted_at_lte": "2026-02-09", "company_technology_slug_or": [] } }, "jobs_from_google_apple_tesla_nvidia_last_60_days": { "summary": "Jobs from Google, Apple, Tesla, or NVIDIA posted in the last 60 days", "value": { "page": 0, "limit": 25, "posted_at_max_age_days": 60, "company_name_or": [ "Google", "Apple", "Tesla", "NVIDIA" ] } }, "jobs_from_google_apple_tesla_nvidia_last_60_days_by_domain": { "summary": "Jobs from Google, Apple, Tesla, or Nvidia posted in the last 60 days, filtered by domain", "value": { "page": 0, "limit": 25, "posted_at_max_age_days": 60, "company_domain_or": [ "google.com", "apple.com", "tesla.com", "nvidia.com" ] } }, "default_params": { "summary": "All available parameters", "value": { "order_by": [ { "desc": true, "field": "date_posted" }, { "desc": true, "field": "discovered_at" } ], "offset": 0, "page": 0, "limit": 25, "job_title_or": [], "job_title_not": [], "job_title_pattern_and": [], "job_title_pattern_or": [], "job_title_pattern_not": [], "job_country_code_or": [], "job_country_code_not": [], "posted_at_max_age_days": 7, "job_description_pattern_or": [], "job_description_pattern_not": [], "job_description_pattern_is_case_insensitive": true, "job_description_contains_or": [], "job_description_contains_not": [], "job_description_pattern_case_sensitive_or": [], "job_id_or": [], "job_id_not": [], "job_ids": [], "job_seniority_or": [], "job_technology_slug_or": [], "job_technology_slug_not": [], "job_technology_slug_and": [], "job_location_pattern_or": [], "job_location_pattern_not": [], "job_location_or": [], "job_location_not": [], "url_domain_or": [], "url_domain_not": [], "scraper_name_pattern_or": [], "company_name_or": [], "company_name_case_insensitive_or": [], "company_id_or": [], "company_domain_or": [], "company_domain_not": [], "company_name_not": [], "company_name_partial_match_or": [], "company_name_partial_match_not": [], "company_linkedin_url_or": [], "blur_company_data": false, "property_exists_or": [], "property_exists_and": [], "company_description_pattern_or": [], "company_description_pattern_not": [], "company_description_pattern_accent_insensitive": false, "funding_stage_or": [], "industry_or": [], "industry_not": [], "industry_id_or": [], "industry_id_not": [], "company_tags_or": [], "company_investors_or": [], "company_investors_partial_match_or": [], "company_technology_slug_or": [], "company_technology_slug_and": [], "company_technology_slug_not": [], "only_yc_companies": false, "company_location_pattern_or": [], "company_country_code_or": [], "company_country_code_not": [], "company_list_id_or": [], "company_list_id_not": [], "include_total_results": false } } } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "metadata": { "properties": { "total_results": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Results", "description": "Total number of results", "examples": [ 2034 ] }, "truncated_results": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Truncated Results", "description": "Number of results that were not returned because the user doesn't have enough credits to fetch them all the possible results the API could have returned", "default": 0 }, "truncated_companies": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Truncated Companies", "description": "Number of companies that were not returned because the user doesn't have enough credits to fetch all the possible results the API could have returned", "default": 0 }, "total_companies": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Companies", "description": "Total number of companies", "examples": [ 1045 ] } }, "type": "object", "title": "Metadata" }, "data": { "items": { "properties": { "id": { "type": "integer", "title": "Id", "description": "ID of the job", "examples": [ 1234 ] }, "job_title": { "type": "string", "title": "Job Title", "description": "Job title", "examples": [ "Senior Data Engineer" ] }, "url": { "type": "string", "title": "Url", "description": "URL of the job post", "examples": [ "https://example.com/job/1234" ] }, "date_posted": { "type": "string", "format": "date", "title": "Date Posted", "description": "Date when the job was posted", "examples": [ "2021-01-01" ] }, "has_blurred_data": { "type": "boolean", "title": "Has Blurred Data", "description": "Whether the returned object has company identifiable data blurred or not", "default": false }, "company": { "type": "string", "title": "Company", "description": "Company name. This field is deprecated, please don't use it", "deprecated": true, "examples": [ "Google" ] }, "final_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Final Url", "description": "Is the URL of the job in the career page of the company.", "examples": [ "https://carecrafterhealth.com/careers/job-details/MFC286442-4", "https://www.google.com/about/careers/applications/jobs/results/110690555461018310-software-engineer-iii-infrastructure-core", "https://job-boards.greenhouse.io/sondermind/jobs/6620635003?gh_src=c1701b3d3us" ] }, "source_url": { "type": "string", "title": "Source Url", "description": "Is the url TheirStack used to get the job data.", "examples": [ "https://www.linkedin.com/jobs/view/1234567890" ] }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Location", "description": "This is the city of the job.", "deprecated": true, "examples": [ "New York", "Madrid", "London" ] }, "short_location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Short Location", "description": "It's a combination of the city and the state of the job.", "deprecated": true, "examples": [ "Tulsa, OK", "Methuen, MA" ] }, "long_location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Long Location", "description": "It's a combination of the city, the state and the postal code of the job.", "deprecated": true, "examples": [ "Methuen, MA 01844", "Tulsa, OK 74110" ] }, "state_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "State Code", "description": "The state code of the job.", "deprecated": true, "examples": [ "OK", "MA", "NY" ] }, "latitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Latitude", "description": "The latitude of the job.", "deprecated": true, "examples": [ 37.774929, 42.360082 ] }, "longitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Longitude", "description": "The longitude of the job.", "deprecated": true, "examples": [ -96.726486, -71.056883 ] }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Postal Code", "description": "The postal code of the job.", "deprecated": true, "examples": [ "01844", "74110" ] }, "remote": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remote", "description": "If the job is remote.", "examples": [ true, false ] }, "hybrid": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hybrid", "description": "If the job is hybrid. A hybrid position is a job that combines remote and in-office work.", "examples": [ true, false ] }, "salary_string": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Salary String", "description": "The salary of the job in the local currency. If a similar field is present in the job source, this property will contain the same content. If no similar field is present, the content will be have the following format: - per year. For the currencies where the symbol precedes the digits, the format will be - per year. In these latter two cases, both the min and max annual salary are expressed in either k (for thousands) or M (for millions).", "examples": [ "$100,000 - $120,000", "80k € - 120k € per year" ] }, "min_annual_salary": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Annual Salary", "description": "The minimum annual salary of the job in the local currency.", "examples": [ 100000, 120000 ] }, "min_annual_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Annual Salary Usd", "description": "The minimum annual salary of the job in USD.", "examples": [ 100000, 120000 ] }, "max_annual_salary": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Annual Salary", "description": "The maximum annual salary of the job in the local currency.", "examples": [ 100000, 120000 ] }, "max_annual_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Annual Salary Usd", "description": "The maximum annual salary of the job in USD.", "examples": [ 100000, 120000 ] }, "avg_annual_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Avg Annual Salary Usd", "description": "This property calculates the average annual salary for a job in USD, based on the available minimum and maximum annual salary values (both already converted to USD):\n If both min_annual_salary_usd and max_annual_salary_usd are missing or zero, it returns None.\n If only the minimum is missing, it returns the maximum value.\n If only the maximum is missing, it returns the minimum value.\n If both are present, it returns the average of the two, rounded to two decimal places.\n This ensures the property always provides the best possible estimate of the average salary, even if only one bound is available.\n ", "examples": [ 100000, 120000 ] }, "salary_currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Salary Currency", "description": "The currency of the salary of the job.", "examples": [ "USD", "EUR", "GBP" ] }, "countries": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Countries", "description": "Countries of the job", "deprecated": true, "examples": [ [ "United States", "Canada", "Spain", "France", "Australia" ] ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country", "description": "Country name of the job", "deprecated": true, "examples": [ "United States", "Canada", "Spain", "France", "Australia" ] }, "country_codes": { "anyOf": [ { "items": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "type": "array" }, { "type": "null" } ], "title": "Country Codes", "description": "Two-letter country codes (ISO 3166-1 alpha-2) representing the job's locations.", "deprecated": true, "examples": [ [ "US", "CA", "ES", "FR", "AU" ], [ "US" ], [ "US", "CA" ] ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Code", "description": "Two-letter country code (ISO 3166-1 alpha-2) representing the job's location. If the job has multiple locations, the first one is returned.", "deprecated": true, "examples": [ "US", "CA", "ES", "FR", "AU" ] }, "cities": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Cities", "description": "Cities of the job", "deprecated": true, "examples": [ [ "New York", "San Francisco", "London", "Paris", "Sydney" ] ] }, "continents": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Continents", "description": "Continents of the job", "deprecated": true, "examples": [ [ "North America", "Europe", "Asia", "Australia", "South America" ] ] }, "seniority": { "anyOf": [ { "type": "string", "enum": [ "c_level", "staff", "senior", "junior", "mid_level" ], "title": "Seniority" }, { "type": "null" } ], "description": "Seniority level of the job" }, "discovered_at": { "type": "string", "format": "date-time", "title": "Discovered At", "description": "Date when the job was discovered by TheirStack", "examples": [ "2024-01-01T00:00:00" ] }, "company_domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Company Domain", "description": "Company website domain", "examples": [ "acme.com" ] }, "hiring_team": { "anyOf": [ { "items": { "properties": { "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "First Name", "description": "First name of the person" }, "full_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Full Name", "description": "Full name of the person" }, "linkedin_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Linkedin Url", "description": "LinkedIn URL of the person" }, "role": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role", "description": "Role of the person" }, "image_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Image Url", "description": "Image URL of the person" }, "thumbnail_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thumbnail Url", "description": "Thumbnail URL of the person" } }, "type": "object", "title": "PersonBase" }, "type": "array" }, { "type": "null" } ], "title": "Hiring Team", "description": "Hiring team who posted the job", "examples": [ [ { "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" } ] ] }, "reposted": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Reposted", "description": "Indicates whether the employer has republished this job posting.", "examples": [ true, false ] }, "date_reposted": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Date Reposted", "description": "Date when the job was reposted", "examples": [ "2024-01-01" ] }, "employment_statuses": { "items": { "$ref": "#/components/schemas/Commitment", "_circular": true }, "type": "array", "title": "Employment Statuses", "description": "Employment statuses of the job", "default": [], "examples": [ [ "full_time" ] ] }, "easy_apply": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Easy Apply", "description": "Indicates whether the job application can be submitted directly through the job board (easy_apply=True) or requires redirecting to the company's website (easy_apply=False).", "examples": [ true, false ] }, "technology_slugs": { "items": { "type": "string" }, "type": "array", "title": "Technology Slugs", "description": "Slugs of the technologies of the job", "default": [], "examples": [ [ "google-firebase", "postgresql", "jira" ] ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Job description in markdown format", "examples": [ "## 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" ] }, "company_object": { "properties": { "id": { "type": "string", "title": "Id", "description": "Company ID", "examples": [ "google" ] }, "name": { "type": "string", "title": "Name", "description": "Company name", "examples": [ "Google" ] }, "domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Domain", "description": "Company domain", "examples": [ "google.com" ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Industry", "description": "Industry of the company", "examples": [ "internet" ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country", "description": "Country of the company's HQ", "examples": [ "United States" ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Code", "description": "ISO2 country code. E.g. \"US\"" }, "employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Employee Count", "description": "Number of employees of the company", "examples": [ 7543 ] }, "logo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logo", "description": "Stable CDN-hosted company logo URL suitable for display in applications", "examples": [ "https://example.com/logo.png" ] }, "num_jobs": { "type": "integer", "title": "Num Jobs", "description": "Number of jobs from this company in our database", "default": 0, "examples": [ 746 ] }, "num_technologies": { "type": "integer", "title": "Num Technologies", "description": "Number of technologies mentioned in the jobs of this company", "default": 0, "examples": [ 746 ] }, "possible_domains": { "items": { "type": "string" }, "type": "array", "title": "Possible Domains", "description": "List of possible domains for the company", "default": [] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url", "description": "Company domain. Same as the \"domain\" field. Will be deprecated in the future.", "examples": [ "google.com" ] }, "industry_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Industry Id", "description": "Code of the industry. One of LinkedIn's Industry Codes V2 from https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2" }, "linkedin_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Linkedin Url", "examples": [ "http://www.linkedin.com/company/google" ] }, "num_jobs_last_30_days": { "type": "integer", "title": "Num Jobs Last 30 Days", "description": "Number of jobs from this company in our database posted in the last 30 days", "default": 0, "examples": [ 34 ] }, "num_jobs_found": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Num Jobs Found", "description": "When filtering companies by jobs, number of jobs found for this company", "examples": [ 23 ] }, "yc_batch": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Yc Batch", "description": "If the company went through YC, this is its batch", "examples": [ "W21" ] }, "apollo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Apollo Id", "description": "ID of the company in Apollo", "examples": [ "5b839bd0324d4445051f9a5a" ] }, "linkedin_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Linkedin Id", "description": "ID of the company in LinkedIn" }, "url_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url Source", "description": "Source of the company URL" }, "is_recruiting_agency": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Recruiting Agency", "description": "Is a recruiting agency" }, "founded_year": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Founded Year", "description": "Year the company was founded", "examples": [ 2019 ] }, "annual_revenue_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Annual Revenue Usd", "description": "Annual revenue of the company in USD", "examples": [ 189000000 ] }, "annual_revenue_usd_readable": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Annual Revenue Usd Readable", "description": "Annual revenue of the company in USD, formated as an easily readable string", "examples": [ "189M" ] }, "total_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Funding Usd", "description": "Funding of the company in USD", "examples": [ 500000 ] }, "last_funding_round_date": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date", "description": "Date of the last funding round of the company", "examples": [ "2020-01-01" ] }, "last_funding_round_amount_readable": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Funding Round Amount Readable", "description": "Amount of the last funding round of the company, formated as an easily readable string", "examples": [ "$1.2M" ] }, "employee_count_range": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Employee Count Range", "description": "Number range of employees at the company", "examples": [ "1001-5000" ] }, "long_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Long Description", "description": "Short description of the company", "examples": [ "Google is a California-based multinational technology company that offers internet-related services such as a search engine, online advertising and cloud computing." ] }, "seo_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Seo Description", "description": "SEO description of the company, extracted from their website" }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "City", "description": "City of the company's HQ", "examples": [ "Mountain View" ] }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Postal Code", "description": "Postal code of the company's HQ", "examples": [ "28040" ] }, "company_keywords": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Company Keywords", "description": "Company keywords, related to what the company does" }, "alexa_ranking": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Alexa Ranking", "description": "Alexa ranking", "examples": [ 1 ] }, "publicly_traded_symbol": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Publicly Traded Symbol", "examples": [ "GOOG" ] }, "publicly_traded_exchange": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Publicly Traded Exchange", "examples": [ "NASDAQ" ] }, "investors": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Investors", "description": "List of investors in this company" }, "funding_stage": { "anyOf": [ { "type": "string", "enum": [ "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" ], "title": "FundingStage" }, { "type": "null" } ], "description": "Latest funding stage of the company" }, "has_blurred_data": { "type": "boolean", "title": "Has Blurred Data", "description": "Whether the returned object has company identifiable data blurred or not", "default": false }, "technology_slugs": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Technology Slugs", "description": "slugs of the technologies found to be used by the company", "examples": [ [ "kafka", "elasticsearch" ] ] }, "technology_names": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Technology Names", "description": "Names of the technologies found to be used by the company", "deprecated": true, "examples": [ [ "Kafka", "Elasticsearch" ] ] } }, "type": "object", "required": [ "id", "name" ], "title": "CompanyWithTechnologySlugs" }, "locations": { "items": { "properties": { "id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Id", "description": "The unique identifier for the location, is based on the geonameid field from the geonames database", "examples": [ 5128581 ] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name", "description": "The name of the location. If it's a city, it will be the city name; if it's a country, it will be the country name; if it's a region, it will be the region name, etc", "examples": [ "New York City", "Germany" ] }, "type": { "anyOf": [ { "type": "string", "enum": [ "city", "region", "country", "continent" ], "title": "GeonameType" }, { "type": "null" } ], "description": "The type of the location", "examples": [ "city", "country", "region" ] }, "feature_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Feature Code", "description": "GeoNames feature code (e.g., 'PPL' for populated place, 'ADM1' for first-order administrative division, 'PCLI' for country). Check all the possible feature codes in the GeoNames documentation", "examples": [ "PPL", "ADM1", "PCLI" ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Code", "description": "ISO 3166-1 alpha-2 country code of the location", "examples": [ "US", "DE" ] }, "admin1_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Admin1 Name", "description": "The first level administrative division name of the location", "examples": [ "New York", "California" ] }, "admin1_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Admin1 Code", "description": "The first level administrative division code of the location", "examples": [ "NY", "CA" ] }, "admin2_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Admin2 Name", "description": "The second level administrative division name of the location (e.g., county or district)", "examples": [ "New York County", "Los Angeles County" ] }, "admin2_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Admin2 Code", "description": "The second level administrative division code of the location", "examples": [ "NY", "LA" ] }, "continent": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Continent", "description": "Continent code of the location", "examples": [ "NA", "EU", "AS" ] }, "latitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Latitude", "description": "Geographic latitude coordinate for precise mapping", "examples": [ 40.71427, 37.774929 ] }, "longitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Longitude", "description": "Geographic longitude coordinate for precise mapping", "examples": [ -74.00597, -122.419416 ] }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "City", "description": "The city of the location (Deprecated): Use 'name' field when 'type' is 'city'", "deprecated": true }, "address": { "type": "null", "title": "Address", "description": "Address of the location (Deprecated): This field has been removed. Use the location fields (name, admin1_name, country_code, etc.) to construct addresses as needed", "deprecated": true, "examples": [ null ] }, "postal_code": { "type": "null", "title": "Postal Code", "description": "Postal code of the location (Deprecated): This field has been removed and is no longer available", "deprecated": true, "examples": [ null ] }, "state": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "State", "description": "State of the location (Deprecated): Use 'admin1_name' instead", "deprecated": true, "examples": [ "California" ] }, "state_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "State Code", "description": "State code of the location (Deprecated): Use 'admin1_code' instead", "deprecated": true, "examples": [ "06" ] }, "display_name": { "type": "string", "title": "Display Name", "description": "A human-readable display name for the location, constructed from available location fields", "readOnly": true, "examples": [ "New York City, New York, United States", "Germany", "California, United States" ] }, "country_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Name", "description": "The full country name derived from the country_code", "readOnly": true, "examples": [ "United States", "Germany", "United Kingdom" ] } }, "type": "object", "required": [ "display_name", "country_name" ], "title": "JobLocation" }, "type": "array", "title": "Locations", "description": "All possible locations of the job with coordinates, city, state, state_code, country_code, etc.", "default": [], "examples": [ [ { "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" } ] ] }, "normalized_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Normalized Title" }, "manager_roles": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Manager Roles", "description": "Roles of the person or people found in the job description to be the managers of the hired person. Can be useful to infer who's the decision maker for the technologies mentioned in the job post." }, "matching_phrases": { "anyOf": [ { "items": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "type": "array" }, { "type": "null" } ], "title": "Matching Phrases", "description": "Phrases from the job description that match the pattern passed", "default": [] }, "matching_words": { "anyOf": [ { "items": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "type": "array" }, { "type": "null" } ], "title": "Matching Words", "description": "Words from the job description that match the pattern passed", "default": [] } }, "type": "object", "required": [ "id", "job_title", "url", "date_posted", "company", "source_url", "discovered_at", "company_object" ], "title": "JobWithMatchingPhrasesResponse" }, "type": "array", "title": "Data" } }, "type": "object", "required": [ "metadata", "data" ], "title": "JobSearchResponse" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } } }, "security": [ { "Bearer": [] } ] } ``` --- title: Get Request Count description: Get the number of request done per day url: https://theirstack.com/en/docs/api-reference/requests/get_requests_count_v0 --- ## OpenAPI Specification ```json { "path": "/v0/requests/count", "method": "GET", "tags": [ "Requests" ], "summary": "Get Request Count", "description": "Get the number of request done per day", "operationId": "get_requests_count_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "start_datetime", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "description": "Start datetime in ISO format (e.g., 2023-01-01T00:00:00)", "title": "Start Datetime" }, "description": "Start datetime in ISO format (e.g., 2023-01-01T00:00:00)" }, { "name": "end_datetime", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "description": "End datetime in ISO format (e.g., 2023-01-01T23:59:59)", "title": "End Datetime" }, "description": "End datetime in ISO format (e.g., 2023-01-01T23:59:59)" }, { "name": "timezone", "in": "query", "required": false, "schema": { "type": "string", "description": "IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')", "default": "UTC", "title": "Timezone" }, "description": "IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')" }, { "name": "is_origin_app", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "Filter by origin app or api", "title": "Is Origin App" }, "description": "Filter by origin app or api" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "period_start": { "type": "string", "format": "date-time", "title": "Period Start", "description": "Start of the period." }, "number_of_requests": { "type": "integer", "title": "Number Of Requests", "description": "Number of requests." } }, "type": "object", "required": [ "period_start", "number_of_requests" ], "title": "RequestCount" }, "title": "Response Get Requests Count V0" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Get Saved Search description: undefined url: https://theirstack.com/en/docs/api-reference/saved-searches/get_saved_searches_by_id_v0 --- ## OpenAPI Specification ```json { "path": "/v0/saved_searches/{search_id}", "method": "GET", "tags": [ "Saved Searches" ], "summary": "Get Saved Search", "operationId": "get_saved_searches_by_id_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "search_id", "in": "path", "required": true, "schema": { "type": "integer", "description": "The ID of the saved search", "title": "Search Id" }, "description": "The ID of the saved search" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "id": { "type": "integer", "title": "Id", "description": "ID of the saved search" }, "name": { "type": "string", "title": "Name", "description": "Name of the saved search" }, "type": { "type": "string", "enum": [ "companies", "jobs" ], "title": "Type", "description": "Type of the saved search." }, "body": { "anyOf": [ { "properties": { "expand_technology_slugs": { "items": { "type": "string" }, "type": "array", "title": "Expand Technology Slugs", "description": "Specify technology slugs to include detailed technology usage information for each company. The response will include a 'technologies_found' field containing metrics like confidence score, ranking, and job count for each specified technology. Note: If a technology is not listed for a company, it means that company does not use that technology. This feature is useful for enriching company data with their technology stack details.", "default": [] }, "order_by": { "items": { "properties": { "desc": { "type": "boolean", "title": "Desc", "description": "Whether to order by descending or ascending values", "default": true }, "field": { "type": "string", "enum": [ "name", "num_jobs", "num_jobs_last_30_days", "num_jobs_found", "employee_count", "alexa_ranking", "founded_year", "annual_revenue_usd", "total_funding_usd", "last_funding_round_date", "confidence", "jobs", "first_date_found" ], "title": "Field", "description": "Order the results by some of these fields" } }, "additionalProperties": false, "type": "object", "required": [ "field" ], "title": "ColumnSortCompanySearch" }, "type": "array", "title": "Order By", "description": "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", "default": [ { "desc": true, "field": "confidence" }, { "desc": true, "field": "num_jobs_found" }, { "desc": true, "field": "num_jobs" }, { "desc": true, "field": "num_jobs" }, { "desc": true, "field": "employee_count" } ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "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.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_case_insensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Case Insensitive Or", "description": "Only return companies that match these names exactly, case-insensitively.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_id_or": { "items": { "type": "string" }, "type": "array", "title": "Company Id Or", "description": "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.", "default": [], "examples": [ [], [ "1234567890", "1234567891" ] ] }, "company_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Or", "description": "Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.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.", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Not", "description": "Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_name_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Not", "description": "Only return companies that don't match these names exactly, case-sensitively.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Or", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_name_partial_match_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Not", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_linkedin_url_or": { "items": { "type": "string" }, "type": "array", "title": "Company Linkedin Url Or", "description": "Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.", "default": [], "examples": [ [], [ "https://www.linkedin.com/company/google/" ] ] }, "blur_company_data": { "type": "boolean", "title": "Blur Company Data", "description": "Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)", "default": false }, "property_exists_or": { "items": { "type": "string", "enum": [ "domain", "linkedin_url" ] }, "type": "array", "title": "Property Exists Or", "description": "Return companies that have any of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have a domain OR a linkedin_url set.", "default": [], "examples": [ [], [ "domain", "linkedin_url" ] ] }, "property_exists_and": { "items": { "type": "string", "enum": [ "domain", "linkedin_url" ] }, "type": "array", "title": "Property Exists And", "description": "Return companies that have all of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have both domain AND linkedin_url set.", "default": [], "examples": [ [], [ "domain", "linkedin_url" ] ] }, "offset": { "type": "integer", "minimum": 0, "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "page": { "type": "integer", "minimum": 0, "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "title": "Limit", "description": "Number of results per page", "default": 25, "examples": [ 25 ] }, "company_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Or", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Not", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_accent_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Description Pattern Accent Insensitive", "description": "Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.", "default": false, "examples": [ null, true, false ] }, "min_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Revenue Usd", "description": "Minimum company revenue, in USD", "examples": [ null ] }, "max_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Revenue Usd", "description": "Maximum company revenue, in USD", "examples": [ null ] }, "min_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count", "description": "Minimum number of employees in a company", "examples": [ null, 100 ] }, "max_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count", "description": "Maximum number of employees in a company", "examples": [ null, 100 ] }, "min_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count Or Null", "description": "Minimum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "max_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count Or Null", "description": "Maximum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "min_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Funding Usd", "description": "Minimum company funding, in USD", "examples": [ null, 1000000000 ] }, "max_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Funding Usd", "description": "Maximum company funding, in USD", "examples": [ null, 1000000000 ] }, "funding_stage_or": { "items": { "type": "string" }, "type": "array", "title": "Funding Stage Or", "description": "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']", "default": [] }, "industry_or": { "items": { "type": "string" }, "type": "array", "title": "Industry Or", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_or field instead. ", "default": [], "deprecated": true }, "industry_not": { "items": { "type": "string" }, "type": "array", "title": "Industry Not", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_not field instead. ", "default": [], "deprecated": true }, "industry_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Or", "description": "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)", "default": [] }, "industry_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Not", "description": "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)", "default": [] }, "company_tags_or": { "items": { "type": "string" }, "type": "array", "title": "Company Tags Or", "description": "Return companies that match any of these keywords", "default": [] }, "company_type": { "anyOf": [ { "type": "string", "enum": [ "recruiting_agency", "direct_employer", "all" ] }, { "type": "null" } ], "title": "Company Type", "description": "Filter by company type." }, "company_investors_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Or", "description": "Investors of the company", "default": [] }, "company_investors_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Partial Match Or", "description": "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).", "default": [] }, "company_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Or", "description": "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)", "default": [] }, "company_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug And", "description": "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)", "default": [] }, "company_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Not", "description": "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)", "default": [] }, "only_yc_companies": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Yc Companies", "description": "Only return YC companies", "default": false }, "company_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Location Pattern Or", "description": "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.", "default": [] }, "company_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Or", "description": "Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Not", "description": "Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_list_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Or", "description": "Return companies that belong to any of the company lists passed here", "default": [] }, "company_list_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Not", "description": "Return companies that don't belong to any of the company lists passed here", "default": [] }, "company_linkedin_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Linkedin Url Exists", "description": "(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL", "deprecated": true, "examples": [ null ] }, "revealed_company_data": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Revealed Company Data", "description": "This field is deprecated and has no effect.", "deprecated": true, "examples": [ null ] }, "last_funding_round_date_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Lte", "description": "Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "last_funding_round_date_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Gte", "description": "Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "include_total_results": { "type": "boolean", "title": "Include Total Results", "description": "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.", "default": false }, "job_filters": { "anyOf": [ { "properties": { "job_title_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Or", "description": "Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Not", "description": "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.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_pattern_and": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern And", "description": "Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Or", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Not", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Or", "description": "2-letter ISO country code of the location of the job. Can pass more than 1", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "job_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Not", "description": "2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "posted_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Posted At Max Age Days", "description": "Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "posted_at_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Gte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.", "examples": [ null, "2025-05-25" ] }, "posted_at_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Lte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.", "examples": [ null, "2025-05-25" ] }, "discovered_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Max Age Days", "description": "If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_min_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Min Age Days", "description": "If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_gte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Gte", "description": "Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "discovered_at_lte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Lte", "description": "Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "job_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Or", "description": "Regex patterns to look for in job descriptions. Case-insensitive. Results will include jobs whose description matches any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Not", "description": "Regex patterns to look for in job descriptions. Results will include jobs whose description don't match any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_is_case_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Job Description Pattern Is Case Insensitive", "description": "Whether to make searches on job descriptions case-sensitive or insensitive. Deprecated field and won't work, use job_description_pattern_case_sensitive_or instead.", "default": true, "deprecated": true, "examples": [ null, true, false ] }, "job_description_contains_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Or", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_contains_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Not", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_pattern_case_sensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Case Sensitive Or", "description": "Regex patterns to look for in job descriptions. Case-sensitive. If patterns are uppercase, they will be searched case-sensitively. Results will include jobs whose description matches any of these patterns.", "default": [], "examples": [ [], [ "Python", "JavaScript" ], [ "API", "REST" ] ] }, "remote": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remote", "description": "True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.", "examples": [ null, true, false ] }, "only_jobs_with_reports_to": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Reports To", "description": "Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.", "deprecated": true, "examples": [ null, true, false ] }, "reports_to_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Reports To Exists", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "final_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Final Url Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "only_jobs_with_hiring_managers": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Hiring Managers", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "hiring_managers_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hiring Managers Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "job_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Or", "description": "Get jobs with these IDs only.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Not", "description": "Exclude jobs with these IDs.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_ids": { "items": { "type": "integer" }, "type": "array", "title": "Job Ids", "description": "Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.", "default": [], "deprecated": true }, "job_seniority_or": { "items": { "type": "string", "enum": [ "c_level", "staff", "senior", "junior", "mid_level" ] }, "type": "array", "title": "Job Seniority Or", "description": "Will return jobs where the seniority is any of the ones passed here", "default": [], "examples": [ [], [ "intern", "entry", "mid", "senior", "principal" ] ] }, "min_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Salary Usd", "description": "Minimum annual salary in USD. For example, 100000 means $100,000.", "examples": [ null, 100000, 150000 ] }, "max_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Salary Usd", "description": "Maximum annual salary in USD. For example, 150000 means $150,000.", "examples": [ null, 100000, 150000 ] }, "job_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Or", "description": "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.", "default": [] }, "job_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Not", "description": "Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug And", "description": "Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Or", "description": "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. Use this to find jobs in specific cities, states, or regions.", "default": [], "examples": [ [], [ "san francisco" ], [ "california", "new york" ], [ "madrid" ] ] }, "job_location_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Not", "description": "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.", "default": [], "examples": [ [], [ "new york", "california" ], [ "madrid" ] ] }, "job_location_or": { "items": { "properties": { "id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Id", "description": "Filter by location id. You can discover all the locations from the locations catalog endpoint [GET /v0/catalog/locations](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0)", "examples": [ 3117735 ] } }, "type": "object", "title": "JobLocationFilter" }, "type": "array", "title": "Job Location Or", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "job_location_not": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Not", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "url_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Or", "description": "Include jobs only if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "url_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Not", "description": "Exclude jobs if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "scraper_name_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Scraper Name Pattern Or", "description": "Regex patterns to match job sources. Case-insensitive.", "default": [], "deprecated": true }, "easy_apply": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Easy Apply", "description": "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.", "examples": [ null, true, false ] }, "employment_statuses_or": { "anyOf": [ { "items": { "type": "string", "enum": [ "full_time", "part_time", "temporary", "internship", "contract", "freelance", "co_founder", "apprenticeship", "seasonal", "volunteer", "other" ], "title": "Commitment" }, "type": "array" }, { "type": "null" } ], "title": "Employment Statuses Or", "description": "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.", "examples": [ [], [ "full_time" ], [ "full_time", "part_time" ] ] } }, "additionalProperties": false, "type": "object", "title": "JobFilters" }, { "type": "null" } ] }, "tech_filters": { "anyOf": [ { "properties": { "technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Slug Or", "description": "Will return jobs from companies that that have 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)", "default": [] }, "technology_category_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Category Slug Or", "description": "Will return jobs from companies that that have mentioned any technology from any of these categories in their jobs Case sensitive. Pass slugs. Check out all the technology categories we track at [GET /v0/catalog/technologies/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_categories_v0)", "default": [] }, "technology_parent_category_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Parent Category Slug Or", "description": "Will return jobs from companies that that have mentioned any technology from any of these parent categories in their jobs Case sensitive. Pass slugs. Check out all the technology parent categories we track at [GET /v0/catalog/technologies/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_categories_v0)", "default": [] }, "max_rank": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Rank", "description": "The rank measures how common is a technology within its category. The technology most used among similar ones by a company will have a rank of 1, the second: 2, etc. This is useful to filter results by technology and get only results for the primary technology. ", "examples": [ null ] }, "min_jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Jobs", "description": "Minimum number of jobs found by each company using a technology", "examples": [ null ] }, "max_jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Jobs", "description": "Maximum number of jobs found by each company using a technology", "examples": [ null ] }, "min_relative_occurrence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Relative Occurrence", "description": "Minimum value of relative_occurrence_within_category for each technology. Higher values increase the probability that this technology is actually used by the company, because it means a higher percentage of mentions to technologies among this category are of this technology.", "examples": [ null ] }, "first_date_found_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "First Date Found Gte", "description": "Only return technologies where the first time they were found was after or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "first_date_found_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "First Date Found Lte", "description": "Only return technologies where the first time they were found was before or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "last_date_found_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Date Found Gte", "description": "Only return technologies where the last time they were found was after or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "last_date_found_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Date Found Lte", "description": "Only return technologies where the last time they were found was before or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "confidence_or": { "items": { "type": "string", "enum": [ "low", "medium", "high" ] }, "type": "array", "title": "Confidence Or", "description": "Returns technologies with any of these confidence values that the companies use them. Available values: \"high\", \"medium\", \"low\"", "default": [] } }, "type": "object", "title": "TechnographicsTechnologyFilters" }, { "type": "null" } ] } }, "additionalProperties": false, "type": "object", "title": "CompanySearchFilters" }, { "properties": { "order_by": { "items": { "properties": { "desc": { "type": "boolean", "title": "Desc", "description": "Whether to order by descending or ascending values", "default": true }, "field": { "type": "string", "enum": [ "date_posted", "discovered_at", "salary", "job_title", "company", "num_jobs" ], "title": "Field", "description": "Field to order by", "default": "date_posted" } }, "additionalProperties": false, "type": "object", "title": "ColumnSortJobSearch" }, "type": "array", "title": "Order By", "description": "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.", "default": [ { "desc": true, "field": "date_posted" }, { "desc": true, "field": "discovered_at" } ], "deprecated": true }, "offset": { "type": "integer", "minimum": 0, "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "page": { "type": "integer", "minimum": 0, "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "title": "Limit", "description": "Number of results per page", "default": 25, "examples": [ 25 ] }, "job_title_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Or", "description": "Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Not", "description": "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.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_pattern_and": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern And", "description": "Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Or", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Not", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Or", "description": "2-letter ISO country code of the location of the job. Can pass more than 1", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "job_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Not", "description": "2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "posted_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Posted At Max Age Days", "description": "Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "posted_at_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Gte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.", "examples": [ null, "2025-05-25" ] }, "posted_at_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Lte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.", "examples": [ null, "2025-05-25" ] }, "discovered_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Max Age Days", "description": "If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_min_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Min Age Days", "description": "If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_gte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Gte", "description": "Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "discovered_at_lte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Lte", "description": "Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "job_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Or", "description": "Regex patterns to look for in job descriptions. Case-insensitive. Results will include jobs whose description matches any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Not", "description": "Regex patterns to look for in job descriptions. Results will include jobs whose description don't match any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_is_case_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Job Description Pattern Is Case Insensitive", "description": "Whether to make searches on job descriptions case-sensitive or insensitive. Deprecated field and won't work, use job_description_pattern_case_sensitive_or instead.", "default": true, "deprecated": true, "examples": [ null, true, false ] }, "job_description_contains_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Or", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_contains_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Not", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_pattern_case_sensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Case Sensitive Or", "description": "Regex patterns to look for in job descriptions. Case-sensitive. If patterns are uppercase, they will be searched case-sensitively. Results will include jobs whose description matches any of these patterns.", "default": [], "examples": [ [], [ "Python", "JavaScript" ], [ "API", "REST" ] ] }, "remote": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remote", "description": "True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.", "examples": [ null, true, false ] }, "only_jobs_with_reports_to": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Reports To", "description": "Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.", "deprecated": true, "examples": [ null, true, false ] }, "reports_to_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Reports To Exists", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "final_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Final Url Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "only_jobs_with_hiring_managers": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Hiring Managers", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "hiring_managers_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hiring Managers Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "job_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Or", "description": "Get jobs with these IDs only.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Not", "description": "Exclude jobs with these IDs.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_ids": { "items": { "type": "integer" }, "type": "array", "title": "Job Ids", "description": "Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.", "default": [], "deprecated": true }, "job_seniority_or": { "items": { "type": "string", "enum": [ "c_level", "staff", "senior", "junior", "mid_level" ] }, "type": "array", "title": "Job Seniority Or", "description": "Will return jobs where the seniority is any of the ones passed here", "default": [], "examples": [ [], [ "intern", "entry", "mid", "senior", "principal" ] ] }, "min_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Salary Usd", "description": "Minimum annual salary in USD. For example, 100000 means $100,000.", "examples": [ null, 100000, 150000 ] }, "max_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Salary Usd", "description": "Maximum annual salary in USD. For example, 150000 means $150,000.", "examples": [ null, 100000, 150000 ] }, "job_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Or", "description": "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.", "default": [] }, "job_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Not", "description": "Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug And", "description": "Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Or", "description": "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. Use this to find jobs in specific cities, states, or regions.", "default": [], "examples": [ [], [ "san francisco" ], [ "california", "new york" ], [ "madrid" ] ] }, "job_location_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Not", "description": "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.", "default": [], "examples": [ [], [ "new york", "california" ], [ "madrid" ] ] }, "job_location_or": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Or", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "job_location_not": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Not", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "url_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Or", "description": "Include jobs only if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "url_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Not", "description": "Exclude jobs if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "scraper_name_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Scraper Name Pattern Or", "description": "Regex patterns to match job sources. Case-insensitive.", "default": [], "deprecated": true }, "easy_apply": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Easy Apply", "description": "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.", "examples": [ null, true, false ] }, "employment_statuses_or": { "anyOf": [ { "items": { "$ref": "#/components/schemas/Commitment", "_circular": true }, "type": "array" }, { "type": "null" } ], "title": "Employment Statuses Or", "description": "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.", "examples": [ [], [ "full_time" ], [ "full_time", "part_time" ] ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "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.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_case_insensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Case Insensitive Or", "description": "Only return companies that match these names exactly, case-insensitively.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_id_or": { "items": { "type": "string" }, "type": "array", "title": "Company Id Or", "description": "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.", "default": [], "examples": [ [], [ "1234567890", "1234567891" ] ] }, "company_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Or", "description": "Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.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.", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Not", "description": "Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_name_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Not", "description": "Only return companies that don't match these names exactly, case-sensitively.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Or", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_name_partial_match_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Not", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_linkedin_url_or": { "items": { "type": "string" }, "type": "array", "title": "Company Linkedin Url Or", "description": "Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.", "default": [], "examples": [ [], [ "https://www.linkedin.com/company/google/" ] ] }, "blur_company_data": { "type": "boolean", "title": "Blur Company Data", "description": "Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)", "default": false }, "property_exists_or": { "items": { "type": "string", "enum": [ "company_object.domain", "company_object.linkedin_url", "final_url", "hiring_team", "employment_statuses" ] }, "type": "array", "title": "Property Exists Or", "description": "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.", "default": [], "examples": [ [], [ "company_object.domain", "company_object.linkedin_url", "final_url" ] ] }, "property_exists_and": { "items": { "type": "string", "enum": [ "company_object.domain", "company_object.linkedin_url", "final_url", "hiring_team", "employment_statuses" ] }, "type": "array", "title": "Property Exists And", "default": [], "examples": [ [], [ "company_object.domain", "company_object.linkedin_url", "final_url" ] ] }, "company_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Or", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Not", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_accent_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Description Pattern Accent Insensitive", "description": "Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.", "default": false, "examples": [ null, true, false ] }, "min_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Revenue Usd", "description": "Minimum company revenue, in USD", "examples": [ null ] }, "max_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Revenue Usd", "description": "Maximum company revenue, in USD", "examples": [ null ] }, "min_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count", "description": "Minimum number of employees in a company", "examples": [ null, 100 ] }, "max_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count", "description": "Maximum number of employees in a company", "examples": [ null, 100 ] }, "min_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count Or Null", "description": "Minimum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "max_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count Or Null", "description": "Maximum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "min_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Funding Usd", "description": "Minimum company funding, in USD", "examples": [ null, 1000000000 ] }, "max_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Funding Usd", "description": "Maximum company funding, in USD", "examples": [ null, 1000000000 ] }, "funding_stage_or": { "items": { "type": "string" }, "type": "array", "title": "Funding Stage Or", "description": "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']", "default": [] }, "industry_or": { "items": { "type": "string" }, "type": "array", "title": "Industry Or", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_or field instead. ", "default": [], "deprecated": true }, "industry_not": { "items": { "type": "string" }, "type": "array", "title": "Industry Not", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_not field instead. ", "default": [], "deprecated": true }, "industry_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Or", "description": "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)", "default": [] }, "industry_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Not", "description": "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)", "default": [] }, "company_tags_or": { "items": { "type": "string" }, "type": "array", "title": "Company Tags Or", "description": "Return companies that match any of these keywords", "default": [] }, "company_type": { "anyOf": [ { "type": "string", "enum": [ "recruiting_agency", "direct_employer", "all" ] }, { "type": "null" } ], "title": "Company Type", "description": "Filter by company type." }, "company_investors_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Or", "description": "Investors of the company", "default": [] }, "company_investors_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Partial Match Or", "description": "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).", "default": [] }, "company_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Or", "description": "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)", "default": [] }, "company_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug And", "description": "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)", "default": [] }, "company_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Not", "description": "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)", "default": [] }, "only_yc_companies": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Yc Companies", "description": "Only return YC companies", "default": false }, "company_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Location Pattern Or", "description": "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.", "default": [] }, "company_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Or", "description": "Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Not", "description": "Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_list_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Or", "description": "Return companies that belong to any of the company lists passed here", "default": [] }, "company_list_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Not", "description": "Return companies that don't belong to any of the company lists passed here", "default": [] }, "company_linkedin_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Linkedin Url Exists", "description": "(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL", "deprecated": true, "examples": [ null ] }, "revealed_company_data": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Revealed Company Data", "description": "This field is deprecated and has no effect.", "deprecated": true, "examples": [ null ] }, "last_funding_round_date_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Lte", "description": "Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "last_funding_round_date_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Gte", "description": "Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "include_total_results": { "type": "boolean", "title": "Include Total Results", "description": "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.", "default": false } }, "additionalProperties": false, "type": "object", "title": "JobSearchFilters" } ], "title": "Body", "description": "Filters. CompanySearchFilters if type is 'companies', JobSearchFilters if type is 'jobs'" }, "is_alert_active": { "type": "boolean", "title": "Is Alert Active", "description": "Is the alert active", "default": false }, "user_id": { "type": "integer", "title": "User Id", "description": "Owner of the saved search" }, "team_id": { "type": "integer", "title": "Team Id", "description": "Team of the saved search" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At", "description": "Date and time when the saved search was created" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At", "description": "Date and time when the saved search was last updated" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Query", "description": "Query of the request" }, "path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Path", "description": "Path of the request" }, "querystring_params": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Querystring Params", "description": "Dictionary containing the querystring parameters of the request." }, "creator": { "properties": { "id": { "type": "integer", "title": "Id" }, "email": { "type": "string", "title": "Email", "description": "The user's email address" }, "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "First Name", "description": "The user's first name" }, "last_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Name", "description": "The user's last name" } }, "type": "object", "required": [ "id", "email" ], "title": "UserSimple" }, "is_archived": { "type": "boolean", "title": "Is Archived", "description": "Is the saved search archived", "default": false }, "has_active_webhooks": { "type": "boolean", "title": "Has Active Webhooks", "description": "Has active webhooks", "default": false }, "frequency": { "anyOf": [ { "type": "string", "enum": [ "daily", "weekly" ] }, { "type": "null" } ], "title": "Frequency", "description": "Frequency of emails alerts sent." }, "emails_subscribed": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Emails Subscribed", "description": "Emails subscribed to the saved search alerts.", "default": [] } }, "type": "object", "required": [ "id", "name", "type", "body", "user_id", "team_id", "created_at", "updated_at", "creator" ], "title": "SavedSearchResponseV1" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: List All Saved Searches description: List all the saved searches for the current user. It won't return archived saved searches. url: https://theirstack.com/en/docs/api-reference/saved-searches/get_saved_searches_v0 --- ## OpenAPI Specification ```json { "path": "/v0/saved_searches", "method": "GET", "tags": [ "Saved Searches" ], "summary": "List All Saved Searches", "description": "List all the saved searches for the current user. It won't return archived saved searches.", "operationId": "get_saved_searches_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "user_ids", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "integer" }, "description": "Get saved searches from users with these IDs. The IDs must be from people in the current users' team.", "default": [], "title": "User Ids" }, "description": "Get saved searches from users with these IDs. The IDs must be from people in the current users' team." }, { "name": "types", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "enum": [ "companies", "jobs" ], "type": "string" } }, { "type": "null" } ], "description": "Filter by type of search", "title": "Types" }, "description": "Filter by type of search" }, { "name": "order_by", "in": "query", "required": false, "schema": { "enum": [ "name", "created_at", "updated_at" ], "type": "string", "description": "Order by field", "default": "updated_at", "title": "Order By" }, "description": "Order by field" }, { "name": "order_direction", "in": "query", "required": false, "schema": { "enum": [ "asc", "desc" ], "type": "string", "description": "Order direction", "default": "desc", "title": "Order Direction" }, "description": "Order direction" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "id": { "type": "integer", "title": "Id", "description": "ID of the saved search" }, "name": { "type": "string", "title": "Name", "description": "Name of the saved search" }, "type": { "type": "string", "enum": [ "companies", "jobs" ], "title": "Type", "description": "Type of the saved search." }, "body": { "anyOf": [ { "properties": { "expand_technology_slugs": { "items": { "type": "string" }, "type": "array", "title": "Expand Technology Slugs", "description": "Specify technology slugs to include detailed technology usage information for each company. The response will include a 'technologies_found' field containing metrics like confidence score, ranking, and job count for each specified technology. Note: If a technology is not listed for a company, it means that company does not use that technology. This feature is useful for enriching company data with their technology stack details.", "default": [] }, "order_by": { "items": { "properties": { "desc": { "type": "boolean", "title": "Desc", "description": "Whether to order by descending or ascending values", "default": true }, "field": { "type": "string", "enum": [ "name", "num_jobs", "num_jobs_last_30_days", "num_jobs_found", "employee_count", "alexa_ranking", "founded_year", "annual_revenue_usd", "total_funding_usd", "last_funding_round_date", "confidence", "jobs", "first_date_found" ], "title": "Field", "description": "Order the results by some of these fields" } }, "additionalProperties": false, "type": "object", "required": [ "field" ], "title": "ColumnSortCompanySearch" }, "type": "array", "title": "Order By", "description": "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", "default": [ { "desc": true, "field": "confidence" }, { "desc": true, "field": "num_jobs_found" }, { "desc": true, "field": "num_jobs" }, { "desc": true, "field": "num_jobs" }, { "desc": true, "field": "employee_count" } ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "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.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_case_insensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Case Insensitive Or", "description": "Only return companies that match these names exactly, case-insensitively.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_id_or": { "items": { "type": "string" }, "type": "array", "title": "Company Id Or", "description": "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.", "default": [], "examples": [ [], [ "1234567890", "1234567891" ] ] }, "company_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Or", "description": "Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.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.", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Not", "description": "Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_name_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Not", "description": "Only return companies that don't match these names exactly, case-sensitively.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Or", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_name_partial_match_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Not", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_linkedin_url_or": { "items": { "type": "string" }, "type": "array", "title": "Company Linkedin Url Or", "description": "Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.", "default": [], "examples": [ [], [ "https://www.linkedin.com/company/google/" ] ] }, "blur_company_data": { "type": "boolean", "title": "Blur Company Data", "description": "Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)", "default": false }, "property_exists_or": { "items": { "type": "string", "enum": [ "domain", "linkedin_url" ] }, "type": "array", "title": "Property Exists Or", "description": "Return companies that have any of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have a domain OR a linkedin_url set.", "default": [], "examples": [ [], [ "domain", "linkedin_url" ] ] }, "property_exists_and": { "items": { "type": "string", "enum": [ "domain", "linkedin_url" ] }, "type": "array", "title": "Property Exists And", "description": "Return companies that have all of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have both domain AND linkedin_url set.", "default": [], "examples": [ [], [ "domain", "linkedin_url" ] ] }, "offset": { "type": "integer", "minimum": 0, "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "page": { "type": "integer", "minimum": 0, "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "title": "Limit", "description": "Number of results per page", "default": 25, "examples": [ 25 ] }, "company_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Or", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Not", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_accent_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Description Pattern Accent Insensitive", "description": "Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.", "default": false, "examples": [ null, true, false ] }, "min_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Revenue Usd", "description": "Minimum company revenue, in USD", "examples": [ null ] }, "max_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Revenue Usd", "description": "Maximum company revenue, in USD", "examples": [ null ] }, "min_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count", "description": "Minimum number of employees in a company", "examples": [ null, 100 ] }, "max_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count", "description": "Maximum number of employees in a company", "examples": [ null, 100 ] }, "min_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count Or Null", "description": "Minimum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "max_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count Or Null", "description": "Maximum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "min_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Funding Usd", "description": "Minimum company funding, in USD", "examples": [ null, 1000000000 ] }, "max_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Funding Usd", "description": "Maximum company funding, in USD", "examples": [ null, 1000000000 ] }, "funding_stage_or": { "items": { "type": "string" }, "type": "array", "title": "Funding Stage Or", "description": "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']", "default": [] }, "industry_or": { "items": { "type": "string" }, "type": "array", "title": "Industry Or", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_or field instead. ", "default": [], "deprecated": true }, "industry_not": { "items": { "type": "string" }, "type": "array", "title": "Industry Not", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_not field instead. ", "default": [], "deprecated": true }, "industry_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Or", "description": "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)", "default": [] }, "industry_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Not", "description": "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)", "default": [] }, "company_tags_or": { "items": { "type": "string" }, "type": "array", "title": "Company Tags Or", "description": "Return companies that match any of these keywords", "default": [] }, "company_type": { "anyOf": [ { "type": "string", "enum": [ "recruiting_agency", "direct_employer", "all" ] }, { "type": "null" } ], "title": "Company Type", "description": "Filter by company type." }, "company_investors_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Or", "description": "Investors of the company", "default": [] }, "company_investors_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Partial Match Or", "description": "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).", "default": [] }, "company_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Or", "description": "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)", "default": [] }, "company_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug And", "description": "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)", "default": [] }, "company_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Not", "description": "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)", "default": [] }, "only_yc_companies": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Yc Companies", "description": "Only return YC companies", "default": false }, "company_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Location Pattern Or", "description": "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.", "default": [] }, "company_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Or", "description": "Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Not", "description": "Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_list_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Or", "description": "Return companies that belong to any of the company lists passed here", "default": [] }, "company_list_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Not", "description": "Return companies that don't belong to any of the company lists passed here", "default": [] }, "company_linkedin_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Linkedin Url Exists", "description": "(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL", "deprecated": true, "examples": [ null ] }, "revealed_company_data": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Revealed Company Data", "description": "This field is deprecated and has no effect.", "deprecated": true, "examples": [ null ] }, "last_funding_round_date_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Lte", "description": "Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "last_funding_round_date_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Gte", "description": "Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "include_total_results": { "type": "boolean", "title": "Include Total Results", "description": "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.", "default": false }, "job_filters": { "anyOf": [ { "properties": { "job_title_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Or", "description": "Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Not", "description": "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.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_pattern_and": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern And", "description": "Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Or", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Not", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Or", "description": "2-letter ISO country code of the location of the job. Can pass more than 1", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "job_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Not", "description": "2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "posted_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Posted At Max Age Days", "description": "Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "posted_at_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Gte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.", "examples": [ null, "2025-05-25" ] }, "posted_at_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Lte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.", "examples": [ null, "2025-05-25" ] }, "discovered_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Max Age Days", "description": "If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_min_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Min Age Days", "description": "If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_gte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Gte", "description": "Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "discovered_at_lte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Lte", "description": "Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "job_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Or", "description": "Regex patterns to look for in job descriptions. Case-insensitive. Results will include jobs whose description matches any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Not", "description": "Regex patterns to look for in job descriptions. Results will include jobs whose description don't match any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_is_case_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Job Description Pattern Is Case Insensitive", "description": "Whether to make searches on job descriptions case-sensitive or insensitive. Deprecated field and won't work, use job_description_pattern_case_sensitive_or instead.", "default": true, "deprecated": true, "examples": [ null, true, false ] }, "job_description_contains_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Or", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_contains_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Not", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_pattern_case_sensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Case Sensitive Or", "description": "Regex patterns to look for in job descriptions. Case-sensitive. If patterns are uppercase, they will be searched case-sensitively. Results will include jobs whose description matches any of these patterns.", "default": [], "examples": [ [], [ "Python", "JavaScript" ], [ "API", "REST" ] ] }, "remote": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remote", "description": "True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.", "examples": [ null, true, false ] }, "only_jobs_with_reports_to": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Reports To", "description": "Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.", "deprecated": true, "examples": [ null, true, false ] }, "reports_to_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Reports To Exists", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "final_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Final Url Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "only_jobs_with_hiring_managers": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Hiring Managers", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "hiring_managers_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hiring Managers Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "job_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Or", "description": "Get jobs with these IDs only.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Not", "description": "Exclude jobs with these IDs.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_ids": { "items": { "type": "integer" }, "type": "array", "title": "Job Ids", "description": "Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.", "default": [], "deprecated": true }, "job_seniority_or": { "items": { "type": "string", "enum": [ "c_level", "staff", "senior", "junior", "mid_level" ] }, "type": "array", "title": "Job Seniority Or", "description": "Will return jobs where the seniority is any of the ones passed here", "default": [], "examples": [ [], [ "intern", "entry", "mid", "senior", "principal" ] ] }, "min_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Salary Usd", "description": "Minimum annual salary in USD. For example, 100000 means $100,000.", "examples": [ null, 100000, 150000 ] }, "max_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Salary Usd", "description": "Maximum annual salary in USD. For example, 150000 means $150,000.", "examples": [ null, 100000, 150000 ] }, "job_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Or", "description": "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.", "default": [] }, "job_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Not", "description": "Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug And", "description": "Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Or", "description": "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. Use this to find jobs in specific cities, states, or regions.", "default": [], "examples": [ [], [ "san francisco" ], [ "california", "new york" ], [ "madrid" ] ] }, "job_location_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Not", "description": "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.", "default": [], "examples": [ [], [ "new york", "california" ], [ "madrid" ] ] }, "job_location_or": { "items": { "properties": { "id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Id", "description": "Filter by location id. You can discover all the locations from the locations catalog endpoint [GET /v0/catalog/locations](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0)", "examples": [ 3117735 ] } }, "type": "object", "title": "JobLocationFilter" }, "type": "array", "title": "Job Location Or", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "job_location_not": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Not", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "url_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Or", "description": "Include jobs only if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "url_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Not", "description": "Exclude jobs if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "scraper_name_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Scraper Name Pattern Or", "description": "Regex patterns to match job sources. Case-insensitive.", "default": [], "deprecated": true }, "easy_apply": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Easy Apply", "description": "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.", "examples": [ null, true, false ] }, "employment_statuses_or": { "anyOf": [ { "items": { "type": "string", "enum": [ "full_time", "part_time", "temporary", "internship", "contract", "freelance", "co_founder", "apprenticeship", "seasonal", "volunteer", "other" ], "title": "Commitment" }, "type": "array" }, { "type": "null" } ], "title": "Employment Statuses Or", "description": "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.", "examples": [ [], [ "full_time" ], [ "full_time", "part_time" ] ] } }, "additionalProperties": false, "type": "object", "title": "JobFilters" }, { "type": "null" } ] }, "tech_filters": { "anyOf": [ { "properties": { "technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Slug Or", "description": "Will return jobs from companies that that have 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)", "default": [] }, "technology_category_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Category Slug Or", "description": "Will return jobs from companies that that have mentioned any technology from any of these categories in their jobs Case sensitive. Pass slugs. Check out all the technology categories we track at [GET /v0/catalog/technologies/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_categories_v0)", "default": [] }, "technology_parent_category_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Parent Category Slug Or", "description": "Will return jobs from companies that that have mentioned any technology from any of these parent categories in their jobs Case sensitive. Pass slugs. Check out all the technology parent categories we track at [GET /v0/catalog/technologies/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_categories_v0)", "default": [] }, "max_rank": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Rank", "description": "The rank measures how common is a technology within its category. The technology most used among similar ones by a company will have a rank of 1, the second: 2, etc. This is useful to filter results by technology and get only results for the primary technology. ", "examples": [ null ] }, "min_jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Jobs", "description": "Minimum number of jobs found by each company using a technology", "examples": [ null ] }, "max_jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Jobs", "description": "Maximum number of jobs found by each company using a technology", "examples": [ null ] }, "min_relative_occurrence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Relative Occurrence", "description": "Minimum value of relative_occurrence_within_category for each technology. Higher values increase the probability that this technology is actually used by the company, because it means a higher percentage of mentions to technologies among this category are of this technology.", "examples": [ null ] }, "first_date_found_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "First Date Found Gte", "description": "Only return technologies where the first time they were found was after or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "first_date_found_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "First Date Found Lte", "description": "Only return technologies where the first time they were found was before or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "last_date_found_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Date Found Gte", "description": "Only return technologies where the last time they were found was after or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "last_date_found_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Date Found Lte", "description": "Only return technologies where the last time they were found was before or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "confidence_or": { "items": { "type": "string", "enum": [ "low", "medium", "high" ] }, "type": "array", "title": "Confidence Or", "description": "Returns technologies with any of these confidence values that the companies use them. Available values: \"high\", \"medium\", \"low\"", "default": [] } }, "type": "object", "title": "TechnographicsTechnologyFilters" }, { "type": "null" } ] } }, "additionalProperties": false, "type": "object", "title": "CompanySearchFilters" }, { "properties": { "order_by": { "items": { "properties": { "desc": { "type": "boolean", "title": "Desc", "description": "Whether to order by descending or ascending values", "default": true }, "field": { "type": "string", "enum": [ "date_posted", "discovered_at", "salary", "job_title", "company", "num_jobs" ], "title": "Field", "description": "Field to order by", "default": "date_posted" } }, "additionalProperties": false, "type": "object", "title": "ColumnSortJobSearch" }, "type": "array", "title": "Order By", "description": "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.", "default": [ { "desc": true, "field": "date_posted" }, { "desc": true, "field": "discovered_at" } ], "deprecated": true }, "offset": { "type": "integer", "minimum": 0, "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "page": { "type": "integer", "minimum": 0, "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "title": "Limit", "description": "Number of results per page", "default": 25, "examples": [ 25 ] }, "job_title_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Or", "description": "Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Not", "description": "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.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_pattern_and": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern And", "description": "Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Or", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Not", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Or", "description": "2-letter ISO country code of the location of the job. Can pass more than 1", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "job_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Not", "description": "2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "posted_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Posted At Max Age Days", "description": "Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "posted_at_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Gte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.", "examples": [ null, "2025-05-25" ] }, "posted_at_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Lte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.", "examples": [ null, "2025-05-25" ] }, "discovered_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Max Age Days", "description": "If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_min_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Min Age Days", "description": "If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_gte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Gte", "description": "Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "discovered_at_lte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Lte", "description": "Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "job_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Or", "description": "Regex patterns to look for in job descriptions. Case-insensitive. Results will include jobs whose description matches any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Not", "description": "Regex patterns to look for in job descriptions. Results will include jobs whose description don't match any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_is_case_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Job Description Pattern Is Case Insensitive", "description": "Whether to make searches on job descriptions case-sensitive or insensitive. Deprecated field and won't work, use job_description_pattern_case_sensitive_or instead.", "default": true, "deprecated": true, "examples": [ null, true, false ] }, "job_description_contains_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Or", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_contains_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Not", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_pattern_case_sensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Case Sensitive Or", "description": "Regex patterns to look for in job descriptions. Case-sensitive. If patterns are uppercase, they will be searched case-sensitively. Results will include jobs whose description matches any of these patterns.", "default": [], "examples": [ [], [ "Python", "JavaScript" ], [ "API", "REST" ] ] }, "remote": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remote", "description": "True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.", "examples": [ null, true, false ] }, "only_jobs_with_reports_to": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Reports To", "description": "Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.", "deprecated": true, "examples": [ null, true, false ] }, "reports_to_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Reports To Exists", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "final_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Final Url Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "only_jobs_with_hiring_managers": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Hiring Managers", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "hiring_managers_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hiring Managers Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "job_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Or", "description": "Get jobs with these IDs only.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Not", "description": "Exclude jobs with these IDs.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_ids": { "items": { "type": "integer" }, "type": "array", "title": "Job Ids", "description": "Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.", "default": [], "deprecated": true }, "job_seniority_or": { "items": { "type": "string", "enum": [ "c_level", "staff", "senior", "junior", "mid_level" ] }, "type": "array", "title": "Job Seniority Or", "description": "Will return jobs where the seniority is any of the ones passed here", "default": [], "examples": [ [], [ "intern", "entry", "mid", "senior", "principal" ] ] }, "min_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Salary Usd", "description": "Minimum annual salary in USD. For example, 100000 means $100,000.", "examples": [ null, 100000, 150000 ] }, "max_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Salary Usd", "description": "Maximum annual salary in USD. For example, 150000 means $150,000.", "examples": [ null, 100000, 150000 ] }, "job_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Or", "description": "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.", "default": [] }, "job_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Not", "description": "Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug And", "description": "Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Or", "description": "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. Use this to find jobs in specific cities, states, or regions.", "default": [], "examples": [ [], [ "san francisco" ], [ "california", "new york" ], [ "madrid" ] ] }, "job_location_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Not", "description": "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.", "default": [], "examples": [ [], [ "new york", "california" ], [ "madrid" ] ] }, "job_location_or": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Or", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "job_location_not": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Not", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "url_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Or", "description": "Include jobs only if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "url_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Not", "description": "Exclude jobs if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "scraper_name_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Scraper Name Pattern Or", "description": "Regex patterns to match job sources. Case-insensitive.", "default": [], "deprecated": true }, "easy_apply": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Easy Apply", "description": "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.", "examples": [ null, true, false ] }, "employment_statuses_or": { "anyOf": [ { "items": { "$ref": "#/components/schemas/Commitment", "_circular": true }, "type": "array" }, { "type": "null" } ], "title": "Employment Statuses Or", "description": "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.", "examples": [ [], [ "full_time" ], [ "full_time", "part_time" ] ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "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.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_case_insensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Case Insensitive Or", "description": "Only return companies that match these names exactly, case-insensitively.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_id_or": { "items": { "type": "string" }, "type": "array", "title": "Company Id Or", "description": "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.", "default": [], "examples": [ [], [ "1234567890", "1234567891" ] ] }, "company_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Or", "description": "Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.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.", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Not", "description": "Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_name_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Not", "description": "Only return companies that don't match these names exactly, case-sensitively.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Or", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_name_partial_match_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Not", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_linkedin_url_or": { "items": { "type": "string" }, "type": "array", "title": "Company Linkedin Url Or", "description": "Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.", "default": [], "examples": [ [], [ "https://www.linkedin.com/company/google/" ] ] }, "blur_company_data": { "type": "boolean", "title": "Blur Company Data", "description": "Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)", "default": false }, "property_exists_or": { "items": { "type": "string", "enum": [ "company_object.domain", "company_object.linkedin_url", "final_url", "hiring_team", "employment_statuses" ] }, "type": "array", "title": "Property Exists Or", "description": "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.", "default": [], "examples": [ [], [ "company_object.domain", "company_object.linkedin_url", "final_url" ] ] }, "property_exists_and": { "items": { "type": "string", "enum": [ "company_object.domain", "company_object.linkedin_url", "final_url", "hiring_team", "employment_statuses" ] }, "type": "array", "title": "Property Exists And", "default": [], "examples": [ [], [ "company_object.domain", "company_object.linkedin_url", "final_url" ] ] }, "company_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Or", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Not", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_accent_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Description Pattern Accent Insensitive", "description": "Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.", "default": false, "examples": [ null, true, false ] }, "min_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Revenue Usd", "description": "Minimum company revenue, in USD", "examples": [ null ] }, "max_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Revenue Usd", "description": "Maximum company revenue, in USD", "examples": [ null ] }, "min_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count", "description": "Minimum number of employees in a company", "examples": [ null, 100 ] }, "max_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count", "description": "Maximum number of employees in a company", "examples": [ null, 100 ] }, "min_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count Or Null", "description": "Minimum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "max_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count Or Null", "description": "Maximum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "min_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Funding Usd", "description": "Minimum company funding, in USD", "examples": [ null, 1000000000 ] }, "max_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Funding Usd", "description": "Maximum company funding, in USD", "examples": [ null, 1000000000 ] }, "funding_stage_or": { "items": { "type": "string" }, "type": "array", "title": "Funding Stage Or", "description": "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']", "default": [] }, "industry_or": { "items": { "type": "string" }, "type": "array", "title": "Industry Or", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_or field instead. ", "default": [], "deprecated": true }, "industry_not": { "items": { "type": "string" }, "type": "array", "title": "Industry Not", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_not field instead. ", "default": [], "deprecated": true }, "industry_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Or", "description": "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)", "default": [] }, "industry_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Not", "description": "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)", "default": [] }, "company_tags_or": { "items": { "type": "string" }, "type": "array", "title": "Company Tags Or", "description": "Return companies that match any of these keywords", "default": [] }, "company_type": { "anyOf": [ { "type": "string", "enum": [ "recruiting_agency", "direct_employer", "all" ] }, { "type": "null" } ], "title": "Company Type", "description": "Filter by company type." }, "company_investors_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Or", "description": "Investors of the company", "default": [] }, "company_investors_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Partial Match Or", "description": "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).", "default": [] }, "company_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Or", "description": "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)", "default": [] }, "company_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug And", "description": "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)", "default": [] }, "company_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Not", "description": "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)", "default": [] }, "only_yc_companies": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Yc Companies", "description": "Only return YC companies", "default": false }, "company_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Location Pattern Or", "description": "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.", "default": [] }, "company_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Or", "description": "Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Not", "description": "Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_list_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Or", "description": "Return companies that belong to any of the company lists passed here", "default": [] }, "company_list_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Not", "description": "Return companies that don't belong to any of the company lists passed here", "default": [] }, "company_linkedin_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Linkedin Url Exists", "description": "(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL", "deprecated": true, "examples": [ null ] }, "revealed_company_data": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Revealed Company Data", "description": "This field is deprecated and has no effect.", "deprecated": true, "examples": [ null ] }, "last_funding_round_date_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Lte", "description": "Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "last_funding_round_date_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Gte", "description": "Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "include_total_results": { "type": "boolean", "title": "Include Total Results", "description": "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.", "default": false } }, "additionalProperties": false, "type": "object", "title": "JobSearchFilters" } ], "title": "Body", "description": "Filters. CompanySearchFilters if type is 'companies', JobSearchFilters if type is 'jobs'" }, "is_alert_active": { "type": "boolean", "title": "Is Alert Active", "description": "Is the alert active", "default": false }, "user_id": { "type": "integer", "title": "User Id", "description": "Owner of the saved search" }, "team_id": { "type": "integer", "title": "Team Id", "description": "Team of the saved search" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At", "description": "Date and time when the saved search was created" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At", "description": "Date and time when the saved search was last updated" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Query", "description": "Query of the request" }, "path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Path", "description": "Path of the request" }, "querystring_params": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Querystring Params", "description": "Dictionary containing the querystring parameters of the request." }, "creator": { "properties": { "id": { "type": "integer", "title": "Id" }, "email": { "type": "string", "title": "Email", "description": "The user's email address" }, "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "First Name", "description": "The user's first name" }, "last_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Name", "description": "The user's last name" } }, "type": "object", "required": [ "id", "email" ], "title": "UserSimple" }, "is_archived": { "type": "boolean", "title": "Is Archived", "description": "Is the saved search archived", "default": false }, "has_active_webhooks": { "type": "boolean", "title": "Has Active Webhooks", "description": "Has active webhooks", "default": false }, "frequency": { "anyOf": [ { "type": "string", "enum": [ "daily", "weekly" ] }, { "type": "null" } ], "title": "Frequency", "description": "Frequency of emails alerts sent." }, "emails_subscribed": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Emails Subscribed", "description": "Emails subscribed to the saved search alerts.", "default": [] } }, "type": "object", "required": [ "id", "name", "type", "body", "user_id", "team_id", "created_at", "updated_at", "creator" ], "title": "SavedSearchResponseV1" }, "title": "Response Get Saved Searches V0" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Archive Saved Search description: Archive a saved search url: https://theirstack.com/en/docs/api-reference/saved-searches/patch_saved_searches_archive_v0 --- ## OpenAPI Specification ```json { "path": "/v0/saved_searches/{search_id}/archive", "method": "PATCH", "tags": [ "Saved Searches" ], "summary": "Archive Saved Search", "description": "Archive a saved search", "operationId": "patch_saved_searches_archive_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "search_id", "in": "path", "required": true, "schema": { "type": "integer", "description": "The ID of the saved search", "title": "Search Id" }, "description": "The ID of the saved search" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" }, "title": "Response Patch Saved Searches Archive V0" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Update Saved Search description: undefined url: https://theirstack.com/en/docs/api-reference/saved-searches/patch_saved_searches_by_id_v0 --- ## OpenAPI Specification ```json { "path": "/v0/saved_searches/{search_id}", "method": "PATCH", "tags": [ "Saved Searches" ], "summary": "Update Saved Search", "operationId": "patch_saved_searches_by_id_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "search_id", "in": "path", "required": true, "schema": { "type": "integer", "description": "The ID of the saved search", "title": "Search Id" }, "description": "The ID of the saved search" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name", "description": "Name of the saved search" }, "body": { "anyOf": [ { "properties": { "expand_technology_slugs": { "items": { "type": "string" }, "type": "array", "title": "Expand Technology Slugs", "description": "Specify technology slugs to include detailed technology usage information for each company. The response will include a 'technologies_found' field containing metrics like confidence score, ranking, and job count for each specified technology. Note: If a technology is not listed for a company, it means that company does not use that technology. This feature is useful for enriching company data with their technology stack details.", "default": [] }, "order_by": { "items": { "properties": { "desc": { "type": "boolean", "title": "Desc", "description": "Whether to order by descending or ascending values", "default": true }, "field": { "type": "string", "enum": [ "name", "num_jobs", "num_jobs_last_30_days", "num_jobs_found", "employee_count", "alexa_ranking", "founded_year", "annual_revenue_usd", "total_funding_usd", "last_funding_round_date", "confidence", "jobs", "first_date_found" ], "title": "Field", "description": "Order the results by some of these fields" } }, "additionalProperties": false, "type": "object", "required": [ "field" ], "title": "ColumnSortCompanySearch" }, "type": "array", "title": "Order By", "description": "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", "default": [ { "desc": true, "field": "confidence" }, { "desc": true, "field": "num_jobs_found" }, { "desc": true, "field": "num_jobs" }, { "desc": true, "field": "num_jobs" }, { "desc": true, "field": "employee_count" } ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "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.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_case_insensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Case Insensitive Or", "description": "Only return companies that match these names exactly, case-insensitively.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_id_or": { "items": { "type": "string" }, "type": "array", "title": "Company Id Or", "description": "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.", "default": [], "examples": [ [], [ "1234567890", "1234567891" ] ] }, "company_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Or", "description": "Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.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.", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Not", "description": "Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_name_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Not", "description": "Only return companies that don't match these names exactly, case-sensitively.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Or", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_name_partial_match_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Not", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_linkedin_url_or": { "items": { "type": "string" }, "type": "array", "title": "Company Linkedin Url Or", "description": "Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.", "default": [], "examples": [ [], [ "https://www.linkedin.com/company/google/" ] ] }, "blur_company_data": { "type": "boolean", "title": "Blur Company Data", "description": "Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)", "default": false }, "property_exists_or": { "items": { "type": "string", "enum": [ "domain", "linkedin_url" ] }, "type": "array", "title": "Property Exists Or", "description": "Return companies that have any of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have a domain OR a linkedin_url set.", "default": [], "examples": [ [], [ "domain", "linkedin_url" ] ] }, "property_exists_and": { "items": { "type": "string", "enum": [ "domain", "linkedin_url" ] }, "type": "array", "title": "Property Exists And", "description": "Return companies that have all of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have both domain AND linkedin_url set.", "default": [], "examples": [ [], [ "domain", "linkedin_url" ] ] }, "offset": { "type": "integer", "minimum": 0, "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "page": { "type": "integer", "minimum": 0, "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "title": "Limit", "description": "Number of results per page", "default": 25, "examples": [ 25 ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cursor", "description": "Cursor for pagination" }, "company_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Or", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Not", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_accent_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Description Pattern Accent Insensitive", "description": "Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.", "default": false, "examples": [ null, true, false ] }, "min_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Revenue Usd", "description": "Minimum company revenue, in USD", "examples": [ null ] }, "max_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Revenue Usd", "description": "Maximum company revenue, in USD", "examples": [ null ] }, "min_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count", "description": "Minimum number of employees in a company", "examples": [ null, 100 ] }, "max_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count", "description": "Maximum number of employees in a company", "examples": [ null, 100 ] }, "min_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count Or Null", "description": "Minimum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "max_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count Or Null", "description": "Maximum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "min_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Funding Usd", "description": "Minimum company funding, in USD", "examples": [ null, 1000000000 ] }, "max_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Funding Usd", "description": "Maximum company funding, in USD", "examples": [ null, 1000000000 ] }, "funding_stage_or": { "items": { "type": "string" }, "type": "array", "title": "Funding Stage Or", "description": "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']", "default": [] }, "industry_or": { "items": { "type": "string" }, "type": "array", "title": "Industry Or", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_or field instead. ", "default": [], "deprecated": true }, "industry_not": { "items": { "type": "string" }, "type": "array", "title": "Industry Not", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_not field instead. ", "default": [], "deprecated": true }, "industry_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Or", "description": "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)", "default": [] }, "industry_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Not", "description": "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)", "default": [] }, "company_tags_or": { "items": { "type": "string" }, "type": "array", "title": "Company Tags Or", "description": "Return companies that match any of these keywords", "default": [] }, "company_type": { "anyOf": [ { "type": "string", "enum": [ "recruiting_agency", "direct_employer", "all" ] }, { "type": "null" } ], "title": "Company Type", "description": "Filter by company type." }, "company_investors_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Or", "description": "Investors of the company", "default": [] }, "company_investors_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Partial Match Or", "description": "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).", "default": [] }, "company_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Or", "description": "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)", "default": [] }, "company_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug And", "description": "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)", "default": [] }, "company_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Not", "description": "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)", "default": [] }, "only_yc_companies": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Yc Companies", "description": "Only return YC companies", "default": false }, "company_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Location Pattern Or", "description": "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.", "default": [] }, "company_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Or", "description": "Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Not", "description": "Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_list_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Or", "description": "Return companies that belong to any of the company lists passed here", "default": [] }, "company_list_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Not", "description": "Return companies that don't belong to any of the company lists passed here", "default": [] }, "company_linkedin_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Linkedin Url Exists", "description": "(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL", "deprecated": true, "examples": [ null ] }, "revealed_company_data": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Revealed Company Data", "description": "This field is deprecated and has no effect.", "deprecated": true, "examples": [ null ] }, "last_funding_round_date_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Lte", "description": "Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "last_funding_round_date_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Gte", "description": "Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "include_total_results": { "type": "boolean", "title": "Include Total Results", "description": "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.", "default": false }, "job_filters": { "anyOf": [ { "properties": { "job_title_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Or", "description": "Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Not", "description": "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.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_pattern_and": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern And", "description": "Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Or", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Not", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Or", "description": "2-letter ISO country code of the location of the job. Can pass more than 1", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "job_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Not", "description": "2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "posted_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Posted At Max Age Days", "description": "Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "posted_at_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Gte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.", "examples": [ null, "2025-05-25" ] }, "posted_at_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Lte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.", "examples": [ null, "2025-05-25" ] }, "discovered_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Max Age Days", "description": "If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_min_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Min Age Days", "description": "If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_gte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Gte", "description": "Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "discovered_at_lte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Lte", "description": "Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "job_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Or", "description": "Regex patterns to look for in job descriptions. Case-insensitive. Results will include jobs whose description matches any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Not", "description": "Regex patterns to look for in job descriptions. Results will include jobs whose description don't match any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_is_case_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Job Description Pattern Is Case Insensitive", "description": "Whether to make searches on job descriptions case-sensitive or insensitive. Deprecated field and won't work, use job_description_pattern_case_sensitive_or instead.", "default": true, "deprecated": true, "examples": [ null, true, false ] }, "job_description_contains_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Or", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_contains_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Not", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_pattern_case_sensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Case Sensitive Or", "description": "Regex patterns to look for in job descriptions. Case-sensitive. If patterns are uppercase, they will be searched case-sensitively. Results will include jobs whose description matches any of these patterns.", "default": [], "examples": [ [], [ "Python", "JavaScript" ], [ "API", "REST" ] ] }, "remote": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remote", "description": "True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.", "examples": [ null, true, false ] }, "only_jobs_with_reports_to": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Reports To", "description": "Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.", "deprecated": true, "examples": [ null, true, false ] }, "reports_to_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Reports To Exists", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "final_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Final Url Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "only_jobs_with_hiring_managers": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Hiring Managers", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "hiring_managers_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hiring Managers Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "job_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Or", "description": "Get jobs with these IDs only.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Not", "description": "Exclude jobs with these IDs.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_ids": { "items": { "type": "integer" }, "type": "array", "title": "Job Ids", "description": "Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.", "default": [], "deprecated": true }, "job_seniority_or": { "items": { "type": "string", "enum": [ "c_level", "staff", "senior", "junior", "mid_level" ] }, "type": "array", "title": "Job Seniority Or", "description": "Will return jobs where the seniority is any of the ones passed here", "default": [], "examples": [ [], [ "intern", "entry", "mid", "senior", "principal" ] ] }, "min_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Salary Usd", "description": "Minimum annual salary in USD. For example, 100000 means $100,000.", "examples": [ null, 100000, 150000 ] }, "max_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Salary Usd", "description": "Maximum annual salary in USD. For example, 150000 means $150,000.", "examples": [ null, 100000, 150000 ] }, "job_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Or", "description": "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.", "default": [] }, "job_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Not", "description": "Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug And", "description": "Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Or", "description": "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. Use this to find jobs in specific cities, states, or regions.", "default": [], "examples": [ [], [ "san francisco" ], [ "california", "new york" ], [ "madrid" ] ] }, "job_location_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Not", "description": "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.", "default": [], "examples": [ [], [ "new york", "california" ], [ "madrid" ] ] }, "job_location_or": { "items": { "properties": { "id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Id", "description": "Filter by location id. You can discover all the locations from the locations catalog endpoint [GET /v0/catalog/locations](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0)", "examples": [ 3117735 ] } }, "type": "object", "title": "JobLocationFilter" }, "type": "array", "title": "Job Location Or", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "job_location_not": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Not", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "url_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Or", "description": "Include jobs only if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "url_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Not", "description": "Exclude jobs if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "scraper_name_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Scraper Name Pattern Or", "description": "Regex patterns to match job sources. Case-insensitive.", "default": [], "deprecated": true }, "easy_apply": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Easy Apply", "description": "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.", "examples": [ null, true, false ] }, "employment_statuses_or": { "anyOf": [ { "items": { "type": "string", "enum": [ "full_time", "part_time", "temporary", "internship", "contract", "freelance", "co_founder", "apprenticeship", "seasonal", "volunteer", "other" ], "title": "Commitment" }, "type": "array" }, { "type": "null" } ], "title": "Employment Statuses Or", "description": "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.", "examples": [ [], [ "full_time" ], [ "full_time", "part_time" ] ] } }, "additionalProperties": false, "type": "object", "title": "JobFilters" }, { "type": "null" } ] }, "tech_filters": { "anyOf": [ { "properties": { "technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Slug Or", "description": "Will return jobs from companies that that have 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)", "default": [] }, "technology_category_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Category Slug Or", "description": "Will return jobs from companies that that have mentioned any technology from any of these categories in their jobs Case sensitive. Pass slugs. Check out all the technology categories we track at [GET /v0/catalog/technologies/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_categories_v0)", "default": [] }, "technology_parent_category_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Parent Category Slug Or", "description": "Will return jobs from companies that that have mentioned any technology from any of these parent categories in their jobs Case sensitive. Pass slugs. Check out all the technology parent categories we track at [GET /v0/catalog/technologies/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_categories_v0)", "default": [] }, "max_rank": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Rank", "description": "The rank measures how common is a technology within its category. The technology most used among similar ones by a company will have a rank of 1, the second: 2, etc. This is useful to filter results by technology and get only results for the primary technology. ", "examples": [ null ] }, "min_jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Jobs", "description": "Minimum number of jobs found by each company using a technology", "examples": [ null ] }, "max_jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Jobs", "description": "Maximum number of jobs found by each company using a technology", "examples": [ null ] }, "min_relative_occurrence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Relative Occurrence", "description": "Minimum value of relative_occurrence_within_category for each technology. Higher values increase the probability that this technology is actually used by the company, because it means a higher percentage of mentions to technologies among this category are of this technology.", "examples": [ null ] }, "first_date_found_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "First Date Found Gte", "description": "Only return technologies where the first time they were found was after or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "first_date_found_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "First Date Found Lte", "description": "Only return technologies where the first time they were found was before or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "last_date_found_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Date Found Gte", "description": "Only return technologies where the last time they were found was after or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "last_date_found_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Date Found Lte", "description": "Only return technologies where the last time they were found was before or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "confidence_or": { "items": { "type": "string", "enum": [ "low", "medium", "high" ] }, "type": "array", "title": "Confidence Or", "description": "Returns technologies with any of these confidence values that the companies use them. Available values: \"high\", \"medium\", \"low\"", "default": [] } }, "type": "object", "title": "TechnographicsTechnologyFilters" }, { "type": "null" } ] } }, "additionalProperties": false, "type": "object", "title": "CompanySearchFilters" }, { "properties": { "order_by": { "items": { "properties": { "desc": { "type": "boolean", "title": "Desc", "description": "Whether to order by descending or ascending values", "default": true }, "field": { "type": "string", "enum": [ "date_posted", "discovered_at", "salary", "job_title", "company", "num_jobs" ], "title": "Field", "description": "Field to order by", "default": "date_posted" } }, "additionalProperties": false, "type": "object", "title": "ColumnSortJobSearch" }, "type": "array", "title": "Order By", "description": "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.", "default": [ { "desc": true, "field": "date_posted" }, { "desc": true, "field": "discovered_at" } ], "deprecated": true }, "offset": { "type": "integer", "minimum": 0, "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "page": { "type": "integer", "minimum": 0, "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "title": "Limit", "description": "Number of results per page", "default": 25, "examples": [ 25 ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cursor", "description": "Cursor for pagination" }, "job_title_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Or", "description": "Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Not", "description": "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.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_pattern_and": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern And", "description": "Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Or", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Not", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Or", "description": "2-letter ISO country code of the location of the job. Can pass more than 1", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "job_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Not", "description": "2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "posted_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Posted At Max Age Days", "description": "Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "posted_at_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Gte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.", "examples": [ null, "2025-05-25" ] }, "posted_at_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Lte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.", "examples": [ null, "2025-05-25" ] }, "discovered_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Max Age Days", "description": "If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_min_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Min Age Days", "description": "If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_gte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Gte", "description": "Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "discovered_at_lte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Lte", "description": "Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "job_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Or", "description": "Regex patterns to look for in job descriptions. Case-insensitive. Results will include jobs whose description matches any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Not", "description": "Regex patterns to look for in job descriptions. Results will include jobs whose description don't match any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_is_case_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Job Description Pattern Is Case Insensitive", "description": "Whether to make searches on job descriptions case-sensitive or insensitive. Deprecated field and won't work, use job_description_pattern_case_sensitive_or instead.", "default": true, "deprecated": true, "examples": [ null, true, false ] }, "job_description_contains_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Or", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_contains_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Not", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_pattern_case_sensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Case Sensitive Or", "description": "Regex patterns to look for in job descriptions. Case-sensitive. If patterns are uppercase, they will be searched case-sensitively. Results will include jobs whose description matches any of these patterns.", "default": [], "examples": [ [], [ "Python", "JavaScript" ], [ "API", "REST" ] ] }, "remote": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remote", "description": "True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.", "examples": [ null, true, false ] }, "only_jobs_with_reports_to": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Reports To", "description": "Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.", "deprecated": true, "examples": [ null, true, false ] }, "reports_to_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Reports To Exists", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "final_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Final Url Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "only_jobs_with_hiring_managers": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Hiring Managers", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "hiring_managers_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hiring Managers Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "job_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Or", "description": "Get jobs with these IDs only.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Not", "description": "Exclude jobs with these IDs.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_ids": { "items": { "type": "integer" }, "type": "array", "title": "Job Ids", "description": "Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.", "default": [], "deprecated": true }, "job_seniority_or": { "items": { "type": "string", "enum": [ "c_level", "staff", "senior", "junior", "mid_level" ] }, "type": "array", "title": "Job Seniority Or", "description": "Will return jobs where the seniority is any of the ones passed here", "default": [], "examples": [ [], [ "intern", "entry", "mid", "senior", "principal" ] ] }, "min_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Salary Usd", "description": "Minimum annual salary in USD. For example, 100000 means $100,000.", "examples": [ null, 100000, 150000 ] }, "max_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Salary Usd", "description": "Maximum annual salary in USD. For example, 150000 means $150,000.", "examples": [ null, 100000, 150000 ] }, "job_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Or", "description": "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.", "default": [] }, "job_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Not", "description": "Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug And", "description": "Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Or", "description": "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. Use this to find jobs in specific cities, states, or regions.", "default": [], "examples": [ [], [ "san francisco" ], [ "california", "new york" ], [ "madrid" ] ] }, "job_location_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Not", "description": "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.", "default": [], "examples": [ [], [ "new york", "california" ], [ "madrid" ] ] }, "job_location_or": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Or", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "job_location_not": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Not", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "url_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Or", "description": "Include jobs only if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "url_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Not", "description": "Exclude jobs if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "scraper_name_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Scraper Name Pattern Or", "description": "Regex patterns to match job sources. Case-insensitive.", "default": [], "deprecated": true }, "easy_apply": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Easy Apply", "description": "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.", "examples": [ null, true, false ] }, "employment_statuses_or": { "anyOf": [ { "items": { "$ref": "#/components/schemas/Commitment", "_circular": true }, "type": "array" }, { "type": "null" } ], "title": "Employment Statuses Or", "description": "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.", "examples": [ [], [ "full_time" ], [ "full_time", "part_time" ] ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "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.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_case_insensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Case Insensitive Or", "description": "Only return companies that match these names exactly, case-insensitively.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_id_or": { "items": { "type": "string" }, "type": "array", "title": "Company Id Or", "description": "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.", "default": [], "examples": [ [], [ "1234567890", "1234567891" ] ] }, "company_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Or", "description": "Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.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.", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Not", "description": "Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_name_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Not", "description": "Only return companies that don't match these names exactly, case-sensitively.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Or", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_name_partial_match_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Not", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_linkedin_url_or": { "items": { "type": "string" }, "type": "array", "title": "Company Linkedin Url Or", "description": "Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.", "default": [], "examples": [ [], [ "https://www.linkedin.com/company/google/" ] ] }, "blur_company_data": { "type": "boolean", "title": "Blur Company Data", "description": "Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)", "default": false }, "property_exists_or": { "items": { "type": "string", "enum": [ "company_object.domain", "company_object.linkedin_url", "final_url", "hiring_team", "employment_statuses" ] }, "type": "array", "title": "Property Exists Or", "description": "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.", "default": [], "examples": [ [], [ "company_object.domain", "company_object.linkedin_url", "final_url" ] ] }, "property_exists_and": { "items": { "type": "string", "enum": [ "company_object.domain", "company_object.linkedin_url", "final_url", "hiring_team", "employment_statuses" ] }, "type": "array", "title": "Property Exists And", "default": [], "examples": [ [], [ "company_object.domain", "company_object.linkedin_url", "final_url" ] ] }, "company_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Or", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Not", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_accent_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Description Pattern Accent Insensitive", "description": "Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.", "default": false, "examples": [ null, true, false ] }, "min_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Revenue Usd", "description": "Minimum company revenue, in USD", "examples": [ null ] }, "max_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Revenue Usd", "description": "Maximum company revenue, in USD", "examples": [ null ] }, "min_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count", "description": "Minimum number of employees in a company", "examples": [ null, 100 ] }, "max_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count", "description": "Maximum number of employees in a company", "examples": [ null, 100 ] }, "min_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count Or Null", "description": "Minimum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "max_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count Or Null", "description": "Maximum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "min_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Funding Usd", "description": "Minimum company funding, in USD", "examples": [ null, 1000000000 ] }, "max_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Funding Usd", "description": "Maximum company funding, in USD", "examples": [ null, 1000000000 ] }, "funding_stage_or": { "items": { "type": "string" }, "type": "array", "title": "Funding Stage Or", "description": "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']", "default": [] }, "industry_or": { "items": { "type": "string" }, "type": "array", "title": "Industry Or", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_or field instead. ", "default": [], "deprecated": true }, "industry_not": { "items": { "type": "string" }, "type": "array", "title": "Industry Not", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_not field instead. ", "default": [], "deprecated": true }, "industry_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Or", "description": "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)", "default": [] }, "industry_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Not", "description": "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)", "default": [] }, "company_tags_or": { "items": { "type": "string" }, "type": "array", "title": "Company Tags Or", "description": "Return companies that match any of these keywords", "default": [] }, "company_type": { "anyOf": [ { "type": "string", "enum": [ "recruiting_agency", "direct_employer", "all" ] }, { "type": "null" } ], "title": "Company Type", "description": "Filter by company type." }, "company_investors_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Or", "description": "Investors of the company", "default": [] }, "company_investors_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Partial Match Or", "description": "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).", "default": [] }, "company_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Or", "description": "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)", "default": [] }, "company_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug And", "description": "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)", "default": [] }, "company_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Not", "description": "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)", "default": [] }, "only_yc_companies": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Yc Companies", "description": "Only return YC companies", "default": false }, "company_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Location Pattern Or", "description": "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.", "default": [] }, "company_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Or", "description": "Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Not", "description": "Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_list_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Or", "description": "Return companies that belong to any of the company lists passed here", "default": [] }, "company_list_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Not", "description": "Return companies that don't belong to any of the company lists passed here", "default": [] }, "company_linkedin_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Linkedin Url Exists", "description": "(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL", "deprecated": true, "examples": [ null ] }, "revealed_company_data": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Revealed Company Data", "description": "This field is deprecated and has no effect.", "deprecated": true, "examples": [ null ] }, "last_funding_round_date_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Lte", "description": "Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "last_funding_round_date_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Gte", "description": "Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "include_total_results": { "type": "boolean", "title": "Include Total Results", "description": "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.", "default": false } }, "additionalProperties": false, "type": "object", "title": "JobSearchFilters" }, { "type": "null" } ], "title": "Body", "description": "Filters. CompanySearchFilters if type is 'companies', JobSearchFilters if type is 'jobs'" }, "type": { "anyOf": [ { "type": "string", "enum": [ "companies", "jobs" ] }, { "type": "null" } ], "title": "Type", "description": "Type of the saved search." }, "is_alert_active": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Alert Active", "description": "Is the alert active" }, "frequency": { "anyOf": [ { "type": "string", "enum": [ "daily", "weekly" ] }, { "type": "null" } ], "title": "Frequency", "description": "Frequency of emails alerts sent." }, "emails_subscribed": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Emails Subscribed", "description": "Emails subscribed to the saved search alerts.", "default": [] } }, "type": "object", "title": "SavedSearchUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "id": { "type": "integer", "title": "Id", "description": "ID of the saved search" }, "name": { "type": "string", "title": "Name", "description": "Name of the saved search" }, "type": { "type": "string", "enum": [ "companies", "jobs" ], "title": "Type", "description": "Type of the saved search." }, "body": { "anyOf": [ { "properties": { "expand_technology_slugs": { "items": { "type": "string" }, "type": "array", "title": "Expand Technology Slugs", "description": "Specify technology slugs to include detailed technology usage information for each company. The response will include a 'technologies_found' field containing metrics like confidence score, ranking, and job count for each specified technology. Note: If a technology is not listed for a company, it means that company does not use that technology. This feature is useful for enriching company data with their technology stack details.", "default": [] }, "order_by": { "items": { "$ref": "#/components/schemas/ColumnSortCompanySearch", "_circular": true }, "type": "array", "title": "Order By", "description": "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", "default": [ { "desc": true, "field": "confidence" }, { "desc": true, "field": "num_jobs_found" }, { "desc": true, "field": "num_jobs" }, { "desc": true, "field": "num_jobs" }, { "desc": true, "field": "employee_count" } ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "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.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_case_insensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Case Insensitive Or", "description": "Only return companies that match these names exactly, case-insensitively.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_id_or": { "items": { "type": "string" }, "type": "array", "title": "Company Id Or", "description": "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.", "default": [], "examples": [ [], [ "1234567890", "1234567891" ] ] }, "company_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Or", "description": "Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.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.", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Not", "description": "Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_name_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Not", "description": "Only return companies that don't match these names exactly, case-sensitively.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Or", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_name_partial_match_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Not", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_linkedin_url_or": { "items": { "type": "string" }, "type": "array", "title": "Company Linkedin Url Or", "description": "Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.", "default": [], "examples": [ [], [ "https://www.linkedin.com/company/google/" ] ] }, "blur_company_data": { "type": "boolean", "title": "Blur Company Data", "description": "Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)", "default": false }, "property_exists_or": { "items": { "type": "string", "enum": [ "domain", "linkedin_url" ] }, "type": "array", "title": "Property Exists Or", "description": "Return companies that have any of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have a domain OR a linkedin_url set.", "default": [], "examples": [ [], [ "domain", "linkedin_url" ] ] }, "property_exists_and": { "items": { "type": "string", "enum": [ "domain", "linkedin_url" ] }, "type": "array", "title": "Property Exists And", "description": "Return companies that have all of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have both domain AND linkedin_url set.", "default": [], "examples": [ [], [ "domain", "linkedin_url" ] ] }, "offset": { "type": "integer", "minimum": 0, "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "page": { "type": "integer", "minimum": 0, "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "title": "Limit", "description": "Number of results per page", "default": 25, "examples": [ 25 ] }, "company_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Or", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Not", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_accent_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Description Pattern Accent Insensitive", "description": "Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.", "default": false, "examples": [ null, true, false ] }, "min_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Revenue Usd", "description": "Minimum company revenue, in USD", "examples": [ null ] }, "max_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Revenue Usd", "description": "Maximum company revenue, in USD", "examples": [ null ] }, "min_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count", "description": "Minimum number of employees in a company", "examples": [ null, 100 ] }, "max_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count", "description": "Maximum number of employees in a company", "examples": [ null, 100 ] }, "min_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count Or Null", "description": "Minimum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "max_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count Or Null", "description": "Maximum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "min_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Funding Usd", "description": "Minimum company funding, in USD", "examples": [ null, 1000000000 ] }, "max_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Funding Usd", "description": "Maximum company funding, in USD", "examples": [ null, 1000000000 ] }, "funding_stage_or": { "items": { "type": "string" }, "type": "array", "title": "Funding Stage Or", "description": "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']", "default": [] }, "industry_or": { "items": { "type": "string" }, "type": "array", "title": "Industry Or", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_or field instead. ", "default": [], "deprecated": true }, "industry_not": { "items": { "type": "string" }, "type": "array", "title": "Industry Not", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_not field instead. ", "default": [], "deprecated": true }, "industry_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Or", "description": "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)", "default": [] }, "industry_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Not", "description": "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)", "default": [] }, "company_tags_or": { "items": { "type": "string" }, "type": "array", "title": "Company Tags Or", "description": "Return companies that match any of these keywords", "default": [] }, "company_type": { "anyOf": [ { "type": "string", "enum": [ "recruiting_agency", "direct_employer", "all" ] }, { "type": "null" } ], "title": "Company Type", "description": "Filter by company type." }, "company_investors_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Or", "description": "Investors of the company", "default": [] }, "company_investors_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Partial Match Or", "description": "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).", "default": [] }, "company_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Or", "description": "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)", "default": [] }, "company_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug And", "description": "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)", "default": [] }, "company_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Not", "description": "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)", "default": [] }, "only_yc_companies": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Yc Companies", "description": "Only return YC companies", "default": false }, "company_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Location Pattern Or", "description": "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.", "default": [] }, "company_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Or", "description": "Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Not", "description": "Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_list_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Or", "description": "Return companies that belong to any of the company lists passed here", "default": [] }, "company_list_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Not", "description": "Return companies that don't belong to any of the company lists passed here", "default": [] }, "company_linkedin_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Linkedin Url Exists", "description": "(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL", "deprecated": true, "examples": [ null ] }, "revealed_company_data": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Revealed Company Data", "description": "This field is deprecated and has no effect.", "deprecated": true, "examples": [ null ] }, "last_funding_round_date_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Lte", "description": "Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "last_funding_round_date_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Gte", "description": "Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "include_total_results": { "type": "boolean", "title": "Include Total Results", "description": "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.", "default": false }, "job_filters": { "anyOf": [ { "$ref": "#/components/schemas/JobFilters", "_circular": true }, { "type": "null" } ] }, "tech_filters": { "anyOf": [ { "$ref": "#/components/schemas/TechnographicsTechnologyFilters", "_circular": true }, { "type": "null" } ] } }, "additionalProperties": false, "type": "object", "title": "CompanySearchFilters" }, { "properties": { "order_by": { "items": { "$ref": "#/components/schemas/ColumnSortJobSearch", "_circular": true }, "type": "array", "title": "Order By", "description": "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.", "default": [ { "desc": true, "field": "date_posted" }, { "desc": true, "field": "discovered_at" } ], "deprecated": true }, "offset": { "type": "integer", "minimum": 0, "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "page": { "type": "integer", "minimum": 0, "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "title": "Limit", "description": "Number of results per page", "default": 25, "examples": [ 25 ] }, "job_title_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Or", "description": "Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Not", "description": "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.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_pattern_and": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern And", "description": "Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Or", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Not", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Or", "description": "2-letter ISO country code of the location of the job. Can pass more than 1", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "job_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Not", "description": "2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "posted_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Posted At Max Age Days", "description": "Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "posted_at_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Gte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.", "examples": [ null, "2025-05-25" ] }, "posted_at_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Lte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.", "examples": [ null, "2025-05-25" ] }, "discovered_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Max Age Days", "description": "If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_min_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Min Age Days", "description": "If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_gte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Gte", "description": "Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "discovered_at_lte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Lte", "description": "Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "job_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Or", "description": "Regex patterns to look for in job descriptions. Case-insensitive. Results will include jobs whose description matches any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Not", "description": "Regex patterns to look for in job descriptions. Results will include jobs whose description don't match any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_is_case_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Job Description Pattern Is Case Insensitive", "description": "Whether to make searches on job descriptions case-sensitive or insensitive. Deprecated field and won't work, use job_description_pattern_case_sensitive_or instead.", "default": true, "deprecated": true, "examples": [ null, true, false ] }, "job_description_contains_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Or", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_contains_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Not", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_pattern_case_sensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Case Sensitive Or", "description": "Regex patterns to look for in job descriptions. Case-sensitive. If patterns are uppercase, they will be searched case-sensitively. Results will include jobs whose description matches any of these patterns.", "default": [], "examples": [ [], [ "Python", "JavaScript" ], [ "API", "REST" ] ] }, "remote": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remote", "description": "True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.", "examples": [ null, true, false ] }, "only_jobs_with_reports_to": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Reports To", "description": "Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.", "deprecated": true, "examples": [ null, true, false ] }, "reports_to_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Reports To Exists", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "final_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Final Url Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "only_jobs_with_hiring_managers": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Hiring Managers", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "hiring_managers_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hiring Managers Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "job_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Or", "description": "Get jobs with these IDs only.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Not", "description": "Exclude jobs with these IDs.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_ids": { "items": { "type": "integer" }, "type": "array", "title": "Job Ids", "description": "Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.", "default": [], "deprecated": true }, "job_seniority_or": { "items": { "type": "string", "enum": [ "c_level", "staff", "senior", "junior", "mid_level" ] }, "type": "array", "title": "Job Seniority Or", "description": "Will return jobs where the seniority is any of the ones passed here", "default": [], "examples": [ [], [ "intern", "entry", "mid", "senior", "principal" ] ] }, "min_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Salary Usd", "description": "Minimum annual salary in USD. For example, 100000 means $100,000.", "examples": [ null, 100000, 150000 ] }, "max_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Salary Usd", "description": "Maximum annual salary in USD. For example, 150000 means $150,000.", "examples": [ null, 100000, 150000 ] }, "job_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Or", "description": "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.", "default": [] }, "job_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Not", "description": "Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug And", "description": "Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Or", "description": "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. Use this to find jobs in specific cities, states, or regions.", "default": [], "examples": [ [], [ "san francisco" ], [ "california", "new york" ], [ "madrid" ] ] }, "job_location_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Not", "description": "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.", "default": [], "examples": [ [], [ "new york", "california" ], [ "madrid" ] ] }, "job_location_or": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Or", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "job_location_not": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Not", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "url_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Or", "description": "Include jobs only if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "url_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Not", "description": "Exclude jobs if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "scraper_name_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Scraper Name Pattern Or", "description": "Regex patterns to match job sources. Case-insensitive.", "default": [], "deprecated": true }, "easy_apply": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Easy Apply", "description": "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.", "examples": [ null, true, false ] }, "employment_statuses_or": { "anyOf": [ { "items": { "$ref": "#/components/schemas/Commitment", "_circular": true }, "type": "array" }, { "type": "null" } ], "title": "Employment Statuses Or", "description": "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.", "examples": [ [], [ "full_time" ], [ "full_time", "part_time" ] ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "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.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_case_insensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Case Insensitive Or", "description": "Only return companies that match these names exactly, case-insensitively.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_id_or": { "items": { "type": "string" }, "type": "array", "title": "Company Id Or", "description": "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.", "default": [], "examples": [ [], [ "1234567890", "1234567891" ] ] }, "company_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Or", "description": "Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.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.", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Not", "description": "Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_name_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Not", "description": "Only return companies that don't match these names exactly, case-sensitively.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Or", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_name_partial_match_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Not", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_linkedin_url_or": { "items": { "type": "string" }, "type": "array", "title": "Company Linkedin Url Or", "description": "Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.", "default": [], "examples": [ [], [ "https://www.linkedin.com/company/google/" ] ] }, "blur_company_data": { "type": "boolean", "title": "Blur Company Data", "description": "Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)", "default": false }, "property_exists_or": { "items": { "type": "string", "enum": [ "company_object.domain", "company_object.linkedin_url", "final_url", "hiring_team", "employment_statuses" ] }, "type": "array", "title": "Property Exists Or", "description": "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.", "default": [], "examples": [ [], [ "company_object.domain", "company_object.linkedin_url", "final_url" ] ] }, "property_exists_and": { "items": { "type": "string", "enum": [ "company_object.domain", "company_object.linkedin_url", "final_url", "hiring_team", "employment_statuses" ] }, "type": "array", "title": "Property Exists And", "default": [], "examples": [ [], [ "company_object.domain", "company_object.linkedin_url", "final_url" ] ] }, "company_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Or", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Not", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_accent_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Description Pattern Accent Insensitive", "description": "Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.", "default": false, "examples": [ null, true, false ] }, "min_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Revenue Usd", "description": "Minimum company revenue, in USD", "examples": [ null ] }, "max_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Revenue Usd", "description": "Maximum company revenue, in USD", "examples": [ null ] }, "min_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count", "description": "Minimum number of employees in a company", "examples": [ null, 100 ] }, "max_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count", "description": "Maximum number of employees in a company", "examples": [ null, 100 ] }, "min_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count Or Null", "description": "Minimum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "max_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count Or Null", "description": "Maximum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "min_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Funding Usd", "description": "Minimum company funding, in USD", "examples": [ null, 1000000000 ] }, "max_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Funding Usd", "description": "Maximum company funding, in USD", "examples": [ null, 1000000000 ] }, "funding_stage_or": { "items": { "type": "string" }, "type": "array", "title": "Funding Stage Or", "description": "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']", "default": [] }, "industry_or": { "items": { "type": "string" }, "type": "array", "title": "Industry Or", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_or field instead. ", "default": [], "deprecated": true }, "industry_not": { "items": { "type": "string" }, "type": "array", "title": "Industry Not", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_not field instead. ", "default": [], "deprecated": true }, "industry_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Or", "description": "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)", "default": [] }, "industry_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Not", "description": "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)", "default": [] }, "company_tags_or": { "items": { "type": "string" }, "type": "array", "title": "Company Tags Or", "description": "Return companies that match any of these keywords", "default": [] }, "company_type": { "anyOf": [ { "type": "string", "enum": [ "recruiting_agency", "direct_employer", "all" ] }, { "type": "null" } ], "title": "Company Type", "description": "Filter by company type." }, "company_investors_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Or", "description": "Investors of the company", "default": [] }, "company_investors_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Partial Match Or", "description": "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).", "default": [] }, "company_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Or", "description": "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)", "default": [] }, "company_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug And", "description": "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)", "default": [] }, "company_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Not", "description": "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)", "default": [] }, "only_yc_companies": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Yc Companies", "description": "Only return YC companies", "default": false }, "company_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Location Pattern Or", "description": "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.", "default": [] }, "company_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Or", "description": "Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Not", "description": "Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_list_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Or", "description": "Return companies that belong to any of the company lists passed here", "default": [] }, "company_list_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Not", "description": "Return companies that don't belong to any of the company lists passed here", "default": [] }, "company_linkedin_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Linkedin Url Exists", "description": "(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL", "deprecated": true, "examples": [ null ] }, "revealed_company_data": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Revealed Company Data", "description": "This field is deprecated and has no effect.", "deprecated": true, "examples": [ null ] }, "last_funding_round_date_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Lte", "description": "Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "last_funding_round_date_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Gte", "description": "Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "include_total_results": { "type": "boolean", "title": "Include Total Results", "description": "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.", "default": false } }, "additionalProperties": false, "type": "object", "title": "JobSearchFilters" } ], "title": "Body", "description": "Filters. CompanySearchFilters if type is 'companies', JobSearchFilters if type is 'jobs'" }, "is_alert_active": { "type": "boolean", "title": "Is Alert Active", "description": "Is the alert active", "default": false }, "user_id": { "type": "integer", "title": "User Id", "description": "Owner of the saved search" }, "team_id": { "type": "integer", "title": "Team Id", "description": "Team of the saved search" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At", "description": "Date and time when the saved search was created" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At", "description": "Date and time when the saved search was last updated" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Query", "description": "Query of the request" }, "path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Path", "description": "Path of the request" }, "querystring_params": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Querystring Params", "description": "Dictionary containing the querystring parameters of the request." }, "creator": { "properties": { "id": { "type": "integer", "title": "Id" }, "email": { "type": "string", "title": "Email", "description": "The user's email address" }, "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "First Name", "description": "The user's first name" }, "last_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Name", "description": "The user's last name" } }, "type": "object", "required": [ "id", "email" ], "title": "UserSimple" }, "is_archived": { "type": "boolean", "title": "Is Archived", "description": "Is the saved search archived", "default": false }, "has_active_webhooks": { "type": "boolean", "title": "Has Active Webhooks", "description": "Has active webhooks", "default": false }, "frequency": { "anyOf": [ { "type": "string", "enum": [ "daily", "weekly" ] }, { "type": "null" } ], "title": "Frequency", "description": "Frequency of emails alerts sent." }, "emails_subscribed": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Emails Subscribed", "description": "Emails subscribed to the saved search alerts.", "default": [] } }, "type": "object", "required": [ "id", "name", "type", "body", "user_id", "team_id", "created_at", "updated_at", "creator" ], "title": "SavedSearch" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Create Saved Search description: undefined url: https://theirstack.com/en/docs/api-reference/saved-searches/post_saved_searches_v0 --- ## OpenAPI Specification ```json { "path": "/v0/saved_searches", "method": "POST", "tags": [ "Saved Searches" ], "summary": "Create Saved Search", "operationId": "post_saved_searches_v0", "security": [ { "Bearer": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name", "description": "Name of the saved search" }, "body": { "anyOf": [ { "properties": { "expand_technology_slugs": { "items": { "type": "string" }, "type": "array", "title": "Expand Technology Slugs", "description": "Specify technology slugs to include detailed technology usage information for each company. The response will include a 'technologies_found' field containing metrics like confidence score, ranking, and job count for each specified technology. Note: If a technology is not listed for a company, it means that company does not use that technology. This feature is useful for enriching company data with their technology stack details.", "default": [] }, "order_by": { "items": { "properties": { "desc": { "type": "boolean", "title": "Desc", "description": "Whether to order by descending or ascending values", "default": true }, "field": { "type": "string", "enum": [ "name", "num_jobs", "num_jobs_last_30_days", "num_jobs_found", "employee_count", "alexa_ranking", "founded_year", "annual_revenue_usd", "total_funding_usd", "last_funding_round_date", "confidence", "jobs", "first_date_found" ], "title": "Field", "description": "Order the results by some of these fields" } }, "additionalProperties": false, "type": "object", "required": [ "field" ], "title": "ColumnSortCompanySearch" }, "type": "array", "title": "Order By", "description": "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", "default": [ { "desc": true, "field": "confidence" }, { "desc": true, "field": "num_jobs_found" }, { "desc": true, "field": "num_jobs" }, { "desc": true, "field": "num_jobs" }, { "desc": true, "field": "employee_count" } ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "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.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_case_insensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Case Insensitive Or", "description": "Only return companies that match these names exactly, case-insensitively.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_id_or": { "items": { "type": "string" }, "type": "array", "title": "Company Id Or", "description": "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.", "default": [], "examples": [ [], [ "1234567890", "1234567891" ] ] }, "company_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Or", "description": "Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.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.", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Not", "description": "Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_name_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Not", "description": "Only return companies that don't match these names exactly, case-sensitively.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Or", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_name_partial_match_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Not", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_linkedin_url_or": { "items": { "type": "string" }, "type": "array", "title": "Company Linkedin Url Or", "description": "Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.", "default": [], "examples": [ [], [ "https://www.linkedin.com/company/google/" ] ] }, "blur_company_data": { "type": "boolean", "title": "Blur Company Data", "description": "Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)", "default": false }, "property_exists_or": { "items": { "type": "string", "enum": [ "domain", "linkedin_url" ] }, "type": "array", "title": "Property Exists Or", "description": "Return companies that have any of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have a domain OR a linkedin_url set.", "default": [], "examples": [ [], [ "domain", "linkedin_url" ] ] }, "property_exists_and": { "items": { "type": "string", "enum": [ "domain", "linkedin_url" ] }, "type": "array", "title": "Property Exists And", "description": "Return companies that have all of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have both domain AND linkedin_url set.", "default": [], "examples": [ [], [ "domain", "linkedin_url" ] ] }, "offset": { "type": "integer", "minimum": 0, "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "page": { "type": "integer", "minimum": 0, "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "title": "Limit", "description": "Number of results per page", "default": 25, "examples": [ 25 ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cursor", "description": "Cursor for pagination" }, "company_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Or", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Not", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_accent_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Description Pattern Accent Insensitive", "description": "Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.", "default": false, "examples": [ null, true, false ] }, "min_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Revenue Usd", "description": "Minimum company revenue, in USD", "examples": [ null ] }, "max_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Revenue Usd", "description": "Maximum company revenue, in USD", "examples": [ null ] }, "min_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count", "description": "Minimum number of employees in a company", "examples": [ null, 100 ] }, "max_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count", "description": "Maximum number of employees in a company", "examples": [ null, 100 ] }, "min_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count Or Null", "description": "Minimum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "max_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count Or Null", "description": "Maximum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "min_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Funding Usd", "description": "Minimum company funding, in USD", "examples": [ null, 1000000000 ] }, "max_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Funding Usd", "description": "Maximum company funding, in USD", "examples": [ null, 1000000000 ] }, "funding_stage_or": { "items": { "type": "string" }, "type": "array", "title": "Funding Stage Or", "description": "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']", "default": [] }, "industry_or": { "items": { "type": "string" }, "type": "array", "title": "Industry Or", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_or field instead. ", "default": [], "deprecated": true }, "industry_not": { "items": { "type": "string" }, "type": "array", "title": "Industry Not", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_not field instead. ", "default": [], "deprecated": true }, "industry_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Or", "description": "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)", "default": [] }, "industry_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Not", "description": "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)", "default": [] }, "company_tags_or": { "items": { "type": "string" }, "type": "array", "title": "Company Tags Or", "description": "Return companies that match any of these keywords", "default": [] }, "company_type": { "anyOf": [ { "type": "string", "enum": [ "recruiting_agency", "direct_employer", "all" ] }, { "type": "null" } ], "title": "Company Type", "description": "Filter by company type." }, "company_investors_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Or", "description": "Investors of the company", "default": [] }, "company_investors_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Partial Match Or", "description": "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).", "default": [] }, "company_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Or", "description": "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)", "default": [] }, "company_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug And", "description": "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)", "default": [] }, "company_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Not", "description": "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)", "default": [] }, "only_yc_companies": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Yc Companies", "description": "Only return YC companies", "default": false }, "company_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Location Pattern Or", "description": "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.", "default": [] }, "company_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Or", "description": "Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Not", "description": "Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_list_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Or", "description": "Return companies that belong to any of the company lists passed here", "default": [] }, "company_list_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Not", "description": "Return companies that don't belong to any of the company lists passed here", "default": [] }, "company_linkedin_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Linkedin Url Exists", "description": "(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL", "deprecated": true, "examples": [ null ] }, "revealed_company_data": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Revealed Company Data", "description": "This field is deprecated and has no effect.", "deprecated": true, "examples": [ null ] }, "last_funding_round_date_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Lte", "description": "Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "last_funding_round_date_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Gte", "description": "Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "include_total_results": { "type": "boolean", "title": "Include Total Results", "description": "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.", "default": false }, "job_filters": { "anyOf": [ { "properties": { "job_title_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Or", "description": "Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Not", "description": "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.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_pattern_and": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern And", "description": "Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Or", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Not", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Or", "description": "2-letter ISO country code of the location of the job. Can pass more than 1", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "job_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Not", "description": "2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "posted_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Posted At Max Age Days", "description": "Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "posted_at_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Gte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.", "examples": [ null, "2025-05-25" ] }, "posted_at_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Lte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.", "examples": [ null, "2025-05-25" ] }, "discovered_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Max Age Days", "description": "If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_min_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Min Age Days", "description": "If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_gte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Gte", "description": "Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "discovered_at_lte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Lte", "description": "Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "job_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Or", "description": "Regex patterns to look for in job descriptions. Case-insensitive. Results will include jobs whose description matches any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Not", "description": "Regex patterns to look for in job descriptions. Results will include jobs whose description don't match any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_is_case_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Job Description Pattern Is Case Insensitive", "description": "Whether to make searches on job descriptions case-sensitive or insensitive. Deprecated field and won't work, use job_description_pattern_case_sensitive_or instead.", "default": true, "deprecated": true, "examples": [ null, true, false ] }, "job_description_contains_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Or", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_contains_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Not", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_pattern_case_sensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Case Sensitive Or", "description": "Regex patterns to look for in job descriptions. Case-sensitive. If patterns are uppercase, they will be searched case-sensitively. Results will include jobs whose description matches any of these patterns.", "default": [], "examples": [ [], [ "Python", "JavaScript" ], [ "API", "REST" ] ] }, "remote": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remote", "description": "True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.", "examples": [ null, true, false ] }, "only_jobs_with_reports_to": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Reports To", "description": "Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.", "deprecated": true, "examples": [ null, true, false ] }, "reports_to_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Reports To Exists", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "final_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Final Url Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "only_jobs_with_hiring_managers": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Hiring Managers", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "hiring_managers_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hiring Managers Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "job_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Or", "description": "Get jobs with these IDs only.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Not", "description": "Exclude jobs with these IDs.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_ids": { "items": { "type": "integer" }, "type": "array", "title": "Job Ids", "description": "Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.", "default": [], "deprecated": true }, "job_seniority_or": { "items": { "type": "string", "enum": [ "c_level", "staff", "senior", "junior", "mid_level" ] }, "type": "array", "title": "Job Seniority Or", "description": "Will return jobs where the seniority is any of the ones passed here", "default": [], "examples": [ [], [ "intern", "entry", "mid", "senior", "principal" ] ] }, "min_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Salary Usd", "description": "Minimum annual salary in USD. For example, 100000 means $100,000.", "examples": [ null, 100000, 150000 ] }, "max_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Salary Usd", "description": "Maximum annual salary in USD. For example, 150000 means $150,000.", "examples": [ null, 100000, 150000 ] }, "job_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Or", "description": "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.", "default": [] }, "job_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Not", "description": "Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug And", "description": "Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Or", "description": "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. Use this to find jobs in specific cities, states, or regions.", "default": [], "examples": [ [], [ "san francisco" ], [ "california", "new york" ], [ "madrid" ] ] }, "job_location_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Not", "description": "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.", "default": [], "examples": [ [], [ "new york", "california" ], [ "madrid" ] ] }, "job_location_or": { "items": { "properties": { "id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Id", "description": "Filter by location id. You can discover all the locations from the locations catalog endpoint [GET /v0/catalog/locations](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_locations_v0)", "examples": [ 3117735 ] } }, "type": "object", "title": "JobLocationFilter" }, "type": "array", "title": "Job Location Or", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "job_location_not": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Not", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "url_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Or", "description": "Include jobs only if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "url_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Not", "description": "Exclude jobs if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "scraper_name_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Scraper Name Pattern Or", "description": "Regex patterns to match job sources. Case-insensitive.", "default": [], "deprecated": true }, "easy_apply": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Easy Apply", "description": "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.", "examples": [ null, true, false ] }, "employment_statuses_or": { "anyOf": [ { "items": { "type": "string", "enum": [ "full_time", "part_time", "temporary", "internship", "contract", "freelance", "co_founder", "apprenticeship", "seasonal", "volunteer", "other" ], "title": "Commitment" }, "type": "array" }, { "type": "null" } ], "title": "Employment Statuses Or", "description": "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.", "examples": [ [], [ "full_time" ], [ "full_time", "part_time" ] ] } }, "additionalProperties": false, "type": "object", "title": "JobFilters" }, { "type": "null" } ] }, "tech_filters": { "anyOf": [ { "properties": { "technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Slug Or", "description": "Will return jobs from companies that that have 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)", "default": [] }, "technology_category_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Category Slug Or", "description": "Will return jobs from companies that that have mentioned any technology from any of these categories in their jobs Case sensitive. Pass slugs. Check out all the technology categories we track at [GET /v0/catalog/technologies/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_categories_v0)", "default": [] }, "technology_parent_category_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Technology Parent Category Slug Or", "description": "Will return jobs from companies that that have mentioned any technology from any of these parent categories in their jobs Case sensitive. Pass slugs. Check out all the technology parent categories we track at [GET /v0/catalog/technologies/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_technologies_categories_v0)", "default": [] }, "max_rank": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Rank", "description": "The rank measures how common is a technology within its category. The technology most used among similar ones by a company will have a rank of 1, the second: 2, etc. This is useful to filter results by technology and get only results for the primary technology. ", "examples": [ null ] }, "min_jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Jobs", "description": "Minimum number of jobs found by each company using a technology", "examples": [ null ] }, "max_jobs": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Jobs", "description": "Maximum number of jobs found by each company using a technology", "examples": [ null ] }, "min_relative_occurrence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Relative Occurrence", "description": "Minimum value of relative_occurrence_within_category for each technology. Higher values increase the probability that this technology is actually used by the company, because it means a higher percentage of mentions to technologies among this category are of this technology.", "examples": [ null ] }, "first_date_found_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "First Date Found Gte", "description": "Only return technologies where the first time they were found was after or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "first_date_found_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "First Date Found Lte", "description": "Only return technologies where the first time they were found was before or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "last_date_found_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Date Found Gte", "description": "Only return technologies where the last time they were found was after or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "last_date_found_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Date Found Lte", "description": "Only return technologies where the last time they were found was before or on this date. Format: \"YYYY-MM-DD\"", "examples": [ null ] }, "confidence_or": { "items": { "type": "string", "enum": [ "low", "medium", "high" ] }, "type": "array", "title": "Confidence Or", "description": "Returns technologies with any of these confidence values that the companies use them. Available values: \"high\", \"medium\", \"low\"", "default": [] } }, "type": "object", "title": "TechnographicsTechnologyFilters" }, { "type": "null" } ] } }, "additionalProperties": false, "type": "object", "title": "CompanySearchFilters" }, { "properties": { "order_by": { "items": { "properties": { "desc": { "type": "boolean", "title": "Desc", "description": "Whether to order by descending or ascending values", "default": true }, "field": { "type": "string", "enum": [ "date_posted", "discovered_at", "salary", "job_title", "company", "num_jobs" ], "title": "Field", "description": "Field to order by", "default": "date_posted" } }, "additionalProperties": false, "type": "object", "title": "ColumnSortJobSearch" }, "type": "array", "title": "Order By", "description": "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.", "default": [ { "desc": true, "field": "date_posted" }, { "desc": true, "field": "discovered_at" } ], "deprecated": true }, "offset": { "type": "integer", "minimum": 0, "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "page": { "type": "integer", "minimum": 0, "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "title": "Limit", "description": "Number of results per page", "default": 25, "examples": [ 25 ] }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cursor", "description": "Cursor for pagination" }, "job_title_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Or", "description": "Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Not", "description": "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.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_pattern_and": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern And", "description": "Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Or", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Not", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Or", "description": "2-letter ISO country code of the location of the job. Can pass more than 1", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "job_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Not", "description": "2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "posted_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Posted At Max Age Days", "description": "Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "posted_at_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Gte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.", "examples": [ null, "2025-05-25" ] }, "posted_at_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Lte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.", "examples": [ null, "2025-05-25" ] }, "discovered_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Max Age Days", "description": "If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_min_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Min Age Days", "description": "If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_gte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Gte", "description": "Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "discovered_at_lte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Lte", "description": "Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "job_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Or", "description": "Regex patterns to look for in job descriptions. Case-insensitive. Results will include jobs whose description matches any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Not", "description": "Regex patterns to look for in job descriptions. Results will include jobs whose description don't match any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_is_case_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Job Description Pattern Is Case Insensitive", "description": "Whether to make searches on job descriptions case-sensitive or insensitive. Deprecated field and won't work, use job_description_pattern_case_sensitive_or instead.", "default": true, "deprecated": true, "examples": [ null, true, false ] }, "job_description_contains_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Or", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_contains_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Not", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_pattern_case_sensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Case Sensitive Or", "description": "Regex patterns to look for in job descriptions. Case-sensitive. If patterns are uppercase, they will be searched case-sensitively. Results will include jobs whose description matches any of these patterns.", "default": [], "examples": [ [], [ "Python", "JavaScript" ], [ "API", "REST" ] ] }, "remote": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remote", "description": "True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.", "examples": [ null, true, false ] }, "only_jobs_with_reports_to": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Reports To", "description": "Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.", "deprecated": true, "examples": [ null, true, false ] }, "reports_to_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Reports To Exists", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "final_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Final Url Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "only_jobs_with_hiring_managers": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Hiring Managers", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "hiring_managers_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hiring Managers Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "job_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Or", "description": "Get jobs with these IDs only.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Not", "description": "Exclude jobs with these IDs.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_ids": { "items": { "type": "integer" }, "type": "array", "title": "Job Ids", "description": "Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.", "default": [], "deprecated": true }, "job_seniority_or": { "items": { "type": "string", "enum": [ "c_level", "staff", "senior", "junior", "mid_level" ] }, "type": "array", "title": "Job Seniority Or", "description": "Will return jobs where the seniority is any of the ones passed here", "default": [], "examples": [ [], [ "intern", "entry", "mid", "senior", "principal" ] ] }, "min_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Salary Usd", "description": "Minimum annual salary in USD. For example, 100000 means $100,000.", "examples": [ null, 100000, 150000 ] }, "max_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Salary Usd", "description": "Maximum annual salary in USD. For example, 150000 means $150,000.", "examples": [ null, 100000, 150000 ] }, "job_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Or", "description": "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.", "default": [] }, "job_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Not", "description": "Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug And", "description": "Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Or", "description": "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. Use this to find jobs in specific cities, states, or regions.", "default": [], "examples": [ [], [ "san francisco" ], [ "california", "new york" ], [ "madrid" ] ] }, "job_location_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Not", "description": "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.", "default": [], "examples": [ [], [ "new york", "california" ], [ "madrid" ] ] }, "job_location_or": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Or", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "job_location_not": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Not", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "url_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Or", "description": "Include jobs only if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "url_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Not", "description": "Exclude jobs if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "scraper_name_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Scraper Name Pattern Or", "description": "Regex patterns to match job sources. Case-insensitive.", "default": [], "deprecated": true }, "easy_apply": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Easy Apply", "description": "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.", "examples": [ null, true, false ] }, "employment_statuses_or": { "anyOf": [ { "items": { "$ref": "#/components/schemas/Commitment", "_circular": true }, "type": "array" }, { "type": "null" } ], "title": "Employment Statuses Or", "description": "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.", "examples": [ [], [ "full_time" ], [ "full_time", "part_time" ] ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "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.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_case_insensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Case Insensitive Or", "description": "Only return companies that match these names exactly, case-insensitively.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_id_or": { "items": { "type": "string" }, "type": "array", "title": "Company Id Or", "description": "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.", "default": [], "examples": [ [], [ "1234567890", "1234567891" ] ] }, "company_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Or", "description": "Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.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.", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Not", "description": "Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_name_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Not", "description": "Only return companies that don't match these names exactly, case-sensitively.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Or", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_name_partial_match_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Not", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_linkedin_url_or": { "items": { "type": "string" }, "type": "array", "title": "Company Linkedin Url Or", "description": "Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.", "default": [], "examples": [ [], [ "https://www.linkedin.com/company/google/" ] ] }, "blur_company_data": { "type": "boolean", "title": "Blur Company Data", "description": "Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)", "default": false }, "property_exists_or": { "items": { "type": "string", "enum": [ "company_object.domain", "company_object.linkedin_url", "final_url", "hiring_team", "employment_statuses" ] }, "type": "array", "title": "Property Exists Or", "description": "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.", "default": [], "examples": [ [], [ "company_object.domain", "company_object.linkedin_url", "final_url" ] ] }, "property_exists_and": { "items": { "type": "string", "enum": [ "company_object.domain", "company_object.linkedin_url", "final_url", "hiring_team", "employment_statuses" ] }, "type": "array", "title": "Property Exists And", "default": [], "examples": [ [], [ "company_object.domain", "company_object.linkedin_url", "final_url" ] ] }, "company_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Or", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Not", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_accent_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Description Pattern Accent Insensitive", "description": "Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.", "default": false, "examples": [ null, true, false ] }, "min_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Revenue Usd", "description": "Minimum company revenue, in USD", "examples": [ null ] }, "max_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Revenue Usd", "description": "Maximum company revenue, in USD", "examples": [ null ] }, "min_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count", "description": "Minimum number of employees in a company", "examples": [ null, 100 ] }, "max_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count", "description": "Maximum number of employees in a company", "examples": [ null, 100 ] }, "min_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count Or Null", "description": "Minimum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "max_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count Or Null", "description": "Maximum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "min_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Funding Usd", "description": "Minimum company funding, in USD", "examples": [ null, 1000000000 ] }, "max_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Funding Usd", "description": "Maximum company funding, in USD", "examples": [ null, 1000000000 ] }, "funding_stage_or": { "items": { "type": "string" }, "type": "array", "title": "Funding Stage Or", "description": "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']", "default": [] }, "industry_or": { "items": { "type": "string" }, "type": "array", "title": "Industry Or", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_or field instead. ", "default": [], "deprecated": true }, "industry_not": { "items": { "type": "string" }, "type": "array", "title": "Industry Not", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_not field instead. ", "default": [], "deprecated": true }, "industry_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Or", "description": "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)", "default": [] }, "industry_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Not", "description": "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)", "default": [] }, "company_tags_or": { "items": { "type": "string" }, "type": "array", "title": "Company Tags Or", "description": "Return companies that match any of these keywords", "default": [] }, "company_type": { "anyOf": [ { "type": "string", "enum": [ "recruiting_agency", "direct_employer", "all" ] }, { "type": "null" } ], "title": "Company Type", "description": "Filter by company type." }, "company_investors_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Or", "description": "Investors of the company", "default": [] }, "company_investors_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Partial Match Or", "description": "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).", "default": [] }, "company_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Or", "description": "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)", "default": [] }, "company_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug And", "description": "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)", "default": [] }, "company_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Not", "description": "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)", "default": [] }, "only_yc_companies": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Yc Companies", "description": "Only return YC companies", "default": false }, "company_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Location Pattern Or", "description": "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.", "default": [] }, "company_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Or", "description": "Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Not", "description": "Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_list_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Or", "description": "Return companies that belong to any of the company lists passed here", "default": [] }, "company_list_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Not", "description": "Return companies that don't belong to any of the company lists passed here", "default": [] }, "company_linkedin_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Linkedin Url Exists", "description": "(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL", "deprecated": true, "examples": [ null ] }, "revealed_company_data": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Revealed Company Data", "description": "This field is deprecated and has no effect.", "deprecated": true, "examples": [ null ] }, "last_funding_round_date_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Lte", "description": "Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "last_funding_round_date_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Gte", "description": "Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "include_total_results": { "type": "boolean", "title": "Include Total Results", "description": "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.", "default": false } }, "additionalProperties": false, "type": "object", "title": "JobSearchFilters" } ], "title": "Body", "description": "Filters. CompanySearchFilters if type is 'companies', JobSearchFilters if type is 'jobs'" }, "type": { "type": "string", "enum": [ "companies", "jobs" ], "title": "Type", "description": "Type of the saved search." }, "is_alert_active": { "type": "boolean", "title": "Is Alert Active", "description": "Is the alert active", "default": false } }, "additionalProperties": true, "type": "object", "required": [ "body", "type" ], "title": "SavedSearchCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "id": { "type": "integer", "title": "Id", "description": "ID of the saved search" }, "name": { "type": "string", "title": "Name", "description": "Name of the saved search" }, "type": { "type": "string", "enum": [ "companies", "jobs" ], "title": "Type", "description": "Type of the saved search." }, "body": { "anyOf": [ { "properties": { "expand_technology_slugs": { "items": { "type": "string" }, "type": "array", "title": "Expand Technology Slugs", "description": "Specify technology slugs to include detailed technology usage information for each company. The response will include a 'technologies_found' field containing metrics like confidence score, ranking, and job count for each specified technology. Note: If a technology is not listed for a company, it means that company does not use that technology. This feature is useful for enriching company data with their technology stack details.", "default": [] }, "order_by": { "items": { "$ref": "#/components/schemas/ColumnSortCompanySearch", "_circular": true }, "type": "array", "title": "Order By", "description": "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", "default": [ { "desc": true, "field": "confidence" }, { "desc": true, "field": "num_jobs_found" }, { "desc": true, "field": "num_jobs" }, { "desc": true, "field": "num_jobs" }, { "desc": true, "field": "employee_count" } ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "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.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_case_insensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Case Insensitive Or", "description": "Only return companies that match these names exactly, case-insensitively.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_id_or": { "items": { "type": "string" }, "type": "array", "title": "Company Id Or", "description": "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.", "default": [], "examples": [ [], [ "1234567890", "1234567891" ] ] }, "company_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Or", "description": "Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.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.", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Not", "description": "Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_name_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Not", "description": "Only return companies that don't match these names exactly, case-sensitively.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Or", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_name_partial_match_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Not", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_linkedin_url_or": { "items": { "type": "string" }, "type": "array", "title": "Company Linkedin Url Or", "description": "Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.", "default": [], "examples": [ [], [ "https://www.linkedin.com/company/google/" ] ] }, "blur_company_data": { "type": "boolean", "title": "Blur Company Data", "description": "Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)", "default": false }, "property_exists_or": { "items": { "type": "string", "enum": [ "domain", "linkedin_url" ] }, "type": "array", "title": "Property Exists Or", "description": "Return companies that have any of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have a domain OR a linkedin_url set.", "default": [], "examples": [ [], [ "domain", "linkedin_url" ] ] }, "property_exists_and": { "items": { "type": "string", "enum": [ "domain", "linkedin_url" ] }, "type": "array", "title": "Property Exists And", "description": "Return companies that have all of these fields not null. For example, if you pass ['domain', 'linkedin_url'], it will return companies that have both domain AND linkedin_url set.", "default": [], "examples": [ [], [ "domain", "linkedin_url" ] ] }, "offset": { "type": "integer", "minimum": 0, "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "page": { "type": "integer", "minimum": 0, "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "title": "Limit", "description": "Number of results per page", "default": 25, "examples": [ 25 ] }, "company_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Or", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Not", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_accent_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Description Pattern Accent Insensitive", "description": "Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.", "default": false, "examples": [ null, true, false ] }, "min_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Revenue Usd", "description": "Minimum company revenue, in USD", "examples": [ null ] }, "max_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Revenue Usd", "description": "Maximum company revenue, in USD", "examples": [ null ] }, "min_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count", "description": "Minimum number of employees in a company", "examples": [ null, 100 ] }, "max_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count", "description": "Maximum number of employees in a company", "examples": [ null, 100 ] }, "min_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count Or Null", "description": "Minimum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "max_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count Or Null", "description": "Maximum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "min_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Funding Usd", "description": "Minimum company funding, in USD", "examples": [ null, 1000000000 ] }, "max_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Funding Usd", "description": "Maximum company funding, in USD", "examples": [ null, 1000000000 ] }, "funding_stage_or": { "items": { "type": "string" }, "type": "array", "title": "Funding Stage Or", "description": "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']", "default": [] }, "industry_or": { "items": { "type": "string" }, "type": "array", "title": "Industry Or", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_or field instead. ", "default": [], "deprecated": true }, "industry_not": { "items": { "type": "string" }, "type": "array", "title": "Industry Not", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_not field instead. ", "default": [], "deprecated": true }, "industry_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Or", "description": "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)", "default": [] }, "industry_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Not", "description": "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)", "default": [] }, "company_tags_or": { "items": { "type": "string" }, "type": "array", "title": "Company Tags Or", "description": "Return companies that match any of these keywords", "default": [] }, "company_type": { "anyOf": [ { "type": "string", "enum": [ "recruiting_agency", "direct_employer", "all" ] }, { "type": "null" } ], "title": "Company Type", "description": "Filter by company type." }, "company_investors_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Or", "description": "Investors of the company", "default": [] }, "company_investors_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Partial Match Or", "description": "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).", "default": [] }, "company_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Or", "description": "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)", "default": [] }, "company_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug And", "description": "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)", "default": [] }, "company_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Not", "description": "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)", "default": [] }, "only_yc_companies": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Yc Companies", "description": "Only return YC companies", "default": false }, "company_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Location Pattern Or", "description": "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.", "default": [] }, "company_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Or", "description": "Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Not", "description": "Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_list_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Or", "description": "Return companies that belong to any of the company lists passed here", "default": [] }, "company_list_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Not", "description": "Return companies that don't belong to any of the company lists passed here", "default": [] }, "company_linkedin_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Linkedin Url Exists", "description": "(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL", "deprecated": true, "examples": [ null ] }, "revealed_company_data": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Revealed Company Data", "description": "This field is deprecated and has no effect.", "deprecated": true, "examples": [ null ] }, "last_funding_round_date_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Lte", "description": "Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "last_funding_round_date_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Gte", "description": "Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "include_total_results": { "type": "boolean", "title": "Include Total Results", "description": "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.", "default": false }, "job_filters": { "anyOf": [ { "$ref": "#/components/schemas/JobFilters", "_circular": true }, { "type": "null" } ] }, "tech_filters": { "anyOf": [ { "$ref": "#/components/schemas/TechnographicsTechnologyFilters", "_circular": true }, { "type": "null" } ] } }, "additionalProperties": false, "type": "object", "title": "CompanySearchFilters" }, { "properties": { "order_by": { "items": { "$ref": "#/components/schemas/ColumnSortJobSearch", "_circular": true }, "type": "array", "title": "Order By", "description": "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.", "default": [ { "desc": true, "field": "date_posted" }, { "desc": true, "field": "discovered_at" } ], "deprecated": true }, "offset": { "type": "integer", "minimum": 0, "title": "Offset", "description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "page": { "type": "integer", "minimum": 0, "title": "Page", "description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).", "default": 0, "examples": [ 0 ] }, "limit": { "type": "integer", "minimum": 1, "title": "Limit", "description": "Number of results per page", "default": 25, "examples": [ 25 ] }, "job_title_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Or", "description": "Natural language patterns to match job titles. Case-insensitive. Only jobs with title that match any of these patterns will be returned. Uses Postgres full text search.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Not", "description": "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.", "default": [], "examples": [ [], [ "software engineer", "data scientist" ], [ "software engineer", "data scientist", "product manager" ] ] }, "job_title_pattern_and": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern And", "description": "Regex patterns to match job titles. Case-insensitive. Only jobs with title that match all of these patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Or", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title matches of the filters will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_title_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Title Pattern Not", "description": "Regex patterns to match job titles. Case-insensitive. Jobs whose job title doesn't match any of the patterns will be returned.", "default": [], "examples": [ [], [ "\\bsoftware\\s+engineer\\b", "\\bdata\\s+scientist\\b", "\\bproduct\\s+manager\\b" ] ] }, "job_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Or", "description": "2-letter ISO country code of the location of the job. Can pass more than 1", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "job_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Job Country Code Not", "description": "2-letter ISO country code of the location of the job. Can pass more than 1. Will exclude jobs from these countries", "default": [], "examples": [ [], [ "US", "GB" ], [ "US", "GB", "FR" ] ] }, "posted_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Posted At Max Age Days", "description": "Date posted max age in days. If 0, only return jobs posted today. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "posted_at_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Gte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or after will be returned.", "examples": [ null, "2025-05-25" ] }, "posted_at_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Posted At Lte", "description": "ISO 8601 date string (yyyy-mm-dd). Only jobs published in this date or before will be returned.", "examples": [ null, "2025-05-25" ] }, "discovered_at_max_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Max Age Days", "description": "If 0, only return jobs added to our database in the current day. If 1, from today and yesterday, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_min_age_days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Discovered At Min Age Days", "description": "If 1, only return jobs discovered by TheirStack until yesterday. If 2, until 2 days ago, etc.", "examples": [ null, 10, 2, 0 ] }, "discovered_at_gte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Gte", "description": "Only jobs discovered by TheirStack on this date or datetime or after will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "discovered_at_lte": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Discovered At Lte", "description": "Only jobs discovered by TheirStack on this date or datetime or before will be returned. In UTC timezone.", "examples": [ null, "2025-05-25", "2025-05-25T12:00:00Z" ] }, "job_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Or", "description": "Regex patterns to look for in job descriptions. Case-insensitive. Results will include jobs whose description matches any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Not", "description": "Regex patterns to look for in job descriptions. Results will include jobs whose description don't match any of these patterns. Can pass more than one.", "default": [], "examples": [ [], [ "remote", "remote-only" ], [ "remote", "freelance" ] ] }, "job_description_pattern_is_case_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Job Description Pattern Is Case Insensitive", "description": "Whether to make searches on job descriptions case-sensitive or insensitive. Deprecated field and won't work, use job_description_pattern_case_sensitive_or instead.", "default": true, "deprecated": true, "examples": [ null, true, false ] }, "job_description_contains_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Or", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_contains_not": { "items": { "type": "string" }, "type": "array", "title": "Job Description Contains Not", "description": "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.", "default": [], "examples": [ [], [ "python", "javascript" ], [ "quality", "testing" ] ] }, "job_description_pattern_case_sensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Job Description Pattern Case Sensitive Or", "description": "Regex patterns to look for in job descriptions. Case-sensitive. If patterns are uppercase, they will be searched case-sensitively. Results will include jobs whose description matches any of these patterns.", "default": [], "examples": [ [], [ "Python", "JavaScript" ], [ "API", "REST" ] ] }, "remote": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remote", "description": "True: only show remote jobs. False: only show non-remote jobs. None: show all jobs.", "examples": [ null, true, false ] }, "only_jobs_with_reports_to": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Reports To", "description": "Only return jobs where we identified the role the hired person would report to. Deprecated field, use reports_to_exists instead.", "deprecated": true, "examples": [ null, true, false ] }, "reports_to_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Reports To Exists", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "final_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Final Url Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "only_jobs_with_hiring_managers": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Jobs With Hiring Managers", "description": "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.", "deprecated": true, "examples": [ null, true, false ] }, "hiring_managers_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hiring Managers Exists", "description": "(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.", "deprecated": true, "examples": [ null, true, false ] }, "job_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Or", "description": "Get jobs with these IDs only.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Job Id Not", "description": "Exclude jobs with these IDs.", "default": [], "examples": [ [], [ 12423312, 2123123, 3123123 ] ] }, "job_ids": { "items": { "type": "integer" }, "type": "array", "title": "Job Ids", "description": "Get jobs with these IDs only. Deprecated parameter, use job_id_or instead.", "default": [], "deprecated": true }, "job_seniority_or": { "items": { "type": "string", "enum": [ "c_level", "staff", "senior", "junior", "mid_level" ] }, "type": "array", "title": "Job Seniority Or", "description": "Will return jobs where the seniority is any of the ones passed here", "default": [], "examples": [ [], [ "intern", "entry", "mid", "senior", "principal" ] ] }, "min_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Salary Usd", "description": "Minimum annual salary in USD. For example, 100000 means $100,000.", "examples": [ null, 100000, 150000 ] }, "max_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Salary Usd", "description": "Maximum annual salary in USD. For example, 150000 means $150,000.", "examples": [ null, 100000, 150000 ] }, "job_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Or", "description": "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.", "default": [] }, "job_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug Not", "description": "Will return jobs where none of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Job Technology Slug And", "description": "Will return jobs where all of these technologies appear. Case sensitive. Pass slugs. Check out all the technologies we track with the technologies endpoint.", "default": [] }, "job_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Or", "description": "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. Use this to find jobs in specific cities, states, or regions.", "default": [], "examples": [ [], [ "san francisco" ], [ "california", "new york" ], [ "madrid" ] ] }, "job_location_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Job Location Pattern Not", "description": "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.", "default": [], "examples": [ [], [ "new york", "california" ], [ "madrid" ] ] }, "job_location_or": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Or", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "job_location_not": { "items": { "$ref": "#/components/schemas/JobLocationFilter", "_circular": true }, "type": "array", "title": "Job Location Not", "description": "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))", "default": [], "examples": [ [], [ { "id": 5128581 }, { "id": 2921044 } ] ] }, "url_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Or", "description": "Include jobs only if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "url_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Url Domain Not", "description": "Exclude jobs if their URL domain 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.", "default": [], "examples": [ [], [ "greenhouse.io", "workable.com", "join.com", "lever.co" ], [ "linkedin.com" ] ] }, "scraper_name_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Scraper Name Pattern Or", "description": "Regex patterns to match job sources. Case-insensitive.", "default": [], "deprecated": true }, "easy_apply": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Easy Apply", "description": "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.", "examples": [ null, true, false ] }, "employment_statuses_or": { "anyOf": [ { "items": { "$ref": "#/components/schemas/Commitment", "_circular": true }, "type": "array" }, { "type": "null" } ], "title": "Employment Statuses Or", "description": "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.", "examples": [ [], [ "full_time" ], [ "full_time", "part_time" ] ] }, "company_name_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Or", "description": "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.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_case_insensitive_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Case Insensitive Or", "description": "Only return companies that match these names exactly, case-insensitively.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_id_or": { "items": { "type": "string" }, "type": "array", "title": "Company Id Or", "description": "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.", "default": [], "examples": [ [], [ "1234567890", "1234567891" ] ] }, "company_domain_or": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Or", "description": "Only return companies that match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.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.", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_domain_not": { "items": { "type": "string" }, "type": "array", "title": "Company Domain Not", "description": "Only return companies that don't match these domains exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).", "default": [], "examples": [ [], [ "google.com", "stripe.com" ], [ "https://www.google.com/", "https://stripe.com/" ], [ "andrew@stripe.com ", "mark@meta.com" ] ] }, "company_name_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Not", "description": "Only return companies that don't match these names exactly, case-sensitively.", "default": [], "examples": [ [], [ "Google", "Facebook", "Apple" ] ] }, "company_name_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Or", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_name_partial_match_not": { "items": { "type": "string" }, "type": "array", "title": "Company Name Partial Match Not", "description": "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.", "default": [], "examples": [ [], [ "google", "stripe" ] ] }, "company_linkedin_url_or": { "items": { "type": "string" }, "type": "array", "title": "Company Linkedin Url Or", "description": "Return companies whose LinkedIn URL matches any of the slugs passed here. Can also pass full LinkedIn company URLs.", "default": [], "examples": [ [], [ "https://www.linkedin.com/company/google/" ] ] }, "blur_company_data": { "type": "boolean", "title": "Blur Company Data", "description": "Enable preview mode to return blurred data without consuming API credits. When enabled, sensitive company fields (name, domain, URLs, descriptions) and job-specific fields (description, URLs) are blurred. This mode is useful for sales software integrations to show data previews to end users. Not available when filtering by company identifiers (company_name, company_domain, company_linkedin_url, company_id). Learn more about [here](https://theirstack.com/en/docs/api/preview-data-mode)", "default": false }, "property_exists_or": { "items": { "type": "string", "enum": [ "company_object.domain", "company_object.linkedin_url", "final_url", "hiring_team", "employment_statuses" ] }, "type": "array", "title": "Property Exists Or", "description": "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.", "default": [], "examples": [ [], [ "company_object.domain", "company_object.linkedin_url", "final_url" ] ] }, "property_exists_and": { "items": { "type": "string", "enum": [ "company_object.domain", "company_object.linkedin_url", "final_url", "hiring_team", "employment_statuses" ] }, "type": "array", "title": "Property Exists And", "default": [], "examples": [ [], [ "company_object.domain", "company_object.linkedin_url", "final_url" ] ] }, "company_description_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Or", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_not": { "items": { "type": "string" }, "type": "array", "title": "Company Description Pattern Not", "description": "Case-insensitive patterns to match in the company description. Will return companies that match any of the patterns.", "default": [] }, "company_description_pattern_accent_insensitive": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Description Pattern Accent Insensitive", "description": "Set to True to make company description searches accent insensitive. For example, \"á\" will match \"a\" as well.", "default": false, "examples": [ null, true, false ] }, "min_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Revenue Usd", "description": "Minimum company revenue, in USD", "examples": [ null ] }, "max_revenue_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Revenue Usd", "description": "Maximum company revenue, in USD", "examples": [ null ] }, "min_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count", "description": "Minimum number of employees in a company", "examples": [ null, 100 ] }, "max_employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count", "description": "Maximum number of employees in a company", "examples": [ null, 100 ] }, "min_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Employee Count Or Null", "description": "Minimum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "max_employee_count_or_null": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Employee Count Or Null", "description": "Maximum number of employees in a company. If we don't have company size information, we will return it as well.", "examples": [ null, 100 ] }, "min_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Funding Usd", "description": "Minimum company funding, in USD", "examples": [ null, 1000000000 ] }, "max_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Funding Usd", "description": "Maximum company funding, in USD", "examples": [ null, 1000000000 ] }, "funding_stage_or": { "items": { "type": "string" }, "type": "array", "title": "Funding Stage Or", "description": "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']", "default": [] }, "industry_or": { "items": { "type": "string" }, "type": "array", "title": "Industry Or", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_or field instead. ", "default": [], "deprecated": true }, "industry_not": { "items": { "type": "string" }, "type": "array", "title": "Industry Not", "description": "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)\n\n WARNING: Deprecated parameter. Use the industry_id_not field instead. ", "default": [], "deprecated": true }, "industry_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Or", "description": "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)", "default": [] }, "industry_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Industry Id Not", "description": "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)", "default": [] }, "company_tags_or": { "items": { "type": "string" }, "type": "array", "title": "Company Tags Or", "description": "Return companies that match any of these keywords", "default": [] }, "company_type": { "anyOf": [ { "type": "string", "enum": [ "recruiting_agency", "direct_employer", "all" ] }, { "type": "null" } ], "title": "Company Type", "description": "Filter by company type." }, "company_investors_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Or", "description": "Investors of the company", "default": [] }, "company_investors_partial_match_or": { "items": { "type": "string" }, "type": "array", "title": "Company Investors Partial Match Or", "description": "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).", "default": [] }, "company_technology_slug_or": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Or", "description": "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)", "default": [] }, "company_technology_slug_and": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug And", "description": "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)", "default": [] }, "company_technology_slug_not": { "items": { "type": "string" }, "type": "array", "title": "Company Technology Slug Not", "description": "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)", "default": [] }, "only_yc_companies": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Only Yc Companies", "description": "Only return YC companies", "default": false }, "company_location_pattern_or": { "items": { "type": "string" }, "type": "array", "title": "Company Location Pattern Or", "description": "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.", "default": [] }, "company_country_code_or": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Or", "description": "Return companies whose HQ country code is any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_country_code_not": { "items": { "type": "string" }, "type": "array", "title": "Company Country Code Not", "description": "Return companies whose HQ country code is not any of the ones passed here, case sensitive. Pass ISO2 country codes.", "default": [] }, "company_list_id_or": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Or", "description": "Return companies that belong to any of the company lists passed here", "default": [] }, "company_list_id_not": { "items": { "type": "integer" }, "type": "array", "title": "Company List Id Not", "description": "Return companies that don't belong to any of the company lists passed here", "default": [] }, "company_linkedin_url_exists": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Company Linkedin Url Exists", "description": "(Use `property_exists_or / property_exists_and` instead) Only return companies with a LinkedIn URL", "deprecated": true, "examples": [ null ] }, "revealed_company_data": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Revealed Company Data", "description": "This field is deprecated and has no effect.", "deprecated": true, "examples": [ null ] }, "last_funding_round_date_lte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Lte", "description": "Only return companies whose last funding round date is before or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "last_funding_round_date_gte": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date Gte", "description": "Only return companies whose last funding round date is after or on this date. Format: 'YYYY-MM-DD'", "examples": [ null, "2025-05-25" ] }, "include_total_results": { "type": "boolean", "title": "Include Total Results", "description": "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.", "default": false } }, "additionalProperties": false, "type": "object", "title": "JobSearchFilters" } ], "title": "Body", "description": "Filters. CompanySearchFilters if type is 'companies', JobSearchFilters if type is 'jobs'" }, "is_alert_active": { "type": "boolean", "title": "Is Alert Active", "description": "Is the alert active", "default": false }, "user_id": { "type": "integer", "title": "User Id", "description": "Owner of the saved search" }, "team_id": { "type": "integer", "title": "Team Id", "description": "Team of the saved search" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At", "description": "Date and time when the saved search was created" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At", "description": "Date and time when the saved search was last updated" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Query", "description": "Query of the request" }, "path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Path", "description": "Path of the request" }, "querystring_params": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Querystring Params", "description": "Dictionary containing the querystring parameters of the request." }, "creator": { "properties": { "id": { "type": "integer", "title": "Id" }, "email": { "type": "string", "title": "Email", "description": "The user's email address" }, "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "First Name", "description": "The user's first name" }, "last_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Name", "description": "The user's last name" } }, "type": "object", "required": [ "id", "email" ], "title": "UserSimple" }, "is_archived": { "type": "boolean", "title": "Is Archived", "description": "Is the saved search archived", "default": false }, "has_active_webhooks": { "type": "boolean", "title": "Has Active Webhooks", "description": "Has active webhooks", "default": false }, "frequency": { "anyOf": [ { "type": "string", "enum": [ "daily", "weekly" ] }, { "type": "null" } ], "title": "Frequency", "description": "Frequency of emails alerts sent." }, "emails_subscribed": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Emails Subscribed", "description": "Emails subscribed to the saved search alerts.", "default": [] } }, "type": "object", "required": [ "id", "name", "type", "body", "user_id", "team_id", "created_at", "updated_at", "creator" ], "title": "SavedSearch" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Get Webhook By Id description: Get a webhook by ID. url: https://theirstack.com/en/docs/api-reference/webhooks/get_webhooks_by_id_v0 --- ## OpenAPI Specification ```json { "path": "/v0/webhooks/{webhook_id}", "method": "GET", "tags": [ "Webhooks" ], "summary": "Get Webhook By Id", "description": "Get a webhook by ID.", "operationId": "get_webhooks_by_id_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "webhook_id", "in": "path", "required": true, "schema": { "type": "integer", "description": "ID of the webhook", "examples": [ 123 ], "title": "Webhook Id" }, "description": "ID of the webhook" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2083, "minLength": 1, "format": "uri", "title": "Url", "description": "URL of the webhook", "examples": [ "https://example.com/webhook" ] }, "search_id": { "type": "integer", "title": "Search Id", "description": "ID of the search that the webhook is listening to.", "examples": [ 123 ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the webhook", "examples": [ "Webhook for new jobs" ] }, "listening_start_time": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Listening Start Time", "description": "Date when the webhook started listening for events. If listening_start_time is None, the webhook will listen to all events matching the search query regardless of when they occurred.", "examples": [ "2024-01-01T00:00:00" ] }, "trigger_once_per_company": { "type": "boolean", "title": "Trigger Once Per Company", "description": "Only for webhook type ='job.new'. If true, Company A with 5 jobs → 1 event triggered. If false, Company A with 5 jobs → 5 events triggered", "default": false, "examples": [ true ] }, "id": { "type": "integer", "title": "Id" }, "user_id": { "type": "integer", "title": "User Id" }, "team_id": { "type": "integer", "title": "Team Id" }, "is_active": { "type": "boolean", "title": "Is Active" }, "is_archived": { "type": "boolean", "title": "Is Archived" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" }, "search_name": { "type": "string", "title": "Search Name" }, "event_type": { "type": "string", "enum": [ "job_new", "company_new" ], "title": "WebhookEventType" }, "scanning_frequency": { "type": "string", "title": "Scanning Frequency", "description": "Scanning frequency for the webhook", "default": "10m" } }, "type": "object", "required": [ "url", "search_id", "id", "user_id", "team_id", "is_active", "is_archived", "created_at", "updated_at", "search_name", "event_type" ], "title": "Webhook" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Get Aggregated Webhook Event Count description: Get the webhook events count aggregated by day with grouping options url: https://theirstack.com/en/docs/api-reference/webhooks/get_webhooks_events_count_aggregated_v0 --- ## OpenAPI Specification ```json { "path": "/v0/webhooks/events/count", "method": "GET", "tags": [ "Webhooks" ], "summary": "Get Aggregated Webhook Event Count", "description": "Get the webhook events count aggregated by day with grouping options", "operationId": "get_webhooks_events_count_aggregated_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "start_datetime", "in": "query", "required": false, "schema": { "type": "string", "format": "date-time", "description": "Start datetime in ISO format (e.g., 2023-01-01T00:00:00)", "default": "2026-01-10T16:25:33.840190Z", "title": "Start Datetime" }, "description": "Start datetime in ISO format (e.g., 2023-01-01T00:00:00)" }, { "name": "end_datetime", "in": "query", "required": false, "schema": { "type": "string", "format": "date-time", "description": "End datetime in ISO format (e.g., 2023-01-01T23:59:59)", "default": "2026-02-09T16:25:33.840264Z", "title": "End Datetime" }, "description": "End datetime in ISO format (e.g., 2023-01-01T23:59:59)" }, { "name": "timezone", "in": "query", "required": false, "schema": { "type": "string", "description": "IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')", "default": "UTC", "title": "Timezone" }, "description": "IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')" }, { "name": "webhook_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Webhook ID", "title": "Webhook Id" }, "description": "Webhook ID" }, { "name": "group_by", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "status", "webhook_id" ], "title": "WebhookGroupBy" }, "description": "How to group the results: by status or webhook_id" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "period_start": { "type": "string", "format": "date-time", "title": "Period Start", "description": "Start of the period." }, "number_of_events": { "type": "integer", "title": "Number Of Events", "description": "Number of events.", "default": 0 }, "status": { "anyOf": [ { "type": "string", "enum": [ "IN_PROGRESS", "SUCCESS", "FAILED", "NOT_TRIGGERED" ], "title": "WebhookEventStatus" }, { "type": "null" } ], "description": "Status of the webhook event." }, "webhook_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Webhook Id", "description": "ID of the webhook." }, "number_of_executions": { "type": "integer", "title": "Number Of Executions", "description": "Deprecated: use number_of_events.", "deprecated": true, "readOnly": true } }, "type": "object", "required": [ "period_start", "number_of_executions" ], "title": "WebhookEventCount" }, "title": "Response Get Webhooks Events Count Aggregated V0" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Get Webhook Event Count description: Get the total number of events triggered for a specific webhook url: https://theirstack.com/en/docs/api-reference/webhooks/get_webhooks_events_count_v0 --- ## OpenAPI Specification ```json { "path": "/v0/webhooks/{webhook_id}/events/count", "method": "GET", "tags": [ "Webhooks" ], "summary": "Get Webhook Event Count", "description": "Get the total number of events triggered for a specific webhook", "operationId": "get_webhooks_events_count_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "webhook_id", "in": "path", "required": true, "schema": { "type": "integer", "description": "ID of the webhook", "examples": [ 123 ], "title": "Webhook Id" }, "description": "ID of the webhook" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "integer", "title": "Response Get Webhooks Events Count V0" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: List Webhook Events description: List all events triggered for a specific webhook url: https://theirstack.com/en/docs/api-reference/webhooks/get_webhooks_events_v0 --- ## OpenAPI Specification ```json { "path": "/v0/webhooks/{webhook_id}/events", "method": "GET", "tags": [ "Webhooks" ], "summary": "List Webhook Events", "description": "List all events triggered for a specific webhook", "operationId": "get_webhooks_events_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "webhook_id", "in": "path", "required": true, "schema": { "type": "integer", "description": "ID of the webhook", "examples": [ 123 ], "title": "Webhook Id" }, "description": "ID of the webhook" }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "enum": [ "IN_PROGRESS", "SUCCESS", "FAILED", "NOT_TRIGGERED" ], "title": "WebhookEventStatus" }, { "type": "null" } ], "description": "Status of the webhook events to filter by", "title": "Status" }, "description": "Status of the webhook events to filter by" }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Number of results to skip", "default": 0, "title": "Offset" }, "description": "Number of results to skip" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "description": "Number of results per page", "default": 25, "title": "Limit" }, "description": "Number of results per page" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "properties": { "id": { "type": "integer", "title": "Id" }, "webhook_id": { "type": "integer", "title": "Webhook Id" }, "job_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Job Id" }, "company_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Company Name" }, "triggered_at": { "type": "string", "format": "date-time", "title": "Triggered At" }, "status": { "$ref": "#/components/schemas/WebhookEventStatus", "_circular": true }, "payload": { "anyOf": [ { "properties": { "id": { "type": "integer", "title": "Id", "description": "ID of the job", "examples": [ 1234 ] }, "job_title": { "type": "string", "title": "Job Title", "description": "Job title", "examples": [ "Senior Data Engineer" ] }, "url": { "type": "string", "title": "Url", "description": "URL of the job post", "examples": [ "https://example.com/job/1234" ] }, "date_posted": { "type": "string", "format": "date", "title": "Date Posted", "description": "Date when the job was posted", "examples": [ "2021-01-01" ] }, "has_blurred_data": { "type": "boolean", "title": "Has Blurred Data", "description": "Whether the returned object has company identifiable data blurred or not", "default": false }, "company": { "type": "string", "title": "Company", "description": "Company name. This field is deprecated, please don't use it", "deprecated": true, "examples": [ "Google" ] }, "final_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Final Url", "description": "Is the URL of the job in the career page of the company.", "examples": [ "https://carecrafterhealth.com/careers/job-details/MFC286442-4", "https://www.google.com/about/careers/applications/jobs/results/110690555461018310-software-engineer-iii-infrastructure-core", "https://job-boards.greenhouse.io/sondermind/jobs/6620635003?gh_src=c1701b3d3us" ] }, "source_url": { "type": "string", "title": "Source Url", "description": "Is the url TheirStack used to get the job data.", "examples": [ "https://www.linkedin.com/jobs/view/1234567890" ] }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Location", "description": "This is the city of the job.", "deprecated": true, "examples": [ "New York", "Madrid", "London" ] }, "short_location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Short Location", "description": "It's a combination of the city and the state of the job.", "deprecated": true, "examples": [ "Tulsa, OK", "Methuen, MA" ] }, "long_location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Long Location", "description": "It's a combination of the city, the state and the postal code of the job.", "deprecated": true, "examples": [ "Methuen, MA 01844", "Tulsa, OK 74110" ] }, "state_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "State Code", "description": "The state code of the job.", "deprecated": true, "examples": [ "OK", "MA", "NY" ] }, "latitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Latitude", "description": "The latitude of the job.", "deprecated": true, "examples": [ 37.774929, 42.360082 ] }, "longitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Longitude", "description": "The longitude of the job.", "deprecated": true, "examples": [ -96.726486, -71.056883 ] }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Postal Code", "description": "The postal code of the job.", "deprecated": true, "examples": [ "01844", "74110" ] }, "remote": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remote", "description": "If the job is remote.", "examples": [ true, false ] }, "hybrid": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hybrid", "description": "If the job is hybrid. A hybrid position is a job that combines remote and in-office work.", "examples": [ true, false ] }, "salary_string": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Salary String", "description": "The salary of the job in the local currency. If a similar field is present in the job source, this property will contain the same content. If no similar field is present, the content will be have the following format: - per year. For the currencies where the symbol precedes the digits, the format will be - per year. In these latter two cases, both the min and max annual salary are expressed in either k (for thousands) or M (for millions).", "examples": [ "$100,000 - $120,000", "80k € - 120k € per year" ] }, "min_annual_salary": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Min Annual Salary", "description": "The minimum annual salary of the job in the local currency.", "examples": [ 100000, 120000 ] }, "min_annual_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Annual Salary Usd", "description": "The minimum annual salary of the job in USD.", "examples": [ 100000, 120000 ] }, "max_annual_salary": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Annual Salary", "description": "The maximum annual salary of the job in the local currency.", "examples": [ 100000, 120000 ] }, "max_annual_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Annual Salary Usd", "description": "The maximum annual salary of the job in USD.", "examples": [ 100000, 120000 ] }, "avg_annual_salary_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Avg Annual Salary Usd", "description": "This property calculates the average annual salary for a job in USD, based on the available minimum and maximum annual salary values (both already converted to USD):\n If both min_annual_salary_usd and max_annual_salary_usd are missing or zero, it returns None.\n If only the minimum is missing, it returns the maximum value.\n If only the maximum is missing, it returns the minimum value.\n If both are present, it returns the average of the two, rounded to two decimal places.\n This ensures the property always provides the best possible estimate of the average salary, even if only one bound is available.\n ", "examples": [ 100000, 120000 ] }, "salary_currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Salary Currency", "description": "The currency of the salary of the job.", "examples": [ "USD", "EUR", "GBP" ] }, "countries": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Countries", "description": "Countries of the job", "deprecated": true, "examples": [ [ "United States", "Canada", "Spain", "France", "Australia" ] ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country", "description": "Country name of the job", "deprecated": true, "examples": [ "United States", "Canada", "Spain", "France", "Australia" ] }, "country_codes": { "anyOf": [ { "items": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "type": "array" }, { "type": "null" } ], "title": "Country Codes", "description": "Two-letter country codes (ISO 3166-1 alpha-2) representing the job's locations.", "deprecated": true, "examples": [ [ "US", "CA", "ES", "FR", "AU" ], [ "US" ], [ "US", "CA" ] ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Code", "description": "Two-letter country code (ISO 3166-1 alpha-2) representing the job's location. If the job has multiple locations, the first one is returned.", "deprecated": true, "examples": [ "US", "CA", "ES", "FR", "AU" ] }, "cities": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Cities", "description": "Cities of the job", "deprecated": true, "examples": [ [ "New York", "San Francisco", "London", "Paris", "Sydney" ] ] }, "continents": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Continents", "description": "Continents of the job", "deprecated": true, "examples": [ [ "North America", "Europe", "Asia", "Australia", "South America" ] ] }, "seniority": { "anyOf": [ { "type": "string", "enum": [ "c_level", "staff", "senior", "junior", "mid_level" ], "title": "Seniority" }, { "type": "null" } ], "description": "Seniority level of the job" }, "discovered_at": { "type": "string", "format": "date-time", "title": "Discovered At", "description": "Date when the job was discovered by TheirStack", "examples": [ "2024-01-01T00:00:00" ] }, "company_domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Company Domain", "description": "Company website domain", "examples": [ "acme.com" ] }, "hiring_team": { "anyOf": [ { "items": { "properties": { "first_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "First Name", "description": "First name of the person" }, "full_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Full Name", "description": "Full name of the person" }, "linkedin_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Linkedin Url", "description": "LinkedIn URL of the person" }, "role": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role", "description": "Role of the person" }, "image_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Image Url", "description": "Image URL of the person" }, "thumbnail_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thumbnail Url", "description": "Thumbnail URL of the person" } }, "type": "object", "title": "PersonBase" }, "type": "array" }, { "type": "null" } ], "title": "Hiring Team", "description": "Hiring team who posted the job", "examples": [ [ { "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" } ] ] }, "reposted": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Reposted", "description": "Indicates whether the employer has republished this job posting.", "examples": [ true, false ] }, "date_reposted": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Date Reposted", "description": "Date when the job was reposted", "examples": [ "2024-01-01" ] }, "employment_statuses": { "items": { "type": "string", "enum": [ "full_time", "part_time", "temporary", "internship", "contract", "freelance", "co_founder", "apprenticeship", "seasonal", "volunteer", "other" ], "title": "Commitment" }, "type": "array", "title": "Employment Statuses", "description": "Employment statuses of the job", "default": [], "examples": [ [ "full_time" ] ] }, "easy_apply": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Easy Apply", "description": "Indicates whether the job application can be submitted directly through the job board (easy_apply=True) or requires redirecting to the company's website (easy_apply=False).", "examples": [ true, false ] }, "technology_slugs": { "items": { "type": "string" }, "type": "array", "title": "Technology Slugs", "description": "Slugs of the technologies of the job", "default": [], "examples": [ [ "google-firebase", "postgresql", "jira" ] ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Job description in markdown format", "examples": [ "## 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" ] }, "company_object": { "properties": { "id": { "type": "string", "title": "Id", "description": "Company ID", "examples": [ "google" ] }, "name": { "type": "string", "title": "Name", "description": "Company name", "examples": [ "Google" ] }, "domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Domain", "description": "Company domain", "examples": [ "google.com" ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Industry", "description": "Industry of the company", "examples": [ "internet" ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country", "description": "Country of the company's HQ", "examples": [ "United States" ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Code", "description": "ISO2 country code. E.g. \"US\"" }, "employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Employee Count", "description": "Number of employees of the company", "examples": [ 7543 ] }, "logo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logo", "description": "Stable CDN-hosted company logo URL suitable for display in applications", "examples": [ "https://example.com/logo.png" ] }, "num_jobs": { "type": "integer", "title": "Num Jobs", "description": "Number of jobs from this company in our database", "default": 0, "examples": [ 746 ] }, "num_technologies": { "type": "integer", "title": "Num Technologies", "description": "Number of technologies mentioned in the jobs of this company", "default": 0, "examples": [ 746 ] }, "possible_domains": { "items": { "type": "string" }, "type": "array", "title": "Possible Domains", "description": "List of possible domains for the company", "default": [] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url", "description": "Company domain. Same as the \"domain\" field. Will be deprecated in the future.", "examples": [ "google.com" ] }, "industry_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Industry Id", "description": "Code of the industry. One of LinkedIn's Industry Codes V2 from https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2" }, "linkedin_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Linkedin Url", "examples": [ "http://www.linkedin.com/company/google" ] }, "num_jobs_last_30_days": { "type": "integer", "title": "Num Jobs Last 30 Days", "description": "Number of jobs from this company in our database posted in the last 30 days", "default": 0, "examples": [ 34 ] }, "num_jobs_found": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Num Jobs Found", "description": "When filtering companies by jobs, number of jobs found for this company", "examples": [ 23 ] }, "yc_batch": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Yc Batch", "description": "If the company went through YC, this is its batch", "examples": [ "W21" ] }, "apollo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Apollo Id", "description": "ID of the company in Apollo", "examples": [ "5b839bd0324d4445051f9a5a" ] }, "linkedin_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Linkedin Id", "description": "ID of the company in LinkedIn" }, "url_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url Source", "description": "Source of the company URL" }, "is_recruiting_agency": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Recruiting Agency", "description": "Is a recruiting agency" }, "founded_year": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Founded Year", "description": "Year the company was founded", "examples": [ 2019 ] }, "annual_revenue_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Annual Revenue Usd", "description": "Annual revenue of the company in USD", "examples": [ 189000000 ] }, "annual_revenue_usd_readable": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Annual Revenue Usd Readable", "description": "Annual revenue of the company in USD, formated as an easily readable string", "examples": [ "189M" ] }, "total_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Funding Usd", "description": "Funding of the company in USD", "examples": [ 500000 ] }, "last_funding_round_date": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date", "description": "Date of the last funding round of the company", "examples": [ "2020-01-01" ] }, "last_funding_round_amount_readable": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Funding Round Amount Readable", "description": "Amount of the last funding round of the company, formated as an easily readable string", "examples": [ "$1.2M" ] }, "employee_count_range": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Employee Count Range", "description": "Number range of employees at the company", "examples": [ "1001-5000" ] }, "long_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Long Description", "description": "Short description of the company", "examples": [ "Google is a California-based multinational technology company that offers internet-related services such as a search engine, online advertising and cloud computing." ] }, "seo_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Seo Description", "description": "SEO description of the company, extracted from their website" }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "City", "description": "City of the company's HQ", "examples": [ "Mountain View" ] }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Postal Code", "description": "Postal code of the company's HQ", "examples": [ "28040" ] }, "company_keywords": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Company Keywords", "description": "Company keywords, related to what the company does" }, "alexa_ranking": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Alexa Ranking", "description": "Alexa ranking", "examples": [ 1 ] }, "publicly_traded_symbol": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Publicly Traded Symbol", "examples": [ "GOOG" ] }, "publicly_traded_exchange": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Publicly Traded Exchange", "examples": [ "NASDAQ" ] }, "investors": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Investors", "description": "List of investors in this company" }, "funding_stage": { "anyOf": [ { "type": "string", "enum": [ "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" ], "title": "FundingStage" }, { "type": "null" } ], "description": "Latest funding stage of the company" }, "has_blurred_data": { "type": "boolean", "title": "Has Blurred Data", "description": "Whether the returned object has company identifiable data blurred or not", "default": false }, "technology_slugs": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Technology Slugs", "description": "slugs of the technologies found to be used by the company", "examples": [ [ "kafka", "elasticsearch" ] ] }, "technology_names": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Technology Names", "description": "Names of the technologies found to be used by the company", "deprecated": true, "examples": [ [ "Kafka", "Elasticsearch" ] ] } }, "type": "object", "required": [ "id", "name" ], "title": "CompanyWithTechnologySlugs" }, "locations": { "items": { "properties": { "id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Id", "description": "The unique identifier for the location, is based on the geonameid field from the geonames database", "examples": [ 5128581 ] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name", "description": "The name of the location. If it's a city, it will be the city name; if it's a country, it will be the country name; if it's a region, it will be the region name, etc", "examples": [ "New York City", "Germany" ] }, "type": { "anyOf": [ { "type": "string", "enum": [ "city", "region", "country", "continent" ], "title": "GeonameType" }, { "type": "null" } ], "description": "The type of the location", "examples": [ "city", "country", "region" ] }, "feature_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Feature Code", "description": "GeoNames feature code (e.g., 'PPL' for populated place, 'ADM1' for first-order administrative division, 'PCLI' for country). Check all the possible feature codes in the GeoNames documentation", "examples": [ "PPL", "ADM1", "PCLI" ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Code", "description": "ISO 3166-1 alpha-2 country code of the location", "examples": [ "US", "DE" ] }, "admin1_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Admin1 Name", "description": "The first level administrative division name of the location", "examples": [ "New York", "California" ] }, "admin1_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Admin1 Code", "description": "The first level administrative division code of the location", "examples": [ "NY", "CA" ] }, "admin2_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Admin2 Name", "description": "The second level administrative division name of the location (e.g., county or district)", "examples": [ "New York County", "Los Angeles County" ] }, "admin2_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Admin2 Code", "description": "The second level administrative division code of the location", "examples": [ "NY", "LA" ] }, "continent": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Continent", "description": "Continent code of the location", "examples": [ "NA", "EU", "AS" ] }, "latitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Latitude", "description": "Geographic latitude coordinate for precise mapping", "examples": [ 40.71427, 37.774929 ] }, "longitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Longitude", "description": "Geographic longitude coordinate for precise mapping", "examples": [ -74.00597, -122.419416 ] }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "City", "description": "The city of the location (Deprecated): Use 'name' field when 'type' is 'city'", "deprecated": true }, "address": { "type": "null", "title": "Address", "description": "Address of the location (Deprecated): This field has been removed. Use the location fields (name, admin1_name, country_code, etc.) to construct addresses as needed", "deprecated": true, "examples": [ null ] }, "postal_code": { "type": "null", "title": "Postal Code", "description": "Postal code of the location (Deprecated): This field has been removed and is no longer available", "deprecated": true, "examples": [ null ] }, "state": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "State", "description": "State of the location (Deprecated): Use 'admin1_name' instead", "deprecated": true, "examples": [ "California" ] }, "state_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "State Code", "description": "State code of the location (Deprecated): Use 'admin1_code' instead", "deprecated": true, "examples": [ "06" ] }, "display_name": { "type": "string", "title": "Display Name", "description": "A human-readable display name for the location, constructed from available location fields", "readOnly": true, "examples": [ "New York City, New York, United States", "Germany", "California, United States" ] }, "country_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Name", "description": "The full country name derived from the country_code", "readOnly": true, "examples": [ "United States", "Germany", "United Kingdom" ] } }, "type": "object", "required": [ "display_name", "country_name" ], "title": "JobLocation" }, "type": "array", "title": "Locations", "description": "All possible locations of the job with coordinates, city, state, state_code, country_code, etc.", "default": [], "examples": [ [ { "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" } ] ] }, "normalized_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Normalized Title" }, "manager_roles": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Manager Roles", "description": "Roles of the person or people found in the job description to be the managers of the hired person. Can be useful to infer who's the decision maker for the technologies mentioned in the job post." }, "matching_phrases": { "anyOf": [ { "items": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "type": "array" }, { "type": "null" } ], "title": "Matching Phrases", "description": "Phrases from the job description that match the pattern passed", "default": [] }, "matching_words": { "anyOf": [ { "items": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "type": "array" }, { "type": "null" } ], "title": "Matching Words", "description": "Words from the job description that match the pattern passed", "default": [] } }, "type": "object", "required": [ "id", "job_title", "url", "date_posted", "company", "source_url", "discovered_at", "company_object" ], "title": "JobWithMatchingPhrasesResponse" }, { "properties": { "id": { "type": "string", "title": "Id", "description": "Company ID", "examples": [ "google" ] }, "name": { "type": "string", "title": "Name", "description": "Company name", "examples": [ "Google" ] }, "domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Domain", "description": "Company domain", "examples": [ "google.com" ] }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Industry", "description": "Industry of the company", "examples": [ "internet" ] }, "country": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country", "description": "Country of the company's HQ", "examples": [ "United States" ] }, "country_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Country Code", "description": "ISO2 country code. E.g. \"US\"" }, "employee_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Employee Count", "description": "Number of employees of the company", "examples": [ 7543 ] }, "logo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logo", "description": "Stable CDN-hosted company logo URL suitable for display in applications", "examples": [ "https://example.com/logo.png" ] }, "num_jobs": { "type": "integer", "title": "Num Jobs", "description": "Number of jobs from this company in our database", "default": 0, "examples": [ 746 ] }, "num_technologies": { "type": "integer", "title": "Num Technologies", "description": "Number of technologies mentioned in the jobs of this company", "default": 0, "examples": [ 746 ] }, "possible_domains": { "items": { "type": "string" }, "type": "array", "title": "Possible Domains", "description": "List of possible domains for the company", "default": [] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url", "description": "Company domain. Same as the \"domain\" field. Will be deprecated in the future.", "examples": [ "google.com" ] }, "industry_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Industry Id", "description": "Code of the industry. One of LinkedIn's Industry Codes V2 from https://learn.microsoft.com/en-us/linkedin/shared/references/reference-tables/industry-codes-v2" }, "linkedin_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Linkedin Url", "examples": [ "http://www.linkedin.com/company/google" ] }, "num_jobs_last_30_days": { "type": "integer", "title": "Num Jobs Last 30 Days", "description": "Number of jobs from this company in our database posted in the last 30 days", "default": 0, "examples": [ 34 ] }, "num_jobs_found": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Num Jobs Found", "description": "When filtering companies by jobs, number of jobs found for this company", "examples": [ 23 ] }, "yc_batch": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Yc Batch", "description": "If the company went through YC, this is its batch", "examples": [ "W21" ] }, "apollo_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Apollo Id", "description": "ID of the company in Apollo", "examples": [ "5b839bd0324d4445051f9a5a" ] }, "linkedin_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Linkedin Id", "description": "ID of the company in LinkedIn" }, "url_source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url Source", "description": "Source of the company URL" }, "is_recruiting_agency": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Recruiting Agency", "description": "Is a recruiting agency" }, "founded_year": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Founded Year", "description": "Year the company was founded", "examples": [ 2019 ] }, "annual_revenue_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Annual Revenue Usd", "description": "Annual revenue of the company in USD", "examples": [ 189000000 ] }, "annual_revenue_usd_readable": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Annual Revenue Usd Readable", "description": "Annual revenue of the company in USD, formated as an easily readable string", "examples": [ "189M" ] }, "total_funding_usd": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Total Funding Usd", "description": "Funding of the company in USD", "examples": [ 500000 ] }, "last_funding_round_date": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Last Funding Round Date", "description": "Date of the last funding round of the company", "examples": [ "2020-01-01" ] }, "last_funding_round_amount_readable": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Funding Round Amount Readable", "description": "Amount of the last funding round of the company, formated as an easily readable string", "examples": [ "$1.2M" ] }, "employee_count_range": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Employee Count Range", "description": "Number range of employees at the company", "examples": [ "1001-5000" ] }, "long_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Long Description", "description": "Short description of the company", "examples": [ "Google is a California-based multinational technology company that offers internet-related services such as a search engine, online advertising and cloud computing." ] }, "seo_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Seo Description", "description": "SEO description of the company, extracted from their website" }, "city": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "City", "description": "City of the company's HQ", "examples": [ "Mountain View" ] }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Postal Code", "description": "Postal code of the company's HQ", "examples": [ "28040" ] }, "company_keywords": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Company Keywords", "description": "Company keywords, related to what the company does" }, "alexa_ranking": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Alexa Ranking", "description": "Alexa ranking", "examples": [ 1 ] }, "publicly_traded_symbol": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Publicly Traded Symbol", "examples": [ "GOOG" ] }, "publicly_traded_exchange": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Publicly Traded Exchange", "examples": [ "NASDAQ" ] }, "investors": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Investors", "description": "List of investors in this company" }, "funding_stage": { "anyOf": [ { "$ref": "#/components/schemas/FundingStage", "_circular": true }, { "type": "null" } ], "description": "Latest funding stage of the company" }, "has_blurred_data": { "type": "boolean", "title": "Has Blurred Data", "description": "Whether the returned object has company identifiable data blurred or not", "default": false }, "technology_slugs": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Technology Slugs", "description": "slugs of the technologies found to be used by the company", "examples": [ [ "kafka", "elasticsearch" ] ] }, "technology_names": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Technology Names", "description": "Names of the technologies found to be used by the company", "deprecated": true, "examples": [ [ "Kafka", "Elasticsearch" ] ] }, "technologies_found": { "items": { "properties": { "technology": { "properties": { "name": { "type": "string", "title": "Name", "examples": [ "PostgreSQL" ] }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category", "description": "Category of the technology", "examples": [ "Relational Database" ] }, "slug": { "type": "string", "title": "Slug", "description": "Slug of the technology", "examples": [ "kafka", "snowflake" ] }, "category_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category Slug", "description": "Slug of the category of the technology", "examples": [ "message-queue" ] }, "parent_category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Category", "description": "Parent category of the technology", "examples": [ "Data Stores" ] }, "parent_category_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Category Slug", "description": "Slug of the parent category of the technology", "examples": [ "data-stores" ] }, "logo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logo", "description": "Logo of the technology" }, "logo_thumbnail": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logo Thumbnail", "description": "Thumbnail of the technology" } }, "type": "object", "required": [ "name", "slug" ], "title": "KeywordExtended" }, "confidence": { "type": "string", "enum": [ "low", "medium", "high" ], "title": "Confidence", "description": "How confident we are that the company uses this technology" }, "jobs": { "type": "integer", "title": "Jobs", "description": "Number of jobs found mentioning this technology", "examples": [ 54 ] }, "jobs_last_7_days": { "type": "integer", "title": "Jobs Last 7 Days", "description": "Number of jobs from the given company mentioning this technology in the last 7 days" }, "jobs_last_30_days": { "type": "integer", "title": "Jobs Last 30 Days", "description": "Number of jobs from the given company mentioning this technology in the last 30 days" }, "jobs_last_180_days": { "type": "integer", "title": "Jobs Last 180 Days", "description": "Number of jobs from the given company mentioning this technology in the last 180 days" }, "first_date_found": { "type": "string", "format": "date", "title": "First Date Found", "description": "Date when the keyword was first mentioned by the company in a job post" }, "last_date_found": { "type": "string", "format": "date", "title": "Last Date Found", "description": "Date when the keyword was last mentioned by the company in a job post" }, "rank_within_category": { "type": "integer", "title": "Rank Within Category", "description": "Measures how common this technology is among the company's jobs, compared to other technologies in the same category. The most mentioned technology in its category will have a rank of 1. This helps you infer which is the technology the company is most likely to be using, when they mention several technologies that belong to the same category." }, "relative_occurrence_within_category": { "type": "number", "title": "Relative Occurrence Within Category", "description": "Measures the relative occurance of this technology among other technologies in the same category, in jobs by this company. If there are 10 jobs where a company mentions 3 categories, and they appear in 8, 3 and 2 jobs respectively, its relative occurrences will be 0.8, 0.3 and 0.2. This helps you infer how likely it is that the company is using this technology, when they mention several technologies that belong to the same category." }, "theirstack_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Theirstack Score", "description": "[DEPRECATED] This is a score we assign to every technology used by each company to assess how likely it is that they're using it, combining the value of `jobs` and `relative_occurrence_within_category`. The higher this value is, the higher the chances that the company uses this technology. Values lower than 1 mean it's not very likely they use it. Then, the higher the value of theirstack_score, the more likely it is that they actually use it.", "deprecated": true }, "company_name": { "type": "string", "title": "Company Name", "description": "Company name. This field is deprecated, please don't use it", "deprecated": true, "examples": [ "Google" ] } }, "type": "object", "required": [ "technology", "confidence", "jobs", "jobs_last_7_days", "jobs_last_30_days", "jobs_last_180_days", "first_date_found", "last_date_found", "rank_within_category", "relative_occurrence_within_category", "company_name" ], "title": "KeywordFound" }, "type": "array", "title": "Technologies Found", "description": "List of technologies found to be used by the company, relevant to the current search", "default": [] }, "jobs_found": { "items": { "properties": { "id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Id", "description": "ID of the job", "examples": [ 1234 ] }, "job_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Title", "description": "Job title", "examples": [ "Senior Data Engineer" ] }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url", "description": "URL of the job post", "examples": [ "https://example.com/job/1234" ] }, "date_posted": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Date Posted", "description": "Date when the job was posted", "examples": [ "2021-01-01" ] }, "has_blurred_data": { "type": "boolean", "title": "Has Blurred Data", "description": "Whether the returned object has company identifiable data blurred or not", "default": false }, "company": { "type": "string", "title": "Company" } }, "type": "object", "required": [ "company" ], "title": "JobBaseOut" }, "type": "array", "title": "Jobs Found", "description": "List of the last 5 jobs posted by the company, relevant to the current search", "default": [] } }, "type": "object", "required": [ "id", "name" ], "title": "CompanyWithTechnologiesAndJobs" }, { "type": "null" } ], "title": "Payload" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" }, "response_status_code": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Response Status Code" }, "response_body": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Response Body" } }, "type": "object", "required": [ "id", "webhook_id", "triggered_at", "status", "created_at", "updated_at" ], "title": "WebhookEvent" }, "title": "Response Get Webhooks Events V0" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: List All Webhooks description: List all webhooks of your team. It won't return archived webhooks. url: https://theirstack.com/en/docs/api-reference/webhooks/get_webhooks_v0 --- ## OpenAPI Specification ```json { "path": "/v0/webhooks", "method": "GET", "tags": [ "Webhooks" ], "summary": "List All Webhooks", "description": "List all webhooks of your team. It won't return archived webhooks.", "operationId": "get_webhooks_v0", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "items": { "properties": { "url": { "type": "string", "maxLength": 2083, "minLength": 1, "format": "uri", "title": "Url", "description": "URL of the webhook", "examples": [ "https://example.com/webhook" ] }, "search_id": { "type": "integer", "title": "Search Id", "description": "ID of the search that the webhook is listening to.", "examples": [ 123 ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the webhook", "examples": [ "Webhook for new jobs" ] }, "listening_start_time": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Listening Start Time", "description": "Date when the webhook started listening for events. If listening_start_time is None, the webhook will listen to all events matching the search query regardless of when they occurred.", "examples": [ "2024-01-01T00:00:00" ] }, "trigger_once_per_company": { "type": "boolean", "title": "Trigger Once Per Company", "description": "Only for webhook type ='job.new'. If true, Company A with 5 jobs → 1 event triggered. If false, Company A with 5 jobs → 5 events triggered", "default": false, "examples": [ true ] }, "id": { "type": "integer", "title": "Id" }, "user_id": { "type": "integer", "title": "User Id" }, "team_id": { "type": "integer", "title": "Team Id" }, "is_active": { "type": "boolean", "title": "Is Active" }, "is_archived": { "type": "boolean", "title": "Is Archived" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" }, "search_name": { "type": "string", "title": "Search Name" }, "event_type": { "type": "string", "enum": [ "job_new", "company_new" ], "title": "WebhookEventType" }, "scanning_frequency": { "type": "string", "title": "Scanning Frequency", "description": "Scanning frequency for the webhook", "default": "10m" } }, "type": "object", "required": [ "url", "search_id", "id", "user_id", "team_id", "is_active", "is_archived", "created_at", "updated_at", "search_name", "event_type" ], "title": "Webhook" }, "type": "array", "title": "Response Get Webhooks V0" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } } }, "security": [ { "Bearer": [] } ] } ``` --- title: Archive Webhook description: Archive a webhook url: https://theirstack.com/en/docs/api-reference/webhooks/patch_webhooks_archive_v0 --- ## OpenAPI Specification ```json { "path": "/v0/webhooks/{webhook_id}/archive", "method": "PATCH", "tags": [ "Webhooks" ], "summary": "Archive Webhook", "description": "Archive a webhook", "operationId": "patch_webhooks_archive_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "webhook_id", "in": "path", "required": true, "schema": { "type": "integer", "description": "ID of the webhook", "examples": [ 123 ], "title": "Webhook Id" }, "description": "ID of the webhook" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2083, "minLength": 1, "format": "uri", "title": "Url", "description": "URL of the webhook", "examples": [ "https://example.com/webhook" ] }, "search_id": { "type": "integer", "title": "Search Id", "description": "ID of the search that the webhook is listening to.", "examples": [ 123 ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the webhook", "examples": [ "Webhook for new jobs" ] }, "listening_start_time": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Listening Start Time", "description": "Date when the webhook started listening for events. If listening_start_time is None, the webhook will listen to all events matching the search query regardless of when they occurred.", "examples": [ "2024-01-01T00:00:00" ] }, "trigger_once_per_company": { "type": "boolean", "title": "Trigger Once Per Company", "description": "Only for webhook type ='job.new'. If true, Company A with 5 jobs → 1 event triggered. If false, Company A with 5 jobs → 5 events triggered", "default": false, "examples": [ true ] }, "id": { "type": "integer", "title": "Id" }, "user_id": { "type": "integer", "title": "User Id" }, "team_id": { "type": "integer", "title": "Team Id" }, "is_active": { "type": "boolean", "title": "Is Active" }, "is_archived": { "type": "boolean", "title": "Is Archived" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" }, "search_name": { "type": "string", "title": "Search Name" }, "event_type": { "type": "string", "enum": [ "job_new", "company_new" ], "title": "WebhookEventType" }, "scanning_frequency": { "type": "string", "title": "Scanning Frequency", "description": "Scanning frequency for the webhook", "default": "10m" } }, "type": "object", "required": [ "url", "search_id", "id", "user_id", "team_id", "is_active", "is_archived", "created_at", "updated_at", "search_name", "event_type" ], "title": "Webhook" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Update Webhook description: undefined url: https://theirstack.com/en/docs/api-reference/webhooks/patch_webhooks_by_id_v0 --- ## OpenAPI Specification ```json { "path": "/v0/webhooks/{webhook_id}", "method": "PATCH", "tags": [ "Webhooks" ], "summary": "Update Webhook", "operationId": "patch_webhooks_by_id_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "webhook_id", "in": "path", "required": true, "schema": { "type": "integer", "description": "ID of the webhook", "examples": [ 123 ], "title": "Webhook Id" }, "description": "ID of the webhook" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2083, "minLength": 1, "format": "uri", "title": "Url", "description": "URL of the webhook", "examples": [ "https://example.com/webhook" ] }, "search_id": { "type": "integer", "title": "Search Id", "description": "ID of the search that the webhook is listening to.", "examples": [ 123 ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the webhook", "examples": [ "Webhook for new jobs" ] }, "listening_start_time": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Listening Start Time", "description": "Date when the webhook started listening for events. If listening_start_time is None, the webhook will listen to all events matching the search query regardless of when they occurred.", "examples": [ "2024-01-01T00:00:00" ] }, "trigger_once_per_company": { "type": "boolean", "title": "Trigger Once Per Company", "description": "Only for webhook type ='job.new'. If true, Company A with 5 jobs → 1 event triggered. If false, Company A with 5 jobs → 5 events triggered", "default": false, "examples": [ true ] } }, "type": "object", "required": [ "url", "search_id" ], "title": "WebhookUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2083, "minLength": 1, "format": "uri", "title": "Url", "description": "URL of the webhook", "examples": [ "https://example.com/webhook" ] }, "search_id": { "type": "integer", "title": "Search Id", "description": "ID of the search that the webhook is listening to.", "examples": [ 123 ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the webhook", "examples": [ "Webhook for new jobs" ] }, "listening_start_time": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Listening Start Time", "description": "Date when the webhook started listening for events. If listening_start_time is None, the webhook will listen to all events matching the search query regardless of when they occurred.", "examples": [ "2024-01-01T00:00:00" ] }, "trigger_once_per_company": { "type": "boolean", "title": "Trigger Once Per Company", "description": "Only for webhook type ='job.new'. If true, Company A with 5 jobs → 1 event triggered. If false, Company A with 5 jobs → 5 events triggered", "default": false, "examples": [ true ] }, "id": { "type": "integer", "title": "Id" }, "user_id": { "type": "integer", "title": "User Id" }, "team_id": { "type": "integer", "title": "Team Id" }, "is_active": { "type": "boolean", "title": "Is Active" }, "is_archived": { "type": "boolean", "title": "Is Archived" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" }, "search_name": { "type": "string", "title": "Search Name" }, "event_type": { "type": "string", "enum": [ "job_new", "company_new" ], "title": "WebhookEventType" }, "scanning_frequency": { "type": "string", "title": "Scanning Frequency", "description": "Scanning frequency for the webhook", "default": "10m" } }, "type": "object", "required": [ "url", "search_id", "id", "user_id", "team_id", "is_active", "is_archived", "created_at", "updated_at", "search_name", "event_type" ], "title": "Webhook" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Enable/Disable A Webhook description: By disabling a webhook, it will stop listening to events. When you enable a webhook, it will process all the events that have not been processed yet since you disabled it. url: https://theirstack.com/en/docs/api-reference/webhooks/patch_webhooks_status_v0 --- ## OpenAPI Specification ```json { "path": "/v0/webhooks/{webhook_id}/status", "method": "PATCH", "tags": [ "Webhooks" ], "summary": "Enable/Disable A Webhook", "description": "By disabling a webhook, it will stop listening to events. When you enable a webhook, it will process all the events that have not been processed yet since you disabled it.", "operationId": "patch_webhooks_status_v0", "security": [ { "Bearer": [] } ], "parameters": [ { "name": "webhook_id", "in": "path", "required": true, "schema": { "type": "integer", "description": "ID of the webhook", "examples": [ 123 ], "title": "Webhook Id" }, "description": "ID of the webhook" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "properties": { "is_active": { "type": "boolean", "title": "Is Active" } }, "type": "object", "required": [ "is_active" ], "title": "WebhookStatusUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2083, "minLength": 1, "format": "uri", "title": "Url", "description": "URL of the webhook", "examples": [ "https://example.com/webhook" ] }, "search_id": { "type": "integer", "title": "Search Id", "description": "ID of the search that the webhook is listening to.", "examples": [ 123 ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the webhook", "examples": [ "Webhook for new jobs" ] }, "listening_start_time": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Listening Start Time", "description": "Date when the webhook started listening for events. If listening_start_time is None, the webhook will listen to all events matching the search query regardless of when they occurred.", "examples": [ "2024-01-01T00:00:00" ] }, "trigger_once_per_company": { "type": "boolean", "title": "Trigger Once Per Company", "description": "Only for webhook type ='job.new'. If true, Company A with 5 jobs → 1 event triggered. If false, Company A with 5 jobs → 5 events triggered", "default": false, "examples": [ true ] }, "id": { "type": "integer", "title": "Id" }, "user_id": { "type": "integer", "title": "User Id" }, "team_id": { "type": "integer", "title": "Team Id" }, "is_active": { "type": "boolean", "title": "Is Active" }, "is_archived": { "type": "boolean", "title": "Is Archived" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" }, "search_name": { "type": "string", "title": "Search Name" }, "event_type": { "type": "string", "enum": [ "job_new", "company_new" ], "title": "WebhookEventType" }, "scanning_frequency": { "type": "string", "title": "Scanning Frequency", "description": "Scanning frequency for the webhook", "default": "10m" } }, "type": "object", "required": [ "url", "search_id", "id", "user_id", "team_id", "is_active", "is_archived", "created_at", "updated_at", "search_name", "event_type" ], "title": "Webhook" } } } }, "400": { "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } }, "description": "Bad Request" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Payment Required" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } }, "description": "Internal Server Error" } } } ``` --- title: Retry Webhook Events description: Retry the webhook events. This endpoint is used to retry the webhook events if they failed. url: https://theirstack.com/en/docs/api-reference/webhooks/post_webhooks_events_retry_v0 --- ## OpenAPI Specification ```json { "path": "/v0/webhooks/events/retry", "method": "POST", "tags": [ "Webhooks" ], "summary": "Retry Webhook Events", "description": "Retry the webhook events. This endpoint is used to retry the webhook events if they failed.", "operationId": "post_webhooks_events_retry_v0", "requestBody": { "content": { "application/json": { "schema": { "properties": { "webhook_event_ids": { "items": { "type": "integer" }, "type": "array", "title": "Webhook Event Ids", "description": "IDs of the webhook events to retry." } }, "type": "object", "required": [ "webhook_event_ids" ], "title": "WebhookEventRetryRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } } }, "security": [ { "Bearer": [] } ] } ``` --- title: Test Webhook Url description: This endpoint is used to test the webhook before creating it. It will send a test event to the webhook URL. url: https://theirstack.com/en/docs/api-reference/webhooks/post_webhooks_test_v0 --- ## OpenAPI Specification ```json { "path": "/v0/webhooks/test", "method": "POST", "tags": [ "Webhooks" ], "summary": "Test Webhook Url", "description": "This endpoint is used to test the webhook before creating it. It will send a test event to the webhook URL.", "operationId": "post_webhooks_test_v0", "requestBody": { "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2083, "minLength": 1, "format": "uri", "title": "Url" }, "event_type": { "type": "string", "enum": [ "job_new", "company_new" ], "title": "WebhookEventType" } }, "type": "object", "required": [ "url", "event_type" ], "title": "WebhookTest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "status": { "type": "integer", "title": "Status" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Message" } }, "type": "object", "required": [ "status" ], "title": "WebhookTestResponse" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } } }, "security": [ { "Bearer": [] } ] } ``` --- title: Create New Webhook description: Create a new webhook to listen to events from a saved search url: https://theirstack.com/en/docs/api-reference/webhooks/post_webhooks_v0 --- ## OpenAPI Specification ```json { "path": "/v0/webhooks", "method": "POST", "tags": [ "Webhooks" ], "summary": "Create New Webhook", "description": "Create a new webhook to listen to events from a saved search", "operationId": "post_webhooks_v0", "requestBody": { "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2083, "minLength": 1, "format": "uri", "title": "Url", "description": "URL of the webhook", "examples": [ "https://example.com/webhook" ] }, "search_id": { "type": "integer", "title": "Search Id", "description": "ID of the search that the webhook is listening to.", "examples": [ 123 ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the webhook", "examples": [ "Webhook for new jobs" ] }, "listening_start_time": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Listening Start Time", "description": "Date when the webhook started listening for events. If listening_start_time is None, the webhook will listen to all events matching the search query regardless of when they occurred.", "examples": [ "2024-01-01T00:00:00" ] }, "trigger_once_per_company": { "type": "boolean", "title": "Trigger Once Per Company", "description": "Only for webhook type ='job.new'. If true, Company A with 5 jobs → 1 event triggered. If false, Company A with 5 jobs → 5 events triggered", "default": false, "examples": [ true ] } }, "type": "object", "required": [ "url", "search_id" ], "title": "WebhookCreate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "properties": { "url": { "type": "string", "maxLength": 2083, "minLength": 1, "format": "uri", "title": "Url", "description": "URL of the webhook", "examples": [ "https://example.com/webhook" ] }, "search_id": { "type": "integer", "title": "Search Id", "description": "ID of the search that the webhook is listening to.", "examples": [ 123 ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "Description of the webhook", "examples": [ "Webhook for new jobs" ] }, "listening_start_time": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Listening Start Time", "description": "Date when the webhook started listening for events. If listening_start_time is None, the webhook will listen to all events matching the search query regardless of when they occurred.", "examples": [ "2024-01-01T00:00:00" ] }, "trigger_once_per_company": { "type": "boolean", "title": "Trigger Once Per Company", "description": "Only for webhook type ='job.new'. If true, Company A with 5 jobs → 1 event triggered. If false, Company A with 5 jobs → 5 events triggered", "default": false, "examples": [ true ] }, "id": { "type": "integer", "title": "Id" }, "user_id": { "type": "integer", "title": "User Id" }, "team_id": { "type": "integer", "title": "Team Id" }, "is_active": { "type": "boolean", "title": "Is Active" }, "is_archived": { "type": "boolean", "title": "Is Archived" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "updated_at": { "type": "string", "format": "date-time", "title": "Updated At" }, "search_name": { "type": "string", "title": "Search Name" }, "event_type": { "type": "string", "enum": [ "job_new", "company_new" ], "title": "WebhookEventType" }, "scanning_frequency": { "type": "string", "title": "Scanning Frequency", "description": "Scanning frequency for the webhook", "default": "10m" } }, "type": "object", "required": [ "url", "search_id", "id", "user_id", "team_id", "is_active", "is_archived", "created_at", "updated_at", "search_name", "event_type" ], "title": "Webhook" } } } }, "400": { "description": "Bad Request", "content": { "application/json": { "schema": { "properties": { "request_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Request Id", "description": "The request id. This is useful to contact us to help you debug the issue. The request_id won't be present in all errors.", "examples": [ null ] }, "error": { "properties": { "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code", "description": "The error code. Eg: `E-001`, `E-002`, `E-003`, `E-004`, `E-005`, `E-006`, `E-007`, `E-008`, `E-009`, `E-010`, `E-011`, `E-012`, `E-013`, `E-014`, `E-015`, `E-016`", "examples": [ "E-001", "E-002", "E-003", "E-004", "E-005" ] }, "title": { "type": "string", "title": "Title", "description": "The error title.", "examples": [ "Not allowed exception", "Invalid re2 expression exception", "Invalid country code exception", "Connection reset by peer exception", "Too many requests exception", "Internal server error", "Validation error", "Timeout error" ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description", "description": "The error description" } }, "type": "object", "required": [ "title" ], "title": "Error" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" } } } }, "402": { "description": "Payment Required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse", "_circular": true } } } } }, "security": [ { "Bearer": [] } ] } ``` --- title: Find people description: Finding email and phone number data with tools TheirStack integrates with url: https://theirstack.com/en/docs/app/contact-data/find-people --- TheirStack integrates natively with some of the bigger contact data providers, so finding emails and phone numbers from people working at the companies you can see on TheirStack is just a couple of clicks away. Currently, we have integrations with Apollo, ContactOut, and LinkedIn (Free, Recruiter and Sales Navigator). Read along to learn more. Select companies to find people from [#select-companies-to-find-people-from] To find people with some of our 3rd-party integrations, select first on TheirStack the companies you want to find people from. Whether you are on a job or a company search, you can select companies individually (by clicking on the checkboxes at the left side of the table) or in bulk, selecting hundreds of thousands of companies at once. After having selected some companies, the three action buttons on top of the table will become clickable. When if you click on Find people you'll see all the platforms we integrate with. Find people Default roles that are looked for [#default-roles-that-are-looked-for] When you click on any of the links to any of our integrations, a new tab will open filtering people by company on the tool you've clicked. By default, we also look only for some roles within those companies that are the typical decision-makers you'd want to reach, but this can vary by company size, market, etc, so you may want to change that. Go to [https://app.theirstack.com/settings/integrations](https://app.theirstack.com/settings/integrations) to see the roles we look for by default: If you always look for the same roles, if you change them here they will apply every time you use any of our integrations to always look for the same people. Default job titles Contact data providers [#contact-data-providers] Apollo.io [#apolloio] Apollo provides emails and phone numbers for hundreds of millions of people from millions of companies worldwide. If you don't have an account, to use our integration you'll have to create one first. Click on On Apollo and a new Apollo.io tab will open in your browser with the companies field pre-filled with the companies returned by TheirStack in the previous step Apollo.io Then, add the job title of the people in those companies you want to reach out to. For example, CTOs, in the Job Title section: Apollo.io Finally, select all the contacts you want, and then click on Save to get their contact data. When you do that, a popup like this will appear where you can choose what to do with those contacts: get their phone numbers, export them as CSV, add them to a sequence on Apollo, etc… Check out this guide from Apollo itself on how to export contacts in their platform. ContactOut [#contactout] ContactOut is another powerful tool to find email and phone numbers. To use it, select it from the dropdown menu you get when clicking on Find people You'll see something like this: Highlighted in the picture, you'll see the areas of the screen where you can: Change the roles of the ICPs you're looking for Select one record at a time or all at once Export data Access the email or phone number of a specific person ContactOut LinkedIn Free [#linkedin-free] Any free LinkedIn account lets you search for people and filter by role and company. To use this, first select some companies and then click on Find People -> LinkedIn. You'll see the companies have already been pre-filled for you. LinkedIn Free To filter by roles, click on Keywords -> Title and edit the default roles we pre-fill for you. LinkedIn Free LinkedIn Recruiter [#linkedin-recruiter] The same process works for LinkedIn Recruiter. You'll need a paid account for this to work, and the process is the same. Select companies and then click on Find people -> LinkedIn Recruiter. We'll prefill the companies and the roles. LinkedIn Sales Navigator [#linkedin-sales-navigator] Last, TheirStack also has a native integration with LinkedIn Sales Navigator. To use it, select some companies and then click on Find people -> LinkedIn Sales Navigator. You'll see something like this: As you see, we also pre-fill the companies with the companies found before on TheirStack and the titles with the defaults. Change the titles manually here, or check out the section of this post "Default roles that are looked for" to set the same roles for all the integrations. LinkedIn Sales Navigator --- title: Hiring Manager description: TheirStack provides the name, role and LinkedIn URL for the people in the hiring team for many jobs. Available via UI and API url: https://theirstack.com/en/docs/app/contact-data/hiring-manager --- For some markets, roles, and job boards, TheirStack is able to get the profile of the person that is posting the position. Hiring manager LinkedIn In this example, LinkedIn shows you who this person is. We collect this data and make it available for many job posts: Hiring manager TheirStack Fields that we have [#fields-that-we-have] We collect the following fields for each the hiring team of each job: * Name * Role * LinkedIn URL And this is available via UI and API. Note that in many cases this is just the recruiter that has posted the position and not the future manager of the hired person in the company. We do have that data in some cases as well - if you're interested, check this out. Seeing only jobs where the hiring manager is known [#seeing-only-jobs-where-the-hiring-manager-is-known] To do this, set the filter Has hiring manager -> Yes in the Job Search view on app.theirstack.com Has hiring manager filter --- title: Contact data description: Discover how TheirStack can assist you in obtaining personal contact data through our leading data partners or our hiring manager details url: https://theirstack.com/en/docs/app/contact-data --- We have direct integrations with top-tier third-party contact data providers such as Apollo.io, ContactOut, and LinkedIn [see this guide for more information](/en/docs/app/contact-data/find-people). Additionally, we offer [hiring manager information for applicable jobs](/en/docs/app/contact-data/hiring-manager), including the recruiter's name, position, and LinkedIn profile. However, we do not supply contact data directly for several reasons: * Rather than attempting to cover multiple areas, we focus on excelling in one—helping you identify companies with strong purchasing intent. As a small company, we must choose our priorities wisely. * Collecting and distributing personal contact data may not comply with GDPR regulations, despite being a common practice among many contact data providers. --- title: Excluding recruiting agencies description: Learn which filters can help you exclude jobs from recruiting agencies or consulting firms. url: https://theirstack.com/en/docs/app/job-search/excluding-recruiting-agencies --- If you’re a recruiting agency, it doesn’t make sense that you sell your services to other recruiting agencies. So you’d want to find only jobs from companies that aren’t recruiting agencies, or generate reports of companies that aren’t recruiting agencies . This article shows how to do it with TheirStack. Excluding by "Company type" [#excluding-by-company-type] In the job search page, you will find a filter called "Company Type". It will let you search for jobs from direct employers or recruiting agencies. Company Type filter A note on accuracy [#a-note-on-accuracy] Every classification task is a tradeoff between accuracy and precision. This is, maximizing the rate of true positives (% companies that we classify as recruiting agencies) while minimizing the rate of false negatives (% of companies that we classify as not recruiting agencies, but actually are). We preferred to err on the side of caution, and try that all of the companies we classify as recruiting agencies actually are. This means some of them are left out, and will be classified as direct employers when they are not. When you find some misclassified companies, contact us ([xoel@theirstack.com](mailto:xoel@theirstack.com)) and we’ll fix that right away. And to address it yourself, check out the next section. Refining results [#refining-results] As said in the previous section, there will be cases when recruiting companies are classified as direct employers. To reduce the times when this happens, you can add some filters Excluding by "Industry" [#excluding-by-industry] For a large percentage of companies, we have the industry they report they belong to. You can use the Exclude companies filter in the Job Search or in the Technology Details views. We classified all companies under industries that contain staffing and outsourcing as recruiting companies. But many companies in the Human Resources industry will be recruiting companies. If you exclude that industry, you’ll exclude those companies as well (you’ll exclude also some companies that may not be recruiting agencies) Exclude companies filter Excluding by keywords in "Company Description" [#excluding-by-keywords-in-company-description] If you only exclude companies by industry, you may still get some false positives: companies that are actually recruiting companies but label themselves as “Internet” or “Information Technology & Services”. However, for most companies we have a Company Description field (extracted from their websites, LinkedIn profile and other sources) Company description field And you can filter results by words or phrases present in the company description: Exclude Company Description Patterns filter Look for the Exclude Company Description Patterns filter. This field is case-insensitive. ``` consulting services outsourcing recruiting recruitment headhunting Tic A medida consultora tecnologías de la información Clientes finales Integradoras el mejor talento 360 transformación digital digital transformation solutions consultants talent people personas digital services Integradas Soluciones digitales cambio digital servicios TI consultores servicios de it servicios de ti consultoria consultoría ``` Excluding by "Company Name" [#excluding-by-company-name] However, we know this all isn’t bulletproof and even if you do all of this, it’s likely that you still get some false positives, and results from companies you wouldn’t want. So if you have a list of companies you don’t want to get results from, you can also pass it and TheirStack won’t return any results from companies that contain any of the strings you pass (so if you pass Apple, you also won’t get jobs from Apple, Inc.) Look for the Exclude company names (substring match) field in the Companies section, on the right side. You could even ask ChatGPT for a list like this ``` Robert Half Kelly Services Manpower Adecco Randstad Allegis Kforce The Execu|Search Insight Global Collabera Aerotek Volt Workforce Solutions Apex Systems TEKsystems Yoh Services HireTalent Infinity Consulting Solutions Nelson Staffing Accountemps Creative Circle Express Employment Professionals Artech Information Systems Beacon Hill Staffing ProLink Staffing Addison Group Signature Consultants ASGN The Select Group TalentBurst TrueBlue MATRIX Resources Collabera Bartech Staffing Vaco Global Employment Solutions Mastech Digital The Judge Group Aquent Oxford Global Resources Tech USA IDR Motion Recruitment Partners ICONMA Swoon Advantage Resourcing Beacon Hill Technologies Mondo Insight Enterprises ITAC Solutions Open Systems Technologies ``` Paste it, add your own list, re-run the search, and you’ll be good to go. --- title: Job Search description: How to find companies hiring by filtering through millions of listings worldwide. Discover how to refine your search using over 20 job and company filters, making it easier to target your ideal opportunities. url: https://theirstack.com/en/docs/app/job-search --- TheirStack is a sales tool designed to discover purchase intent signals through job postings. It helps SaaS companies, recruiting agencies, and consulting firms find their next customer by analyzing 40+ million job listings across 100+ countries. We monitor more than 16 different sources, with a major proportion being derived directly from job boards and company career pages. By finding companies hiring for certain positions and mentioning certain keywords or technologies, you can identify companies with the problems that your company solves. Open a new job search [#open-a-new-job-search] Go to your [app](https://app.theirstack.com) and click on "Search Jobs" New job search You'll be taken to a screen like this. By default, the search that will run with the selected filters will return jobs found in the last 15 days in the country where you are. We'll explore some more useful filters below. To run the search, click on the big green button in the top right part of your screen that says Search. After a couple of seconds, you should be able to see the last jobs posted for that specific search. Job search results Job preview [#job-preview] We store all historical information, so even if a job is expired in the job board where we found it, it will always be accessible via TheirStack. To see the details about a job, click on the job title of any of the jobs found that appeared. For example: Job modal Company preview [#company-preview] Similarly to how you see the details about a job, when you click on a company name a new modal will open displaying as much information we have about a company. In it, you can see data like their headcount, revenue per year, funding data and more in the Overview tab. Company modal Company technologies [#company-technologies] If you click on the Technologies tab, you will see a list of the companies we found and some details about each one, like the number of jobs where the company mentioned, when was the first and last time they mentioned it and more. Company modal technology tab Company jobs [#company-jobs] By clicking on the Jobs tab, a new tab will open in your windows where you'll see all the jobs posted by the company you were browsing before, all-time. Available filters [#available-filters] We let you filter jobs by attributes and company attributes. To see all attributes you can filter by, click on the Add filter button in the top left corner of your screen. Available filters You can type the name of an attribute and if it's possible to filter by it, the list of filters will show only the ones related to what you've typed. Note that for some attributes, more than one operator is allowed. This lets you, for example, include and exclude data related to the same attribute. Job filters [#job-filters] Filter jobs by job title [#filter-jobs-by-job-title] The most basic kind of filter you could make is filtering by job title. By default, the filter operator that is selected when you filter by job title is the "contains any" filter. You can pass multiple job titles and our search engine will return jobs that match any of the job titles passed. To pass multiple job titles, pass each one of them in a separate line (don't use commas to separate job titles!) Job title filter 💡 Useful resource: How to get tech jobs only Exclude jobs by title [#exclude-jobs-by-title] If you don't want to get jobs that include certain keywords, select the is not any of filter. Exclude jobs by title Filter by job description [#filter-by-job-description] Using the Job description filter, you can get jobs that match any of the words (or even regular expressions) that you pass. You can pass more than one, separated by line break. And you can also get jobs that don't match any of the words or patterns you pass if you select the filter type to be "not matches". Job description filter Filter jobs by technology [#filter-jobs-by-technology] If you want to find jobs by technology, you have 2 options: * Pass the technology name in the Job title filter. * Use the Job technology filter. Using the Job technology filter will look for jobs mentioning that technology in the description and will return more results than if you use the Job title filter. But if you use the Job title filter you'll get jobs where that technology is very relevant. Filter jobs by country [#filter-jobs-by-country] To filter jobs by the country where they were posted, you can use the Job country filter. You can pass multiple countries here. If you select the is not any of operator, you can also exclude jobs from certain countries. Company filters [#company-filters] Filter jobs by company size [#filter-jobs-by-company-size] If you select the Company employees filter, you'll be able to get jobs from companies of only a specific size. Filter jobs by industry [#filter-jobs-by-industry] The Company industry lets you get jobs from companies that belong to a certain industry. If you select the is not any of operator, you can also exclude jobs from companies from certain industries. Filter jobs by company name [#filter-jobs-by-company-name] If you want to include or exclude jobs from certain companies, this is also possible. Type "company" in the filter list and select Company name. Depending on the operator you choose, you can match company names totally or partially. This could be useful if you want to manually exclude jobs from your competitors, for example. Filter jobs by company description [#filter-jobs-by-company-description] You can pass a list of words to include or exclude jobs from companies that have these words in their descriptions. To do so, select the Company description filter and choose one of the operators. Filter jobs by whether the company is the final employer or not [#filter-jobs-by-whether-the-company-is-the-final-employer-or-not] Most times, recruiting and staffing companies post jobs on behalf of others. Sometimes they set the industry right, but other times they don't, so if you just exclude jobs by industry you'll get some false positives. We have classified all companies into 2 kinds: direct employers and recruiting companies, considering their industry but also patterns in their names and in their company descriptions. To get jobs only from direct employers, choose the Company type filter and select Direct employer. 💡 Useful resource: [How to get jobs from recruiting agencies](/en/docs/app/job-search/excluding-recruiting-agencies) Columns visibility [#columns-visibility] You can hide columns that you don't need to see in the table. To do so, go to the right side of the table and click on the "Columns" button in the header of the table. Hide column Export data [#export-data] You can export jobs to a CSV, Excel file or to any external system through webhooks. Follow the steps below to export jobs: **Click on the "Export" button in the top right corner of your screen.** Export button **Select the number of jobs you want to export and the format** **Number of jobs**: * You can export only the current page, only jobs from revealed companies, all jobs or a custom number of jobs. * Each option will have on their right the cost of the operation in company credits. Example: **Format**: * You can export to a CSV, Excel file or to any external system through webhooks. Export Modal Next steps [#next-steps] * You can use the [Find people](/en/docs/app/contact-data/find-people) feature to find people working at the companies you're interested in. * You can use [webhooks](/en/docs/webhooks) to move the data to other systems: Airtable, Google Sheets, Hubspot, etc. Faqs [#faqs] Want to know how much your export will cost? Here's how to find out: 1. Start a [new search](https://app.theirstack.com/search/jobs/new) and set up your filters 2. Hit the "Export" button (you'll find it in the top right corner) 3. Pick how many jobs you'd like to export and choose your format 4. The cost appears right next to each option with a credits badge like this: 5. Head over to our [pricing page](https://www.theirstack.com/en/pricing) and choose a plan from the APP tab (Company credits) that covers what you need --- title: Filtering out non-tech jobs description: Learn which filters can help you get only tech jobs like software engineer, data analyst, DevOps, UX... url: https://theirstack.com/en/docs/app/job-search/tech-jobs-only --- When embarking on a job search in TheirStack, you might find yourself overwhelmed by the sheer variety of job titles and positions available. Here you have two options to get only tech jobs: Option 1. Filter by keywords in the "Job title" field [#option-1-filter-by-keywords-in-the-job-title-field] ```txt title="English keywords" IT Software Developer Data Backend Back-end DevOps Frontend Front-end Full-stack Fullstack QA Site Reliability SRE VP Engineering Sysadmin System admin Web development Mobile developer Mobile engineer QA Automation QA Engineer Quality Assurance Test Automation Software Engineer Software Developer Data Engineer Data Scientist Data Analyst Analytics Business Intelligence BI Machine Learning Engineer ML Engineer AI Engineer MLOps DataOps DevSecOps Platform Infrastructure Security Cybersecurity InfoSec Network Engineer Support Engineer Software Architect Solutions Architect Cloud Engineer Product Manager Product Owner CTO Technical Lead Tech Lead Head of Data IT Manager Project Manager CIO IT Director Analyst ETL ``` ```txt title="Technologies" Python JavaScript TypeScript Java C C++ C# Go Golang Rust Ruby PHP Swift Kotlin Objective-C Dart Scala SQL PostgreSQL MySQL SQLite MongoDB Redis Elasticsearch Kafka RabbitMQ GraphQL REST gRPC Node.js React React Native Next.js Vue Nuxt Angular Svelte Flutter Django FastAPI Flask Spring .NET Rails Laravel Express NestJS Kubernetes Docker Terraform Ansible AWS Azure GCP Cloudflare Linux Windows Airflow dbt Spark Databricks Snowflake BigQuery Redshift Tableau Power BI Looker Machine learning TensorFlow PyTorch Scikit-learn LLM Blockchain ``` ```txt title="Spanish" Ingeniero Datos Científico Datos Desarrollador Programador Redes Sistemas Analista IT ``` Option2. Filter by "Job technology" [#option2-filter-by-job-technology] You can add all technologies in the following categories: * [Programming languages](https://theirstack.com/en/category/languages) * [Relational Databases](https://theirstack.com/en/category/big-data-analytics), [Big Data](https://theirstack.com/en/category/big-data-analytics) * [Frameworks](https://theirstack.com/en/category/application-frameworks) --- title: Email Alerts description: Learn how to set up daily and weekly notifications to get fresh job or company opportunities delivered straight to your inbox, so you never miss out on potential prospects again. url: https://theirstack.com/en/docs/app/saved-searches/email-alerts --- Would you like to set up email alerts for your job or company searches so new results pop up in your inbox weekly? Setting up email alerts [#setting-up-email-alerts] Follow these simple steps to start receiving email alerts for your saved searches: Navigate to your [Home](https://app.theirstack.com/home) page Find the search you want to monitor in the "Your saved searches" section Click the three dots menu next to your search and choose either "Enable daily alert" or "Enable weekly alert" from the dropdown Email Alerts Once you've enabled alerts, you'll automatically receive: * **Daily alerts**: Fresh job matches every morning * **Weekly alerts**: A summary of new opportunities every Monday morning Email example How to stop receiving email alerts [#how-to-stop-receiving-email-alerts] To stop receiving email alerts, you can click on the three dots menu next to your search and choose either "Disable alert" from the dropdown --- title: Company Data description: url: https://theirstack.com/en/docs/data/company --- Further reading [#further-reading] --- title: Statistics description: Learn how many companies are discovered each month, how is the distribution per industry, employee size, and headquarters country... url: https://theirstack.com/en/docs/data/company/statistics --- --- title: Data workflow description: Learn how we transform raw job postings into high-quality, normalized data through our 5-step workflow covering acquisition, extraction, deduplication, enrichment, and quality assurance url: https://theirstack.com/en/docs/data/job/data-workflow --- How it works [#how-it-works] When you use our API, App, or Datasets, you're accessing data directly from our database, ensuring you always have the most up-to-date information available. Instead of making live calls to sources for each request, we proactively handle critical steps like data extraction, normalization, company enrichment, and quality assurance. This process guarantees both high-quality data and fast response times. To guarantee the highest possible quality of data, we follow this process: Content acquisition [#content-acquisition] We continuously crawl different data sources, such as job boards, ATSs, and company websites. The frequency of our scrapers varies, with some running as often as every 10 minutes and others hourly, to ensure our data is always up-to-date. More details: * [Jobs from 312k different websites](/en/docs/data/job/sources) * [Data freshness and scraping frequency](/en/docs/data/job/freshness) Extraction & Normalization [#extraction--normalization] For every job we collect, we extract key entities including the job posting, company, and, when available, the hiring manager. We also identify and extract technologies mentioned in the job title, description, and URL, then index them to enable filtering by tech stack. To ensure data quality and consistency across the platform, we normalize all extracted fields. Additionally, media assets such as company logos are downloaded and stored in our own infrastructure, allowing you to access them reliably via stable URLs for use in your own applications. Job postings come in all shapes and sizes across the web. Some job boards use fancy HTML formatting with bold headers and bullet points, while others keep it simple with plain text. You'll often find random special characters, weird spacing, or formatting quirks that make the data hard to work with. We clean this up by converting everything into a consistent format. We strip away the messy formatting while keeping what's important—like bullet points, headers, and emphasis. Whether you're building a job search tool or analyzing hiring trends, you'll get clean, structured data that's ready to use right away. Here's what we do: * **Job descriptions** – Convert everything to clean Markdown format, removing HTML tags but keeping important formatting * **Job titles** – Clean up titles by removing special characters and extra spaces to make them uniform and searchable Here's a common problem: the same company gets labeled differently across platforms. A tech startup might be called "Software Development" on LinkedIn, "Technology" on Indeed, and "SaaS" on their own website. This makes it really hard to filter companies by industry or analyze hiring patterns. We solve this by creating smart connections between different industry terms. So when you search for "Software Development" companies, you'll also catch those labeled as "Technology" or "SaaS" elsewhere. This gives you complete coverage no matter how the original source categorized the company. Our industry normalization includes: * **Standardized categories** – All companies get mapped to consistent industry labels * **Multi-source validation** – We check industry data from multiple sources for accuracy * **Hierarchical organization** – Industries are organized into main categories and subcategories for flexible filtering, using the same standardized values as LinkedIn. You can explore our complete industry catalog through our [API catalog endpoint](/en/docs/api-reference/catalog/get_industries_v0). Location data is probably the most frustrating part of job posting aggregation. You'll see "San Francisco, CA" on one platform, "SF, California" on another, and "US-CA-San Francisco" on a third. Some sources use country codes, others use full names, and some throw in postal codes in unpredictable ways. This makes geographic analysis really difficult. We've built a location parsing system that works like a universal translator for addresses. It doesn't just standardize formats—it also adds missing geographic coordinates and validates addresses to create a complete location profile for every job posting. This turns scattered location fragments into precise, searchable geographic data. Our location system includes: * **City** – The specific city where the job is located * **State** – The full state name (e.g., "California") * **State Code** – The abbreviated state code (e.g., "CA") * **Country Code** – The standardized country code (e.g., "US") * **Address** – The complete street address when available * **Postal Code** – The ZIP code or postal code for the location * **Latitude** – The geographic latitude coordinate for precise mapping * **Longitude** – The geographic longitude coordinate for precise mapping Job deduplication [#job-deduplication] Most companies use an Applicant Tracking System (ATS) to manage their hiring process. ATSs help streamline the candidate lifecycle, power career pages listing open roles, and sync job postings with major job boards like LinkedIn and Indeed. When a company posts a job through an ATS, it's common for that listing to appear on multiple job boards simultaneously. As a result, a single position may end up with 3–5 different references across various platforms. Additionally, job boards often scrape and repost listings from each other, further increasing duplication. Job posting deduplication is a crucial step to avoid having the same job posted multiple times in our database. If you use our data as sales signal, you wont' trigger the same signal multiple times. If you use our data to build a job board, you wont' have the same job posted multiple times. We apply both algorithmic techniques and manual checks to eliminate duplicates effectively. Data Enrichment [#data-enrichment] Our job posting collection gives you a solid foundation, but we don't stop there. We enhance every piece of data through a comprehensive enrichment process that adds valuable context and verified extra details. This transformation turns basic job listings into actionable intelligence that helps you make better decisions and build more powerful applications. Each time we collect a job posting, we also extract all available company information. However, in most cases, this initial data is quite limited—usually just the company's name, logo, and domain. While useful as a starting point, this basic information isn't enough to deliver meaningful insights or enable advanced filtering. To unlock the full potential of our platform, we enrich these company records with a broader and deeper profile—a process we call company enrichment. This allows you to search, filter, and segment companies based on valuable attributes, helping you identify high-quality prospects faster and with greater precision. Our enrichment process adds the following data points to each company: * **Industry** – Understand the market in which the company operates. * **Company Size (Headcount)** – Target organizations based on their scale, from startups to large enterprises. * **Estimated Revenue** – Gauge the financial size of a company to prioritize outreach. * **Funding Details** – See how much capital the company has raised and from which investors. * **Headquarters Location** – Identify geographic focus areas for your go-to-market strategy. * **LinkedIn URL** – Access their LinkedIn profile for further context and contact discovery. * **Company domain** – Find the company's official website. * **Possible domains** – Find all the possible domains for the company. * **Company Description** – Gain a quick overview of the company's mission, products, or services. To ensure accuracy and broad coverage, we aggregate and validate this data from multiple trusted providers. While we strive for comprehensive enrichment, please note that coverage may vary depending on the availability of external data—some fields may not be available for every company. Salary data in job postings presents a unique challenge: it's scattered across different currencies, formats, and regions. A job posting from London might show £45,000, while one from New York shows $65,000, and another from Berlin shows €55,000. Without proper standardization, comparing these salaries becomes nearly impossible for global hiring teams and compensation analysts. Our salary enrichment system transforms this fragmented data into actionable insights. We automatically detect salary information in job postings, convert all amounts to USD using real-time exchange rates, and preserve the original currency data. This dual approach gives you the flexibility to analyze global compensation trends while maintaining local market context. Here's what our salary enrichment delivers: * **Multi-currency support** – Handle salaries in 50+ currencies with automatic USD conversion * **Dual filtering options** – Search by original currency or standardized USD amounts * **Live exchange rates** – Currency conversions reflect current market conditions when the job was posted * **Range preservation** – Capture both minimum and maximum salary when available We extract salary ranges in their original local currency and automatically convert them to USD using real-time exchange rates. Each job posting with salary information includes both minimum and maximum salary fields, enabling you to filter and compare compensation across different regions and currencies effectively. The original salary currency is also preserved so both types of filtering can be done. Quality Assurance [#quality-assurance] Multiple data analysts monitor and verify data on a daily basis to ensure the data is of the highest quality. --- title: Freshness description: Discover how we collect job data with multi-tiered scraping frequencies from 10 minutes to daily. url: https://theirstack.com/en/docs/data/job/freshness --- Real-Time Job Data Updates [#real-time-job-data-updates] At TheirStack, we maintain a sophisticated job scraping system that ensures you have access to the most current job postings. Our multi-tiered approach to data collection means you never miss out on relevant positions. Job Scraping Frequency [#job-scraping-frequency] We use different scraping frequencies based on the source and volume of job postings: * **Every 10 Minutes**: High-volume job boards and frequently updated company career pages * **Every Hour**: Medium-traffic job sources with regular updates * **Daily**: Smaller job boards and company websites with lower posting frequency This tiered approach ensures that within 24 hours, we capture approximately 90% of all new tech job postings across our monitored sources. Job Discovery Timeline [#job-discovery-timeline] The following visualization shows when we discover jobs posted on a specific date (April 24th): Tech job discovery timeline visualization As illustrated, while most jobs are discovered within the first 24 hours, our system continues to find additional positions over subsequent weeks. This means: * Initial job counts for the current day may appear lower than final numbers * Job discovery continues over time, increasing the total count * You'll see the most comprehensive data after about 2-3 days Understanding delays in job discovery [#understanding-delays-in-job-discovery] When analyzing our data, you'll notice that a small percentage of jobs are discovered (`discovered_at`) after the day when they were initially posted (`posted_at`). This delay is common and is influenced by various factors beyond our control. Discovery Timeline [#discovery-timeline] To illustrate this, let's examine jobs posted on a specific day (December 14th) and observe when they were discovered by us. Jobs posted on December 12th | Discovered At | Percentage of Jobs Discovered | | ------------- | ----------------------------- | | Same Day (0) | 73% | | Next Day (1) | 21% | | 2 Days Later | 3% | | 3 Days Later | 0.3% | | 4 Days Later | 0.2% | As shown, 73% of jobs are found on the same day they are posted. However, there is a significant number of jobs discovered days later. To understand this, it's important to know how we collect our data. Factors Contributing to Delays [#factors-contributing-to-delays] We scrape job boards, that at the same time scrape other job boards and career pages of companies. They also can get jobs posted directly by companies, or from companies’ ATS systems that sync with these job boards. While we scrape these job boards constantly, there are many reasons a job posted by a company at a certain date is not available on those job boards instantly, and therefore it’s not possible for us to discover it. To name a few: * **ATSs sync delay with job boards**: The ATS that a company uses lets them sync jobs with a major job board, but the recruiter can choose which jobs to push to that job board because they charge for it. They may not initially sync it and do it after a few days to try to get more candidates. But the integration may keep the original date when the job was posted first, and show that in the final job board, instead of the date when the job was pushed. In this case, there will be a gap of a few days. * **Job board scraping delay**: A job board scrapes company career pages periodically, running daily. If a company posts a job at 14h and the job board scraper visits it at 10h every day, that job won’t be available in the job board until the day after. For companies that post many positions, it makes sense for job boards to visit those career pages with a high frequency. But visiting every career page of every company in the world periodically has a cost, so for smaller companies that very ocasionally post jobs, doing it on a weekly basis could help those job boards save money. So imagine they visit one of these companies’ career site every Monday. If they post a job on Tuesday, they won’t visit it again until next Monday, so there will be a 6-day difference between `posted_at` and `discovered_at` * **Job board publishing delay**: If someone publishes a job directly on a job board we scrape, this job board may also let them set a custom `posted_at` that is days before the current date. But the job is not available at that job board until the very moment when that person publishes it there, and even if the reported `posted_at` is previous to that, that job wouldn’t have been discovered before because that person hadn’t published it in that job board yet. Why am I getting a job that was posted months ago as if it was posted recently? [#why-am-i-getting-a-job-that-was-posted-months-ago-as-if-it-was-posted-recently] You might see jobs with older original posting dates appearing in recent results. This happens because companies often repost the same job on platforms like LinkedIn or other job boards. Here's what's happening: When a company reposts a job, they're essentially re-advertising the same position. This is common when: * They're still hiring for the same role after filling a previous opening * They want to refresh visibility for an ongoing search * They're expanding the team and need multiple people for the same position The job URL on LinkedIn or other job boards stays the same, but the posting date updates to reflect when it was reposted. Since the company is actively promoting it (and often paying to boost visibility), we treat it as a current, active opportunity. So if you filter for jobs posted on a specific date, you'll see both: * Brand new job postings * Previously posted jobs that were reposted on that date, as long as the original posting date is not the last 30 days. If it is, we will discard it as we'll consider it a duplicate. More info on deduplication [here](/en/docs/data/job/data-workflow#job-deduplication). This ensures you don't miss out on legitimate opportunities that companies are actively trying to fill, even if the original posting was weeks or months earlier. --- title: Job Data description: Access millions of real-time job listings from 313k+ sources across 195 countries. Get comprehensive job market data with advanced filters, company insights, and lightning-fast API responses. url: https://theirstack.com/en/docs/data/job --- Job Data [#job-data] Get access to millions of job listings aggregated from multiple global sources, including major job boards like Indeed, Linkedin, Workable, Greenhouse, Lever, Infojobs, Otta, StartupJobs... offering a complete view of the job market across 195 countries. The best job data platform [#the-best-job-data-platform] TheirStack goes beyond simple scrapers, we're a sophisticated platform delivering the most precise and current job market information. Our systems continuously collect new job postings across the internet every minute, processing approximately 316k new positions daily. * **312k job data sources** including job boards, company websites, and applicant tracking systems. We excel at standardizing job information, eliminating duplicates between sources, and implementing thorough quality checks to maintain data accuracy and reliability. Data quality and freshness are at the core of what we do. See full [job data sources](/en/docs/data/job/sources) * **30+ advanced job and company filters** to precisely target your search needs. Beyond standard filters like job title, company, and location, we enable filtering by job description, hiring manager, and company details. Each job listing is enhanced with company information including revenue, industry, size, technology stack, and more. * **Fast and reliable API** With an average API response time of just 1.5 seconds. We serve enriched data directly from our database without real-time external calls, ensuring consistent, reliable responses that help you deliver excellent user experiences to your customers. Further reading [#further-reading] --- title: Sources description: Our platform aggregates job listings from over 313k different websites. Below you'll find a breakdown of our largest job data sources and their contributions. url: https://theirstack.com/en/docs/data/job/sources --- Job data sources [#job-data-sources] We collect job data from over 312k different websites across the web. All these sources are crawled using publicly available data. We scrape some websites directly, while others are accessed indirectly through job board aggregations. Below, you'll find a breakdown of our largest job data sources and their contributions. If you need the full list, contact us. FAQS: Frequently asked questions [#faqs-frequently-asked-questions] You can see whether we have jobs from a specific website by going to the [app](https://app.theirstack.com) and searching for jobs while filtering by `url_domain`. For example, [here's a search showing jobs from LinkedIn](https://app.theirstack.com/search/jobs/new?query=N4IgjgrgpgTgniAXKAlgOwMYBsIBMoD6ALgPZECGWBMUAzhFkbUgGaW1QA0IJM+MBAEYJEAbVD5aGJERjRuLFFCy4kIXOSKEADiVpbVAXwC63Xfqi4CmggFtyAD2sBzQhrjNEARgCs3CDBUuCT26AS8SKIgWOgA1pboAHQYISDGhtzkEKQEHOQwGAAWMnJQhkA). Companies use job boards to promote their jobs, and job boards constantly scrape each other to keep their catalog strong. That means the same role can appear under different sources, so not seeing a particular source doesn't necessarily mean we don't have the job. Before you request a new source, please: * **Make sure we don't already have jobs from this source** by following [the process mentioned above](#how-to-check-jobs-from-specific-website). * **Pick a few jobs and search for the company** in our [company lookup](/en/docs/app/company-lookup), review their latest jobs, and confirm the titles you're interested in aren't already there. * **Work out what type of source it is** — (1) a job board, (2) a generic job board, or (3) a company website — and estimate how many jobs it has in the last 30 days. * Contact our support team through our [app](https://app.theirstack.com). Find the "Contact support" button when you click on the `?` icon in the top left corner of the page, next to our logo. Example of good request email. Use this template and replace the placeholders with the actual information from your specific case. [#example-of-good-request-email-use-this-template-and-replace-the-placeholders-with-the-actual-information-from-your-specific-case] ``` I'd like to add [WebsiteName] (https://example.com) as a new source. It's a job board focused on _____. I've used the company lookup tool to find jobs from [WebsiteName] and these jobs from it are NOT present in TheirStack: - [link to job 1 on [WebsiteName]] - [link to job 2 on [WebsiteName]] - [link to job 3 on [WebsiteName]] - ... - [link to job N on [WebsiteName]] Out of the [Number of companies I checked], I found [Number of companies] that have jobs from [WebsiteName] and these jobs are not present in TheirStack. In total, I looked for [Number of of jobs]. Out of those, I found [Number of jobs] in TheirStack. I estimate this source has roughly [Number of jobs] new jobs per month. Thanks, ``` These days, roles usually originate in a company’s ATS and are then published across platforms like LinkedIn, Indeed, and Glassdoor. A single job can appear in multiple places almost instantly. We crawl many sources and store each job only once — the first time we find it. For example, if we discover a role on Greenhouse before it appears on LinkedIn, the job in TheirStack won’t list LinkedIn as its source, even if it’s also posted there. Because of this first-seen approach, filtering by a specific scraping source (e.g., `scraping_source = Indeed`) will only return jobs initially found on that source, which often reduces results and can be misleading. We recommend avoiding this `scraping_source` filter unless you're aware that you'd be missing jobs that we actually have if you use it. When you search for a job on Indeed or LinkedIn, you may see more results than on TheirStack. This is because Indeed uses broader keyword matching, while TheirStack prioritizes precision. The difference lies in how job searches are conducted on TheirStack versus platforms like LinkedIn, Indeed, or Glassdoor. Let's focus on Indeed as an example, though the same principles apply to other providers. Search methodology: Keyword matching [#search-methodology-keyword-matching] Job boards like Indeed use broader keyword matching: * **Synonyms and Related Jobs**: For example, when you search for "network engineer," Indeed may return jobs that loosely match those terms, even if they don't contain the exact keywords. * **Company Name Matching**: For example, when you search for "franchise", LinkedIn may return jobs where the company name contains the word 'franchise'. On TheirStack, we prioritize precision. Our job title filter is deterministic, meaning it only returns results with an exact match for the keywords you provide. This approach ensures greater accuracy in the search results. Indeed job search Search methodology: Date range [#search-methodology-date-range] Indeed and LinkedIn typically display jobs that have been posted or reposted within the last 30 days by default, whereas TheirStack does not automatically filter jobs based on their reposted date. How to Increase Results on TheirStack [#how-to-increase-results-on-theirstack] * **Add More Keywords**: Broaden your search terms to include additional relevant keywords (see Picture A). Job title lists * **Use Regex Patterns**: Leverage regular expressions for more flexible and advanced search queries (see Picture B). Regex patterns Upcoming Features [#upcoming-features] We're working on: (1) a new filter that incorporates a synonym dictionary, which will enhance your search capabilities; (2) a new filter that allows you to filter by reposted date. There are two common reasons: 1. Coverage and timing: If a company has just posted a role, there can be a short delay before we discover it. Also, while we scan many company sites, our coverage prioritizes major job boards like Indeed, LinkedIn, Workable, and Welcome to the Jungle. Jobs reposted to these portals are more likely to be picked up quickly. If a role only appears on the company website and isn’t syndicated to any job boards, we may not have it yet. 2. Deduplication: Companies often repost the same role multiple times over several weeks. We deduplicate aggressively to avoid listing the same job multiple times. If we find a job with the same title from the same company that was already posted within the last 30 days, we keep the earliest one and ignore later duplicates. This prevents clutter, avoids overcounting, and ensures customers aren't charged multiple credits for the same underlying job. --- title: Statistics description: Discover our job data statistics including monthly posting trends since 2021, distribution by country, source platform, and workplace types url: https://theirstack.com/en/docs/data/job/statistics --- Job Postings Evolution [#job-postings-evolution] Monthly job postings since 2021. Breakdowns [#breakdowns] Distribution of job postings by country, source platform, and workplace type --- title: Use cases description: Discover how businesses use job data for lead generation, market intelligence, competitor tracking, and platform growth across recruiting, consulting, and SaaS industries url: https://theirstack.com/en/docs/data/job/use-cases --- | Use case | Description | Guide | Who is for | Case study | | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Target companies with active job openings | Use fresh job postings as a real-time signal of hiring urgency, then prioritize outreach based on the roles, locations, and seniority levels a company is trying to fill. | [Targeting companies with active job openings](/en/docs/guides/how-to-outreach-on-autopilot-to-companies-actively-hiring) | Recruiting agencies, staffing firms, sales agencies | [6nomads](/en/blog/6nomads-leverages-theirstack-to-find-fast-growing-companies-with-big-hiring-needs)
[Microverse](/en/blog/microverser-uses-theirstack-to-find-companies-hiring-junior-engineers) | | Find companies struggling to fill roles | Track reposted roles, long-open vacancies, and spikes in similar job ads to spot teams that are under-resourced—then offer interim staffing, managed recruiting, or outsourcing to close the gap. | | Consulting firms, staffing partners, RPOs | | | Monitor past customers that are hiring again | Monitor job postings from current and past customers to spot reactivation moments, new needs, and upsell opportunities—then reach out while timing is right. | [Monitoring open jobs from current and past customers](/en/docs/guides/monitoring-open-jobs-from-current-and-past-customers) | Recruiting agencies, SaaS customer success & sales | | | Identify companies with problems your software solves | Spot companies hiring for manual, time-consuming tasks your product can automate, then reach out when the need is most urgent. | [How to identify companies with problems your software solves](/en/docs/guides/how-to-identify-companies-with-problems-your-software-solves) | B2B SaaS, agencies, consultancies | | | Spotting your competitors' next moves | Use hiring signals to see where competitors are expanding (locations, teams, initiatives) months before it’s visible publicly, so you can plan and act early. | [How to spot your competitors' next moves](/en/docs/guides/how-to-spot-your-competitors-next-moves) | Strategy & ops, sales leadership, market intel teams | | | Expand your job board with fresh listings | Backfill your job board with relevant listings to grow inventory, improve SEO, and keep users coming back. | [Backfilling a job board](/en/docs/guides/backfill-job-board) | Job boards, marketplaces, media sites | | | Match job seekers with relevant job opportunities | Send targeted job recommendations to students and clients using filters like location, role, and keywords. | | Academies, bootcamps, career services | | | Power sales intelligence platforms with job data & technographics | Add job-based intent signals and technographic enrichment into your product so users can build lists, enrich accounts, and trigger workflows from hiring and stack changes. | [Integration guide for sales intelligence software](/en/docs/guides/sales-software-integration-guide) | Sales intelligence platforms, GTM tools, data providers | | --- title: How we source tech stack data description: We infer technology usage from millions of jobs worldwide and give you some statistics on it. url: https://theirstack.com/en/docs/data/technographic/how-we-source-tech-stack-data --- Infering tech stack data from job postings [#infering-tech-stack-data-from-job-postings] We source our tech usage data from job postings. We gather job listings from millions of companies monthly by tracking company websites, job boards, and other hiring platforms. When a job mentions a specific technology it hints the company is using that technology. The mention of the technology could be in the: * **Title**: e.g. "Senior React Developer", "Java Developer", "Odoo Developer"... * **Description**: e.g. "It requires experience with Hubspot", "We use GraphQL to query our data", "You have at least 3 years of experience with React"... * **Job URL**: Jobs posted in a ATS have the domain of the ATS in the url. Eg: [https://join.com/companies/xxx/xxx](https://join.com/companies/xxx/xxx), [https://jobs.workable.com/view/xxx](https://jobs.workable.com/view/xxx)... Measuring the likelihood of technology usage [#measuring-the-likelihood-of-technology-usage] Our **Confidence Score** (low, medium, high) helps us estimate how likely it is that a company actually uses this technology. It's calculated based on * the number of mentions * the frequency of the mentions relative to similar technologies in the category. If a company mentions 40 times Hubspot and 4 times Pipedrive, we consider it more likely they use Hubspot. * where this mention is found. We give more weight to mentions in the title or in the url. * the date of the mentions. We give more weight to the most recent mentions. Tracing technology signals back to evidence [#tracing-technology-signals-back-to-evidence] We're obsessed with transparency and giving you access to the evidence that led us to identify a company's technology usage. That's why everywhere we show a technology signal, we display all the information we have about that signal, allowing you to trace it back to its original source. In the app [#in-the-app] When you're in a [company search](/en/docs/app/company-search) filtering by technology or in the [technology tab for a company](/en/docs/app/company-lookup#technology-tab), we show cards highlighting the technologies they use. These aren't just simple tags – each card contains a complete audit trail of how we detected that technology usage. Technology confidence card If you hover on the technology card, you can see some details on the relationship between that company and that technology: * **Category** this technology belongs to * **Confidence score (high, medium, low)** - see the full explanation [here](#measuring-the-likelihood-of-technology-usage) * **First date found** - when a job by the company mentioned the technology for the first time * **Last date found** - when a job by the company mentioned the technology for the last time * **Rel. occurrence** - number of mentions of this technology compared to the total mentions of all the technologies from the same category. See the full list of categories here and browser the technologies we track here. * **N. jobs mentioned** - number of jobs mentioning this technology, with link to those jobs. By clicking on `N.jobs mentioned`, you'll be taken to a Job Search view showing the jobs from that company where the technology was found. Job search view Through the API [#through-the-api] Through our [Technographics endpoint](/en/docs/api-reference/companies/technographics_v1) and [Company Search endpoint](/en/docs/api-reference/companies/search_companies_v1), you'll get access to the same detailed technology information that's available in our app. Technographics api FAQs [#faqs] Our data comes from job postings. If a company doesn't mention a specific technology in their job ads, doesn't have open positions, or the technology isn't relevant to their hiring needs, it won't appear in our results. For some roles or categories, the actual technology used by the person hired may not be specified in the job description, or it might not be relevant. As a result, even if many companies use a certain technology, they may not show up in our database unless it's explicitly mentioned in their job postings. If you're seeing fewer companies than expected, it's likely because of how companies describe their needs in job ads, not necessarily a reflection of the true adoption rate of that technology. In any case, and because you can make unlimited searches without consuming credits unless you reveal data, you can always see the number of companies that would be returned by any given search. The short answer is yes — low and medium confidence technologies still come from clear evidence. Some companies don't post many jobs, so our confidence that they use a given technology will naturally be lower than for companies with lots of signals. If you're doing outbound and prefer to minimize false positives, and you don't target startups or smaller companies with fewer jobs, stick to **medium and high** confidence signals. Otherwise, we recommend using **all** confidence levels. --- title: Technographic Data description: Discover TheirStack's comprehensive technographic database with 32k technologies mapped across 10M companies worldwide. Access real-time tech stack insights derived from millions of job postings with confidence scoring and complete data transparency. url: https://theirstack.com/en/docs/data/technographic --- We infer technology usage from millions of job postings worldwide.Our technographic data stands out for several key reasons: * **Largest Technology Catalog**. Our catalog includes over 32k technologies spanning [programming languages](/en/category/languages), [frameworks](/en/category/frameworks), [databases](/en/category/databases), [ERPs](/en/category/enterprise-resource-planning-erp), [CRMs](/en/category/crm-platforms)... * **Global Company Coverage**. We've mapped technology usage across 10M companies worldwide, from Fortune 500 giants to fast-growing startups. Our comprehensive database spans every continent and industry, delivering 47M technology-to-company insights by analyzing real job posting data to understand what tools and platforms companies actually use. * **Data Accuracy and Confidence Scoring**. Each technology identification receives a [confidence score](/en/docs/data/technographic/how-we-source-tech-stack-data) calculated from multiple factors: frequency of technology mentions in job postings, recency of mentions, consistency across multiple job listings, and contextual analysis of how technologies are referenced in job requirements. * **Complete Data Transparency**. Every technology signal links back to [original job postings](/en/docs/data/technographic/how-we-source-tech-stack-data) where the technology was mentioned, including company details and posting dates. This allows for full verification and validation of our technology identification methodology. * **Real-Time Data Updates**. Our platform processes new technographic signals every minute as job postings are collected and analyzed. This ensures the dataset reflects current technology adoption patterns and hiring trends. See our [data freshness documentation](/en/docs/data/job/freshness) for detailed update frequencies. Further reading [#further-reading] --- title: Statistics description: Discover our technographics data statistics including total technologies, technographics signals, and companies tracked url: https://theirstack.com/en/docs/data/technographic/statistics --- Overview [#overview] --- title: Use cases description: Discover how teams use technographic data for account enrichment, targeting, competitive intel, and partner-based prospecting. url: https://theirstack.com/en/docs/data/technographic/use-cases --- | Use case | Description | Guide | Who is for | Case study | | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------- | | Target companies by the technologies they use | **Must-have technologies:** Find accounts using a “must-have” technology for your product so you can focus outbound on high-fit prospects (e.g., Prometheus → Grafana; ClickHouse → ClickHouse Cloud).

**Competitor customers:** Identify companies using competitor tools to build competitive lists, tailor positioning, and prioritize accounts that are already paying for a similar solution.

**Partners or integrations:** Target accounts using partner tools or integrations your product supports (e.g., accounting, payments, productivity tools) to increase conversion rates with a clear “works with your stack” message. | | B2B SaaS, sales teams, partnerships, product marketing | [Qonto](/en/blog/qonto-uses-theirstack-to-detect-companies-with-high-intents) | | Technology enrichment | Starting from a company, verify whether they use a specific technology (or category) to enrich accounts, segment leads, and personalize outreach. | [Adding a technology or job filter to your company search](/en/docs/guides/adding-technology-filter-to-search) | Sales teams, RevOps, data teams | [Stacker](/en/blog/stacker-uses-theirstack-for-account-based-marketing-and-lead-qualification) | --- title: New easy_apply field and filter for job postings description: New easy_apply field and filter for job applications url: https://theirstack.com/en/docs/product-updates/2025-01-10-easy-apply-filter --- New field and filter `easy_apply` in our [Jobs Search endpoint](/en/docs/api-reference/jobs/search_jobs_v1) and [Company Search endpoint](/en/docs/api-reference/companies/search_companies_v1). This field indicates whether the job application can be submitted directly through the job board (`easy_apply=True`) or requires redirecting to the company's website (`easy_apply=False`). Initially, this field will be populated for new jobs sourced from LinkedIn and Indeed. --- title: Job seniority filter + Shortened URL detection + Duplicate fix description: New job_seniority_or filter, shortened URL resolution, and duplicate job posting fixes url: https://theirstack.com/en/docs/product-updates/2025-01-14-job-seniority-shortened-urls --- **New filter `job_seniority_or` in our [Jobs Search endpoint](/en/docs/api-reference/jobs/search_jobs_v1)**. This filter allows you to search for jobs by seniority level. **Shortened URL detection for new jobs and companies**. Our system now identifies shortened URLs (e.g., `bit.ly`, `tinyurl`, etc.) for newly discovered jobs and companies. Instead of storing the shortened URL in our database, we now retrieve and save the original URL. **Fixed an issue causing duplicate job postings**. A job is considered a duplicate if the same company posts the same job title within a 30-day window. Previously, the system identified duplicates by checking job postings from the past 30 days, instead of 30 days before and after the posting date. As a result, jobs posted more than 30 days ago were not flagged as duplicates when found again by our system. **Fixed Make.com button**. The Make.com button, which lets you copy a Make scenario that calls our API, was not authenticating correctly. --- title: Clay export description: Export data to Clay.com via webhooks url: https://theirstack.com/en/docs/product-updates/2025-01-20-clay-export --- You can now export your list of jobs or companies to Clay through our Webhooks integration. Click on the "Export" button in the top right corner of the table and select Webhooks, paste the Webhook URL provided by Clay, and click on "Export". In a few seconds, you will see the data in your Clay table. --- title: Webhooks launch description: Initial launch of webhooks feature for real-time data integration url: https://theirstack.com/en/docs/product-updates/2025-01-27-webhooks-launch --- You can now subscribe to webhooks to get notified when new jobs are posted. Trigger actions in Make.com, Zapier, Clay or any other tool that supports webhooks when new jobs are posted. --- title: Webhook observability description: Webhook charts and event tables for monitoring webhook performance url: https://theirstack.com/en/docs/product-updates/2025-02-06-webhook-observability --- You can now view a chart displaying the number of webhooks sent and a table detailing each webhook event. --- title: API key refresh + Member removal + API observability description: API key refresh functionality, remove organization members, and API request observability url: https://theirstack.com/en/docs/product-updates/2025-02-12-api-key-refresh-member-removal --- * **Refresh your API key**. You can now refresh your API key through the [settings page](https://app.theirstack.com/settings/api-key). This is useful if you want to rotate your API key for security reasons. * **Remove members from your organization**. You can now remove members from your organization through the [settings page](https://app.theirstack.com/settings/organization). * **API Request Observability**. You can now see the status (200 OK, 402 Payment Required, 508 Request Timeout...) of your API request through the [requests page](https://app.theirstack.com/api). --- title: Invoices page + Billing alerts description: New invoices page with PDF downloads, webhook charts, and billing consumption alerts url: https://theirstack.com/en/docs/product-updates/2025-02-17-invoices-billing-alerts --- * **New [invoices page](https://app.theirstack.com/settings/invoices)**. You can now view all your invoices, see the consumption for each invoice, and download them in PDF format. * **Webhook executions chart on the [usage page](https://app.theirstack.com/settings/usage)**. You can now monitor the total number of webhook executions across all your webhooks. * **Billing consumption alerts**. You will now get an email notification when your billing consumption exceeds 70% or reaches 100%. --- title: Track company credits consumptio description: Track company credits consumption from the usage page url: https://theirstack.com/en/docs/product-updates/2025-02-18-company-credits-tracking --- You can now track the company credits consumption from the [usage page](https://app.theirstack.com/settings/usage). --- title: Datasets page description: New datasets page with samples and download options url: https://theirstack.com/en/docs/product-updates/2025-02-18-datasets-page --- New [datasets page](https://app.theirstack.com/datasets). You can now view all available datasets, and download a sample for each one. --- title: Job searches are now ~4x faster ⚡️ description: Job searches are now ~4x faster url: https://theirstack.com/en/docs/product-updates/2025-02-24-job-search-performance --- Performance improvements: * **Average response time**: 6.9s → 1.7s (⬇️ 75%) * **90th percentile response time**: 12.2s → 3s (⬇️ 75%) * **95th percentile response time**: 36.7s → 4.9s (⬇️ 87%) * **99th percentile response time**: 120s → 11s (⬇️ 91%) --- title: UI redesign description: New UI redesign focused on developer experience url: https://theirstack.com/en/docs/product-updates/2025-02-25-ui-redesign --- **New UI redesign enhancing developer experience**: Managing webhooks, datasets, API keys and reviewing your consumption is now easier than ever. --- title: Enhanced ATS URL filter description: Improved ATS URL exists filter to exclude 70 major job boards url: https://theirstack.com/en/docs/product-updates/2025-02-26-enhanced-ats-url-filter --- **Enhanced ATS URL exists filter**: We've enhanced the ATS URL exists filter to exclude jobs with URLs from 70 major job boards, such as ziprecruiter.com and thehub.io. --- title: Dataset page improvements description: Enhanced dataset page with dictionary downloads, size information, and row counts url: https://theirstack.com/en/docs/product-updates/2025-03-03-dataset-improvements-march --- **Improvements on Dataset page**: You can now download the dictionary of the dataset with all the information about the fields, see the size of the dataset and the number of rows it contains. --- title: New v2.0.0 for the Technographics dataset description: url: https://theirstack.com/en/docs/product-updates/2025-03-10-new-technographics-dataset-v2 --- Includes new columns, and renames some existing ones for consistency. Now includes columns for the 3 current sources of technographics data we have: - Job titles - Job descriptions - Job URLs Here are the columns which name has changed or have been added. The following columns are renamed: * `technology_id` → `keyword_id` * `technology_rank` → `technology_rank_source_jobs` * `technology_rank_180_days` → `technology_rank_180_days_source_jobs` * `rank_1_tie` → `rank_1_tie_source_jobs` * `rank_180_days_tie` → `rank_180_days_tie_source_jobs` * `relative_occurrence_within_category` → `relative_occurrence_within_category_source_jobs` * `jobs_source_final_url` → `jobs_source_url` * `first_date_found_source_final_url` → `first_date_found_source_job_url` * `last_date_found_source_final_url` → `last_date_found_source_job_url` The following columns are added: * `keyword_slug` - Slug identifier for the technology * `subcategory_slug` - Slug identifier for the technology subcategory * `is_recruiting_agency` - Indicates if the company is a recruiting agency * `jobs_source_description_last_180_days` - Number of jobs mentioning this technology in the job description in the last 180 days * `jobs_source_description_last_30_days` - Number of jobs mentioning this technology in the job description in the last 30 days * `jobs_source_description_last_7_days` - Number of jobs mentioning this technology in the job description in the last 7 days * `jobs_source_title` - Number of jobs mentioning this technology in the job title * `jobs_source_title_last_180_days` - Number of jobs mentioning this technology in the job title in the last 180 days * `jobs_source_title_last_30_days` - Number of jobs mentioning this technology in the job title in the last 30 days * `jobs_source_title_last_7_days` - Number of jobs mentioning this technology in the job title in the last 7 days * `jobs_source_url_last_180_days` - Number of jobs mentioning this technology in the ATS URL in the last 180 days * `jobs_source_url_last_30_days` - Number of jobs mentioning this technology in the ATS URL in the last 30 days * `jobs_source_url_last_7_days` - Number of jobs mentioning this technology in the ATS URL in the last 7 days * `first_date_found_source_job_title` - Date when the job title first mentioned the technology * `last_date_found_source_job_title` - Date when the job title last mentioned the technology * `rank_last_date_found_source_job_url` - Rank of the technology within its category based on mentions in job ATS URLs as of the last date found * `relative_occurrence_within_category_180_days_source_jobs` - Measures the relative occurrence of this technology among other technologies in the same category, in jobs by this company over the last 180 days --- title: Webhook observability + retry mechanism description: Webhook response viewing, retry mechanism, and new technographics dataset version url: https://theirstack.com/en/docs/product-updates/2025-03-10-webhook-observability-retry-technographics --- * **Webhooks Observability**: You can now view the response body and status code for each webhook. Additionally, you can filter events by their status (success or failure) and determine if a failure was due to a timeout. * **Webhooks Retry Mechanism**: Failed webhooks are now automatically retried every hour for up to 48 hours. --- title: Documentation improvements description: New webhooks docs, improved Clay docs, and enhanced backfilling job board guide url: https://theirstack.com/en/docs/product-updates/2025-03-11-documentation-improvements-march --- * **New [webhooks docs](/en/docs/webhooks)** * **Improved [Clay docs](/en/docs/integrations/clay)** * **Enhanced [Backfilling job board](/en/docs/guides/backfill-job-board) post** --- title: New technographics dataset endpoint + Usage improvements description: New technographics dataset endpoint in parquet format and enhanced usage tracking url: https://theirstack.com/en/docs/product-updates/2025-03-12-dataset-endpoint-usage-improvements --- * **New version of the dataset endpoint** [v1/datasets/technographics](https://api.theirstack.com/#tag/datasets/POST/v1/datasets/technographics) offering technographic dataset in parquet format. * **Improvement of the Requests section in the [Usage page](https://app.theirstack.com/usage)**: You can now see UI requests not only API Requests. * **New button to open a search from the API request**. You can now open a search from the API request modal by clicking on the "Open search" button. --- title: Roles and permissions + Export limit increase description: Added team roles and permissions system, increased export limit to 100,000+ records url: https://theirstack.com/en/docs/product-updates/2025-03-14-roles-permissions-export-limit --- * **Roles and permissions**: We've added roles and permissions to the team. Admins can now add and remove members and receive billing alerts. * **Export limit increased**: You can export CSV files with more than 100,000 records. --- title: Webhooks API is publicly available description: Webhooks API is now publicly available for all users url: https://theirstack.com/en/docs/product-updates/2025-03-17-webhooks-api-public-release --- You can now use the webhooks API to integrate this feature in your own system or to automate webhook creations. Check out the [webhooks docs](/en/docs/api-reference/webhooks/get_webhooks_v0) for more information. --- title: New Auto recharge rules description: Automatic credit recharge when balance runs low url: https://theirstack.com/en/docs/product-updates/2025-04-01-auto-recharge --- You can now set when to automatically purchase credits when your balance is low in the [billing page](https://app.theirstack.com/settings/billing). --- title: Company search fixes description: Fixed technology category column issues and export technology column problems url: https://theirstack.com/en/docs/product-updates/2025-04-02-company-search-fixes --- Resolved two issues affecting app users in [company search](https://app.theirstack.com/search/companies): * When filtering by technology category (e.g. "CRM Platforms") not showing a column per technology (e.g. "Salesforce", "Hubspot", "Zoho"...). * When exporting a list of companies filtering by technology category, there was not a column for each technology of the category. * When changing the technology filter, the table was filtering by the new technology, but a column was still showing the old technology. --- title: Subscription update process enhancements description: Subscription update process enhancements url: https://theirstack.com/en/docs/product-updates/2025-04-04-subscription-enhancements --- * Fixed issue where subscription updates created new subscriptions instead of modifying existing ones. * Added ability to customize credit allocation when updating your subscription plan. You can select any number of credits you want to be added to your account. --- title: Search experience has been improved description: Search experience has been improved url: https://theirstack.com/en/docs/product-updates/2025-04-15-search-experience-improvements --- * Cleaned up the header of the search page for jobs and companies. Now the search name is only displayed in the breadcrumb. * New Webhooks button to view the webhooks associated with the current search. It indicates whether the search has an active webhook or not. --- title: New webhook setting `trigger once per company` description: Fire a webhook only once per company url: https://theirstack.com/en/docs/product-updates/2025-04-15-trigger-once-per-company --- When enabled, the webhook will fire only once for each company. This is helpful for sales workflows where you want to act on the first job posted (e.g., send an email, add to a CRM) without triggering the workflow for every subsequent job from the same company. * Example: If active, Company A with 5 jobs → 1 event triggered. If deactivated, Company A with 5 jobs → 5 events triggered. * If you turn this on for an existing webhook, it will prevent duplicate companies from triggering events going forward. However, companies already sent before enabling the setting won't be remembered, so their jobs may still trigger events. --- title: Webhook usage analytics description: Track webhook performance and credit consumption url: https://theirstack.com/en/docs/product-updates/2025-04-15-webhook-usage-analytics --- Track individual webhook performance and credit consumption with a detailed breakdown chart. View which webhooks are using the most credits on the [usage page](https://app.theirstack.com/settings/usage). --- title: New docs description: Revamped documentation with new navigation and structure url: https://theirstack.com/en/docs/product-updates/2025-05-06-documentation-revamp --- We have revamped [our docs](/en/docs/api-reference) to make it easier to discover TheirStack and its features. * **Navigation**: Added a new sidebar to the left of the page to help you navigate the docs in a more intuitive way. * **Merge similar pages**: We've merged similar pages to avoid duplication and make it easier to learn about new topics. * **New dataset page**: We've added a new page to the docs to help you learn about our datasets. --- title: Slow company searches are now 2-6x faster description: url: https://theirstack.com/en/docs/product-updates/2025-05-07-slow-company-searches-are-now-2-6x-faster --- Company searches that before took too long or were just impossible to run just take seconds. This would typically happen when adding job or technology filters to the search. Here are examples of such queries: - Companies using Snowflake, with a high confidence score in the usage of that technology, from the US. Now it completes in [less than 5 seconds](https://app.theirstack.com/search/companies/new?query=JTdCJTIycXVlcnklMjIlM0ElN0IlMjJpbmNsdWRlX3RvdGFsX3Jlc3VsdHMlMjIlM0FmYWxzZSUyQyUyMm9yZGVyX2J5JTIyJTNBJTVCJTdCJTIyZGVzYyUyMiUzQXRydWUlMkMlMjJmaWVsZCUyMiUzQSUyMmNvbmZpZGVuY2UlMjIlN0QlMkMlN0IlMjJkZXNjJTIyJTNBdHJ1ZSUyQyUyMmZpZWxkJTIyJTNBJTIyam9icyUyMiU3RCUyQyU3QiUyMmRlc2MlMjIlM0F0cnVlJTJDJTIyZmllbGQlMjIlM0ElMjJudW1fam9icyUyMiU3RCU1RCUyQyUyMmNvbXBhbnlfY291bnRyeV9jb2RlX29yJTIyJTNBJTVCJTIyVVMlMjIlNUQlMkMlMjJjb21wYW55X3RlY2hub2xvZ3lfc2x1Z19vciUyMiUzQSU1QiUyMnNub3dmbGFrZSUyMiU1RCUyQyUyMnRlY2hfZmlsdGVycyUyMiUzQSU3QiUyMmNvbmZpZGVuY2Vfb3IlMjIlM0ElNUIlMjJoaWdoJTIyJTVEJTdEJTJDJTIyZXhwYW5kX3RlY2hub2xvZ3lfc2x1Z3MlMjIlM0ElNUIlNUQlN0QlMkMlMjJhdXRvX3NlYXJjaCUyMiUzQXRydWUlN0Q=) - Companies hiring data engineers in the US, UK or Canada. Now completes [in 3-4 seconds as well](https://app.theirstack.com/search/companies/new?query=JTdCJTIycXVlcnklMjIlM0ElN0IlMjJpbmNsdWRlX3RvdGFsX3Jlc3VsdHMlMjIlM0FmYWxzZSUyQyUyMm9yZGVyX2J5JTIyJTNBJTVCJTdCJTIyZGVzYyUyMiUzQXRydWUlMkMlMjJmaWVsZCUyMiUzQSUyMmNvbmZpZGVuY2UlMjIlN0QlMkMlN0IlMjJkZXNjJTIyJTNBdHJ1ZSUyQyUyMmZpZWxkJTIyJTNBJTIyam9icyUyMiU3RCUyQyU3QiUyMmRlc2MlMjIlM0F0cnVlJTJDJTIyZmllbGQlMjIlM0ElMjJudW1fam9icyUyMiU3RCU1RCUyQyUyMmNvbXBhbnlfY291bnRyeV9jb2RlX29yJTIyJTNBJTVCJTIyR0IlMjIlMkMlMjJVUyUyMiUyQyUyMkNBJTIyJTVEJTJDJTIyam9iX2ZpbHRlcnMlMjIlM0ElN0IlMjJwb3N0ZWRfYXRfbWF4X2FnZV9kYXlzJTIyJTNBNjAlMkMlMjJqb2JfdGl0bGVfb3IlMjIlM0ElNUIlMjJkYXRhJTIwZW5naW5lZXIlMjIlNUQlN0QlMkMlMjJleHBhbmRfdGVjaG5vbG9neV9zbHVncyUyMiUzQSU1QiU1RCU3RCUyQyUyMmF1dG9fc2VhcmNoJTIyJTNBdHJ1ZSU3RA==) These and other slow queries are now 2-6x faster. These is how long queries would take before and after the improvement: | Time before | Time now | Improvement | | -------------------- | -------- | ----------- | | \~16s | \~9s | 1.8x faster | | \~52s | \~13s | 4.0x faster | | \~98s | \~16s | 6.1x faster | | Timeouts (at 2 mins) | 20-35s | \~6x faster | --- title: Stable company logo URLs description: url: https://theirstack.com/en/docs/product-updates/2025-05-07-stable-logos-performance --- Previously, when scraping new jobs, we stored direct logo URLs from external sources. These links often broke due to expiration or CORS issues. We've updated our process to copy and host logo images on our own infrastructure. All newly detected companies will now use a permanent URL format: `https://media.theirstack.com/company/logo/xxx`.\ These links are stable and can be used anywhere. --- title: Export data with revealed records description: Export only revealed companies without consuming credits url: https://theirstack.com/en/docs/product-updates/2025-05-16-export-only-revealed --- You can export all records from already revealed companies. This is useful if you want to export data without consuming credits. --- title: Error handling improvements description: Clearer titles and descriptions for app notifications url: https://theirstack.com/en/docs/product-updates/2025-05-20-error-handling --- We've improved error handling in the app. Notifications now show better titles and descriptions so you can understand what went wrong. --- title: Slack integration guide description: New guide for sending jobs to Slack channels url: https://theirstack.com/en/docs/product-updates/2025-05-21-slack-integration-guide --- [How to send a slack message for every new job found](/en/docs/guides/how-to-send-jobs-to-slack) --- title: API error handling standardization description: Standardized error object with request_id, code, title, and message url: https://theirstack.com/en/docs/product-updates/2025-05-22-api-error-standardization --- We've standardized the error experience across all endpoints. The error object now consistently includes `request_id`, `code`, `title`, and `message`. --- title: New filters url_domain_or and url_domain_not in Job Search and Company Search endpoints description: Examples added for each filter in the API docs url: https://theirstack.com/en/docs/product-updates/2025-05-27-examples-filters-api-docs --- New filters `url_domain_or` and `url_domain_not` in [Jobs Search endpoint](/en/docs/api-reference/jobs/search_jobs_v1) and [Company Search endpoint](/en/docs/api-reference/companies/search_companies_v1). This filter allows you to get jobs from specific domains: greenhouse.io, workable.com, linkedin.com, etc. --- title: URL domain filters description: New url_domain_or and url_domain_not filters for Jobs and Company search endpoints url: https://theirstack.com/en/docs/product-updates/2025-05-27-url-domain-filters --- We've added new domain-based filters to both [Jobs Search endpoint](/en/docs/api-reference/jobs/search_jobs_v1) and [Company Search endpoint](/en/docs/api-reference/companies/search_companies_v1): **New filters:** * `url_domain_or` - Find jobs/companies from specific domains * `url_domain_not` - Exclude jobs/companies from specific domains This allows you to target or exclude jobs from specific platforms like greenhouse.io, workable.com, linkedin.com, etc. Perfect for focusing on direct company postings or excluding certain job boards from your results. --- title: Improved extraction of matching phrases description: Matching phrases and words are now extracted from job descriptions url: https://theirstack.com/en/docs/product-updates/2025-05-29-matching-phrases --- Before, when filtering jobs by keywords in job descriptions, `matching_phrases` and `matching_words` could be empty even when there were matches. We now extract the matching phrases and words from the job description. --- title: New technologies added description: Large expansion of technology detection including AI tools, infrastructure, and development platforms url: https://theirstack.com/en/docs/product-updates/2025-05-29-new-technologies --- We've added a large number of new technologies to our detection system, including: * Opentofu * MasterControl * BurpSuite * v0 * Lovable * Windsurf * Bolt * WeWeb * ZenQMS * Qualio Life Sciences QMS * ValGenesis * Kneat * ResQ * Sware Res\_Q * Tricentis * Tricentis Tosca * Tricentis Neoload * Tricentis qTest * SAP Cloud ALM * Siemens Polarion ALM * Salesforce Health Cloud * Tropic * Trackingplan * Payhawk * PayEm * ORO * Moss * Devin * Cline * Buck2 * a3innuva * Ramp * Builder * Clio * Yooz * Augment Code * Cursor * Syntess Atrium * Tonkean * Opstream * Flowie * Payflows * Omnea * Spendesk * TheirStack * Bard AI * Apollo.io --- title: Search performance improvements description: Up to 30x faster searches for specific filters url: https://theirstack.com/en/docs/product-updates/2025-06-03-search-performance-improvements --- Improved the performance\*\* of job searches and company searches by \*\*up to 30x\*\* when using some of the following filters: * `company_name_partial_match_or` * `company_name_partial_match_not` * `company_location_pattern_or` * `company_description_pattern_or` * `company_description_pattern_not` * `job_title_pattern_or` * `job_title_pattern_not` * `job_location_pattern_not` * `job_description_pattern_not` This will have effect especially when passing large arrays of values in them (of 50+ elements). Queries that before would take \~50 seconds are now taking 2-3 seconds, according to our tests. --- title: Jobs are now 3x cheaper description: Jobs are now 3x cheaper url: https://theirstack.com/en/docs/product-updates/2025-06-04-jobs-pricing-reduction --- Read more about it in [this blog post](/en/blog/jobs-are-now-up-to-3x-cheaper). --- title: New job description contains-any filter description: Search job descriptions for whole words without regex url: https://theirstack.com/en/docs/product-updates/2025-06-06-job-description-contains-any --- New job description filter `contains any` in [Job Search page](https://app.theirstack.com/search/jobs/new) and [Jobs Search endpoint](/en/docs/api-reference/jobs/search_jobs_v1)\*\*. Until now, searching in job descriptions required using regex patterns, which wasn't very user-friendly for non-technical users. We have added `job_description_contains_or` param to our API to allow you to search for whole words in job descriptions. Only finds complete words (e.g., searching 'quality' won't match 'inequality'). More technical information about how this filter works can be found in the [API docs](/en/docs/api-reference/jobs/search_jobs_v1). --- title: No results message in job and company searches description: Clearer, more helpful messages when searches return no results url: https://theirstack.com/en/docs/product-updates/2025-06-06-no-results-message-improvement --- When your search doesn't return any results, you'll now see a clearer, more helpful message—especially on small screens. --- title: Profile page description: You can now update your first and last name in your profile page url: https://theirstack.com/en/docs/product-updates/2025-06-06-profile-page-updates --- You can now update your first and last name in your [profile page](https://app.theirstack.com/settings/profile). --- title: Better loading experience in app searches description: Loading banner shows progress and logos of main job sources url: https://theirstack.com/en/docs/product-updates/2025-06-09-better-loading-experience --- When you search for jobs or companies, the app now shows a loading banner indicating progress and logos from the main sources. --- title: Database timeout status code changed to 504 description: Timeouts now return 504 Gateway Timeout instead of 408 Request Timeout url: https://theirstack.com/en/docs/product-updates/2025-06-09-database-timeout-status-change --- The HTTP status code returned for database query timeouts has been changed from `408 (Request Timeout)` to `504 (Gateway Timeout)`. A 504 code indicates a server-side timeout rather than a client-side one, which better reflects what's actually happening when a database query takes too long. If you were handling 408 errors before, you'll have to update your code to handle 504 errors instead. --- title: Job titles special characters fix description: Fixed display issue where special characters in job titles weren't rendering correctly url: https://theirstack.com/en/docs/product-updates/2025-06-10-job-titles-special-characters-fix --- We fixed an issue where some job titles weren't displaying special characters correctly. For example, 'Growth Analyst (AI & Search Architecture)' now appears as 'Growth Analyst (AI & Search Architecture)'. This fix applies to all new jobs going forward, ensuring proper character encoding and display across the platform. --- title: Unified search requires explicit action description: Job and company searches no longer auto-run; click Search to execute url: https://theirstack.com/en/docs/product-updates/2025-06-10-unified-search-experience --- To improve control and prevent accidental queries, searches in job and company pages no longer run automatically. You must click the "Search" button after setting filters. This is especially helpful for complex searches on historical data. --- title: Improvements on usage page description: Request duration display, dedicated requests page, and improved loading experience url: https://theirstack.com/en/docs/product-updates/2025-06-12-usage-page-improvements --- We made several major improvements to the usage page: * You can now see how long each request takes, and there's a dedicated page to view all your requests where the request table is expanded, making it easier to explore and analyze your data. * We've improved the empty state for all charts to make things clearer when there's no data. * The loading experience is now smoother. * Fixed an issue where the total request count wasn't displaying correctly. --- title: Save button fix description: Fixed save button not working with url_domain_or filter url: https://theirstack.com/en/docs/product-updates/2025-06-13-save-button-fix --- We fixed an issue where the save button wasn't working properly when using the `url_domain_or` filter. You can now save searches that include domain filtering without any issues. --- title: Auto-reveal fix + Webhook URL fix description: Fixed auto-revealing companies during searches and webhook test event URLs url: https://theirstack.com/en/docs/product-updates/2025-06-16-auto-reveal-webhook-fix --- We fixed two important issues: **Auto-reveal fix** Fixed an issue where companies were being auto-revealed during searches when they shouldn't have been. This ensures you only consume credits when intentionally revealing company data. **Webhook URL fix** Fixed the webhook "Test event" button which was using an outdated URL. Test events now work properly and help you verify your webhook configuration. --- title: Naukri job source + Company modal improvements description: New job source for India and improved company modal when no data is available url: https://theirstack.com/en/docs/product-updates/2025-06-23-naukri-india-company-modal --- **New job source: Naukri** We've added Naukri as a new job source for India 🇮🇳. Naukri is India's leading job portal, dramatically expanding our coverage of the Indian job market. **Company modal improvements** We've improved the company modal experience when no data is available. Instead of showing an empty modal, users now see helpful messaging and suggestions for next steps. --- title: Seek job source description: New job source for Australia market url: https://theirstack.com/en/docs/product-updates/2025-06-25-seek-australia --- We've added Seek as a new job source for Australia 🇦🇺. Seek is one of Australia's largest job boards, significantly expanding our coverage of the Australian job market with thousands of new job postings across all industries and experience levels. --- title: Usage page improvements description: Fixed webhook events chart updates and improved webhook visualization url: https://theirstack.com/en/docs/product-updates/2025-06-26-usage-page-improvements --- We made several improvements to the usage page: * We have fixed an issue where the webhook events chart was not updating the content when you changed the date range. * We have added more colors so clients with several webhooks can understand better the chart. * We have sorted the list of webhooks by the number of events. --- title: Mobile fix - Company lookup button description: Fixed "Look up a company" button not opening on mobile devices url: https://theirstack.com/en/docs/product-updates/2025-06-27-mobile-fix --- We fixed an issue where the "Look up a company" button wasn't working properly on mobile devices. The button now opens correctly across all mobile browsers and screen sizes. This ensures a consistent user experience whether you're searching for companies on desktop or mobile. --- title: Naukri Gulf job source description: New job source covering Gulf Cooperation Council countries url: https://theirstack.com/en/docs/product-updates/2025-06-30-naukri-gulf --- We've added Naukri Gulf as a new job source, expanding our coverage across the Gulf Cooperation Council (GCC) countries: * UAE 🇦🇪 * Saudi Arabia 🇸🇦 * Qatar 🇶🇦 * Oman 🇴🇲 * Bahrain 🇧🇭 This addition provides comprehensive job market coverage in the Middle East's key economic hubs. --- title: New job sources (France, Asia-Pacific) description: Added Welcome to the Jungle for France and JobsDB/JobStreet for Asia-Pacific markets url: https://theirstack.com/en/docs/product-updates/2025-07-14-job-sources-france-apac --- We've expanded our job coverage with new sources in France and Asia-Pacific: * Welcome to the Jungle - major French 🇫🇷 job board * JobsDB and JobStreet covering Hong Kong 🇭🇰, Malaysia 🇲🇾, Singapore 🇸🇬, Philippines 🇵🇭, Indonesia 🇮🇩, Thailand 🇹🇭, New Zealand 🇳🇿 These additions significantly improve job coverage in French-speaking markets and key Asia-Pacific economies. --- title: Property exists OR filter + Company type improvements description: New property_exists_or filter and improved company_type filtering to exclude recruiting agencies url: https://theirstack.com/en/docs/product-updates/2025-07-17-property-exists-or-filter --- We added a new `property_exists_or` filter to both [Jobs](/en/docs/api-reference/jobs/search_jobs_v1) and [Company Search](/en/docs/api-reference/companies/search_companies_v1) endpoints. This filter allows you to find records where at least one of the specified properties exists. We also improved the `company_type` filter. When filtering by `direct_employer`, we now exclude recruiting agencies to give you more accurate results when looking for direct hiring companies. --- title: New property exists filters (AND / OR) description: New filters to require specific fields be present for jobs or companies url: https://theirstack.com/en/docs/product-updates/2025-07-18-property-exists-filters --- We introduced `property_exists_and` and `property_exists_or` filters in both [Jobs](/en/docs/api-reference/jobs/search_jobs_v1) and [Companies](/en/docs/api-reference/companies/search_companies_v1) search endpoints. Use them to require fields like `final_url`, `hiring_team`, `company_object.domain`, `company_object.linkedin_url`, or `employment_statuses` (jobs) to be set. --- title: New property technology_slugs returned on Job Search endpoint description: Each job now includes technology_slugs detected in title, description, or URL url: https://theirstack.com/en/docs/product-updates/2025-07-18-technology-slugs-on-jobs --- We added a `technology_slugs` array for each job returned by the [Jobs Search endpoint](/en/docs/api-reference/jobs/search_jobs_v1). It contains the technology slugs detected in the job\_title, job\_description, or job\_url. Read more about [how we source our technographic data](/en/docs/data/technographic/how-we-source-tech-stack-data) --- title: Company webhooks improvements description: New webhooks for company data url: https://theirstack.com/en/docs/product-updates/2025-07-23-company-webhooks --- Previously, you could set up [webhooks](/en/docs/webhooks) to export company data to external tools like Clay, N8N, and Zapier, but you'd miss out when new companies matched your search criteria. We've now added continuous monitoring – your webhooks will automatically send events whenever fresh companies are discovered that match your search parameters. This means you'll get instant notifications when new companies start adopting specific technologies (like Salesforce or Hubspot) or entire technology categories (such as CRM Platforms). --- title: API dialog improvements description: Better handling of special characters and support for more request types url: https://theirstack.com/en/docs/product-updates/2025-07-29-api-dialog --- The API dialog let you get the curl command to call the API from the App. We've made 2 improvements to it: * Body request now properly supports special characters like apostrophes. * Displays curl for other requests (exports, technographics, etc.). --- title: New default limit for technographics API description: The default limit for the technographics API is now 1000 instead of 100 url: https://theirstack.com/en/docs/product-updates/2025-07-30-new-default-limit-technographics-api --- We've removed the default limit in the [Technographics endpoint](/en/docs/api-reference/companies/technographics_v1) on the number of technologies returned. Previously, the API only returned 25 technologies per request, forcing you to make multiple calls to get complete technology data for most companies. Since retrieving full tech stack is the most common use case, we've simplified the API to return all technologies by default. There is no need to pass the `page` and `limit` parameters anymore. --- title: New affiliate program description: Improved commissions and self-service portal for partners url: https://theirstack.com/en/docs/product-updates/2025-08-07-new-affiliate-program --- We launched an improved affiliate program with higher commission rates and a self-service portal. See the announcement post in the [blog](/en/blog/new-affiliate-program). --- title: New normalized 'locations' property in job results description: Jobs now include a structured, normalized locations array replacing fragmented fields url: https://theirstack.com/en/docs/product-updates/2025-08-08-locations-property --- The [Jobs Search endpoint](/en/docs/api-reference/jobs/search_jobs_v1) now returns a `locations` property for each job. It's an array of Location objects with comprehensive geographic data based on the GeoNames database. Each location object includes: **Core Location Information:** * `id` – ID of the location in GeoNames. * `name` – The name of the location. If it's a city, it will be the city name; if it's a country, it will be the country name; if it's a region, it will be the region name, etc (e.g., "New York City", "Germany") * `type` – The type of location (e.g., "city", "country", "region") * `feature_code` – GeoNames feature code (e.g., "PPL" for populated place, "ADM1" for first-order administrative division, "PCLI" for country...). Check all the possible feature codes [here](https://www.geonames.org/export/codes.html). * `feature_class` – GeoNames feature class (e.g., "P" for cities or towns, "A" for countries, states, regions...). Each one of the possible feature classes is each one of the sections in [here](https://www.geonames.org/export/codes.html). **Geographic Coordinates:** * `latitude` – Geographic latitude coordinate for precise mapping * `longitude` – Geographic longitude coordinate for precise mapping **Administrative Divisions:** * `admin1_name` – First-level administrative division name (e.g., "California", "New York") * `admin1_code` – First-level administrative division code (e.g., "CA", "NY") * `admin1_id` – GeoNames ID for the first-level administrative division * `admin2_name` – Second-level administrative division name (e.g., county or district) * `admin2_code` – Second-level administrative division code * `admin3_code` – Third-level administrative division code * `admin4_code` – Fourth-level administrative division code **Country and Continent:** * `country_code` – ISO 3166-1 alpha-2 country code (e.g., "US", "DE") * `country_id` – GeoNames ID for the country * `continent` – Continent code (e.g., "NA", "EU", "AS") Here's an example location object: ```json [ { "admin1_code": "NY", "admin1_id": "5128638", "admin1_name": "New York", "continent": "NA", "continent_id": "6255149", "country_code": "US", "country_id": "6252001", "feature_class": "P", "feature_code": "PPL", "id": "5128581", "latitude": 40.71427, "longitude": -74.00597, "name": "New York City" } ] ``` We've built a location parsing system that works like a universal translator for addresses. It doesn't just standardize formats—it also adds missing geographic coordinates and validates addresses to create a complete location profile for every job posting. This turns scattered location fragments into precise, searchable geographic data. See our [location normalization docs](/en/docs/data/job/data-workflow#extraction--normalization) --- title: New employment statuses filters description: Use employment_statuses filters in Jobs and Companies search, and property existence checks url: https://theirstack.com/en/docs/product-updates/2025-08-11-employment-statuses --- New `employment_statuses_or` filter in the [Jobs Search endpoint](/en/docs/api-reference/jobs/search_jobs_v1) and [Company Search endpoint](/en/docs/api-reference/companies/search_companies_v1). Pass an array like `["full_time", "seasonal"]` to match any of the provided statuses. Leave empty or pass `null` to include all jobs. New `employment_statuses` option for `property_exists_or` and `property_exists_and` in the [Jobs Search endpoint](/en/docs/api-reference/jobs/search_jobs_v1) and [Company Search endpoint](/en/docs/api-reference/companies/search_companies_v1). Filter to only jobs where employment status information is available and populated. --- title: Company domain enrichment improvements description: Enhanced company domain identification and improved accuracy in company matching to eliminate false associations url: https://theirstack.com/en/docs/product-updates/2025-08-12-company-domain-enrichment-improvements --- When building our company dataset, we combine information from multiple sources. One of the most important pieces of company information we provide is the domain, and we made 2 major improvements to it: * **Better identification of URLs from social sites, link shorteners, etc.** - A significant number of companies set their LinkedIn URL to a link to `bit.ly`, `linktr.ee`, `sites.google.com`, `facebook.com`, `instagram.com`... When extracting the domain from those URLs, we'd say that Bit.ly, Linktree, Google, Facebook or Instagram (among others) were associated to tens of thousands of companies, which is obviously not the case. This is now fixed. For example, `bit.ly` was originally associated to thousands of companies because many of them had set their LinkedIn URL to a `bit.ly` link. Now it's only associated with the correct company, as shown in this [bit.ly domain search](https://app.theirstack.com/search/companies/new?query=N4IgjgrgpgTgniAXKAlgOwMYBsIBMoD6ALgPZECGWBMUAzhFkbUgGaW1QA0IJM+MBAEYJEAbVD5aGJERjRuLFFCy4kIDCTSL8mKCAC+nCXWmJZ8kIuWrEIAFYlBzQ8aky5XS0pVq0EALYEDk4GALrcGv4ADuRocAS4JP7k6AS8SKIggihEWHAAdJEg4SBQAB4xaLjEUBgAFmgkWCQA5vG0OC3MYqGGIOQQpAQc5DD17tD6QA). * **Better company linkage to companies with similar names** - Previously, in many cases we'd match small companies with names similar to those of larger companies to the larger company. For example, we'd say that the domain of a company named `AIR+` was `airbnb.com`, which is also not true. Now, the name similarity has to be much higher for us to consider two companies to be the same. --- title: Job processing improvements description: Enhanced job data quality with better Markdown rendering, accurate location display, and complete salary information url: https://theirstack.com/en/docs/product-updates/2025-08-13-job-processing-improvements --- Fixed double-escaped Markdown in YCombinator job descriptions so formatting like bold renders correctly. Fixed [Join](https://join.com) job locations so they reflect the actual job location rather than the company HQ. Fixed missing salary display for a small subset of jobs. The `salary_string` field was empty despite salary data being present, which left the UI column blank and impacted API results. Now any job with `min_salary` or `max_salary` includes a populated `salary_string`. This field represents the salary range in a human-readable and localized format. --- title: Location filter has better matching for states and regions description: Location filters in Jobs and Company search now use normalized locations array for improved geographic matching url: https://theirstack.com/en/docs/product-updates/2025-08-19-improve-location-filter-in-jobs --- We've enhanced location filtering in the [Jobs Search endpoint](/en/docs/api-reference/jobs/search_jobs_v1) and job filters in the [Company Search endpoint](/en/docs/api-reference/companies/search_companies_v1) by improving how `location_pattern_or` and `job_location_pattern_not` filters work. * **Before:** Searching for "California" only matched jobs with "California" in the location string * **Now:** Returns all jobs from any city within California (San Francisco, Los Angeles, Sacramento, etc.) or cities containing "California" in the name Previous limitations [#previous-limitations] Location filtering used only the basic `location` field, which had several limitations: * **Unstructured data** - Location information wasn't standardized. For example, in some jobs the location was "San Francisco, CA" and in others it was "San Francisco, California". * **Inconsistent details** - State names, city names, and country information weren't always available or standardized * **Limited search accuracy** - You could only match exact text patterns in the location string What's improved [#whats-improved] These filters now search across the enhanced `locations` attribute (introduced in our [August 8 update](/en/product-updates/2025-08-08-locations-property)) instead of just the basic `location` field. This provides more accurate geographic matching using structured location data with normalized city and state information. This enhancement leverages our [location normalization process](/en/docs/data/job/data-workflow#extraction--normalization) to deliver significantly better geographic search accuracy across all job sources. --- title: New filter `company_linkedin_url` in Technographics endpoint description: Filter companies by LinkedIn URL directly in the Technographics endpoint without needing to search for domain or name first url: https://theirstack.com/en/docs/product-updates/2025-09-02-company-linkedin-url-technographics-endpoint --- Previously, you could only filter companies in the [Technographics endpoint](/en/docs/api-reference/companies/technographics_v1) using `company_domain` or `company_name`. Now you can also use `company_linkedin_url` as a filter. If you're already working with LinkedIn URLs as your primary company identifier, you no longer need to make an additional call to the [Company Search endpoint](/en/docs/api-reference/companies/search_companies_v1) to find the domain or name first. You can now query the Technographics endpoint directly with the LinkedIn URL. This streamlines your workflow and reduces the number of API calls and API credits needed to get technology data for companies. --- title: Fixed missing employment status data across job sources description: Resolved an issue where employment status information (full-time, part-time, etc.) was missing from job listings that should have included this data url: https://theirstack.com/en/docs/product-updates/2025-09-02-employement-statuses-fix --- We've identified and resolved an issue affecting employment status data across several job sources. Previously, the employment status field (which indicates whether positions are full-time, part-time, contract, etc.) was appearing empty for certain job listings, even when this information was available from the source. This has now been fixed for all jobs discovered from September 2, 2025 onwards, ensuring that employment status data is properly captured and displayed when available from job sources. For older jobs, we'll reprocess them in the coming weeks to backfill this missing data. --- title: New Location Filters for precise geographic targeting in job searches description: Introducing job_location_or and job_location_not filters for precise location-based job search using structured location IDs url: https://theirstack.com/en/docs/product-updates/2025-09-04-add-new-filter-for-locations --- > 🚧 **Beta Feature:** This new filtering capability is currently available for recent jobs (posted within the last 3 months ±). We're actively expanding coverage to older jobs and improving the system based on user feedback. 🚧 We've introduced new location filters `job_location_or` and `job_location_not` to the [Jobs Search endpoint](/en/docs/api-reference/jobs/search_jobs_v1) and [Company Search endpoint](/en/docs/api-reference/companies/search_companies_v1) for precise geographic targeting in job searches. These new filters address several limitations of the existing `location_pattern_or` filter: * **Greater precision** - Target specific cities, states, or regions with exact accuracy. When searching for San Francisco, results will be limited to California, U.S., and won't include other cities with the same name elsewhere in the world * **Hierarchical location searches** - Search for "Europe", "China" or "California" and get all jobs within that region. The hierarchical location data enables searches at any level (country, state, province, city, etc.). This wasn't possible with the previous text-based approach, which couldn't understand location hierarchies * **Multi-language location searches** - Search for locations in different languages using the same location IDs, ensuring consistent results regardless of the search language. With the previous string matching approach, searching for "Germany" wouldn't match all occurrences since "Deutschland" could be used instead * **Cross-country city searches** - Search across multiple cities in different countries simultaneously. This supports state/city queries across countries (e.g., Alabama, US and London, UK) in a single search request * **Improved flexibility** - Easily combine multiple location criteria or exclude specific areas * **Better performance** - More efficient searches using indexed location data * **Structured data** - Uses normalized location IDs instead of text pattern matching You can use the [locations catalog endpoint](/en/docs/api-reference/catalog/get_catalog_locations_v0) to search for the IDs of your desired locations. --- title: Introducing Locations Catalog for precise geographic targeting description: Introducing a searchable locations catalog endpoint to easily find location IDs for precise geographic targeting in job and company searches url: https://theirstack.com/en/docs/product-updates/2025-09-05-new-location-catalog --- We've just released our new [locations catalog endpoint](/en/docs/api-reference/catalog/get_catalog_locations_v0), making it simple to find and search through location data when you need precise geographic targeting. This is especially useful when you're integrating our API into your application and want to use location-based filtering: 1. A user searches for "Paris" in your app 2. Your system calls [GET `/v0/catalog/locations?name=Paris`](/en/docs/api-reference/catalog/get_catalog_locations_v0) to get Paris's location ID 3. You use that ID with our **[Jobs endpoint](/en/docs/api-reference/jobs/search_jobs_v1)** using `"job_location_or": [{"id": "XXX"}]` to return jobs only in Paris The workflow is straightforward and keeps the complexity hidden from your users. --- title: New filter `job_description_contains_not` in Jobs Search endpoint description: Filter out unwanted jobs by excluding specific words from job descriptions with our new negative search filter url: https://theirstack.com/en/docs/product-updates/2025-09-08-new-filter-job-description-contains-not-in-job-search --- We've added a new exclusion filter called `job_description_contains_not` to the [Jobs Search endpoint](/en/docs/api-reference/jobs/search_jobs_v1). This filter helps you exclude jobs that contain specific words in their descriptions. Here's how it works: * **Whole word matching**: It only matches complete words using word boundaries, so searching for "quality" won't exclude jobs mentioning "inequality" * **Smart case handling**: Searches are case-insensitive by default, but if you use uppercase patterns, we'll respect the exact casing * **Multiple exclusions**: You can exclude jobs containing any of several different words at once Perfect for filtering out roles you're not interested in, like excluding "internship" positions or "remote" jobs when you prefer in-office work. --- title: Search jobs by company without date filters - new `company_domain_or` and `company_linkedin_url_or` options description: Get all jobs posted by a company without date filters - new company domain and LinkedIn URL search options added url: https://theirstack.com/en/docs/product-updates/2025-09-08-new-required-filter-job-search --- Previously, when using the [Jobs Search endpoint](/en/docs/api-reference/jobs/search_jobs_v1), you needed to include at least one of these required filters: * `posted_at_max_age_days` * `posted_at_gte` * `posted_at_lte` * `company_name_or` We've expanded the list of required filters to include two new options: * `company_domain_or` * `company_linkedin_url_or` Now you can search for jobs from specific companies using their domain or LinkedIn URL, without needing to specify dates or company names. This gives you more flexibility when targeting jobs from particular organizations. --- title: Improved seniority parsing for Vice President and Staff... positions description: Get all jobs posted by a company without date filters - new company domain and LinkedIn URL search options added url: https://theirstack.com/en/docs/product-updates/2025-09-12-improved-seniority-parsing --- The `seniority` field in every `job` object in the Job Search endpoint can take one of these 5 values: `c_level`, `staff`, `senior`, `mid_level`, `junior` Previously, seniority was not being correctly assigned for certain job titles: * All “Vice President” roles were sometimes misclassified, being considered as mid-level roles, and all "VP" roles were considered C-Level. * The “Staff” seniority label was applied too broadly, including roles like “Staff Nurse” or “Staff Physician” that do not represent Staff-level IC (Individual Contributor) positions. With this update, seniority assignment has been improved: * All “Vice President” roles are now consistently marked as Senior, rather than C-Level. While VP might sound like a C-Level title, in many organizations—especially banks and financial institutions—VP is a very common title that better aligns with Senior-level responsibility. * The “Staff” seniority is now reserved only for explicit Staff-level IC roles, such as “Staff Engineer” or “Member of the Technical Staff.” * Roles like “Staff Nurse” or “Staff Physician” are no longer misclassified as Staff; instead, they are mapped to more appropriate levels, often mid-level. --- title: Update to blur_company_data for single company queries description: blur_company_data now charges credits when filtering by a single company url: https://theirstack.com/en/docs/product-updates/2025-10-06-blur-company-data-update --- Starting October 9, 2025, `blur_company_data` won't have any effect when filtering by a single company and will be charged as if it wasn't there. This change helps us maintain our low pricing while keeping the platform sustainable for everyone. Read more about this update in our [blog post](/en/blog/blur-company-data-changes). --- title: General improvements to the job search endpoint description: General improvements to the job search endpoint url: https://theirstack.com/en/docs/product-updates/2025-10-22-performance-improvements --- We've made several improvements to our platform over the past few weeks to boost stability and performance. Here's what's gotten faster: Webhooks [#webhooks] Webhooks are now more reliable and faster than ever. We've separated webhooks into different pipelines to eliminate bottlenecks and keep things running smoothly. Job Searches [#job-searches] When you filter job searches by company identifiers (domain, LinkedIn URL, or name), you'll notice significant speed improvements: * Searches for companies that don't exist in our database are now **3x faster** than before * Searches for companies that do exist in our database are now **2x faster** than before Technographics [#technographics] Technographics queries are now **2x faster**, giving you the technology insights you need in half the time. Company Searches [#company-searches] Filtering company searches by technology is now **25% faster**, making it quicker to find companies using specific tech stacks. --- title: Free Plan Update description: Learn about the new free plan limits and monthly credits for job and company searches. url: https://theirstack.com/en/docs/product-updates/2025-10-23-free-plan-update --- We've updated our free plan with clearer limits while keeping it completely free forever. Every month, free plan users get **50 company credits** and **200 API credits**. New limits include: * Browse up to 5 pages of search results * View up to 25 results per page * Rate limit of 2 requests per second For complete details on all features and limits, see our [pricing plans](/en/docs/pricing/plans) page. Need more? Upgrade to any paid plan for unlimited pages, up to 500 results per page, and 4 requests per second at your [billing settings](https://app.theirstack.com/settings/billing/purchase?defaultTab=app). --- title: Clay Integration description: TheirStack Jobs Data is now available as an integration in Clay for tracking real-time job postings from 313k+ sources. url: https://theirstack.com/en/docs/product-updates/2025-10-24-clay-integration --- We're excited to announce that TheirStack Jobs Data is now available as an integration in Clay, giving you access to real-time job posting data directly within your GTM workflows. How to Use [#how-to-use] To get started with the TheirStack integration in Clay: 1. Go to [Clay](https://www.clay.com) and create a new table. 2. Go to **"Add Enrichment"** in your Clay table 3. Select **"TheirStack"** from the integrations list 4. Choose **"Get Company Jobs"** to retrieve job postings For more information about our job data, check out our [Job Search API documentation](/en/docs/api-reference/jobs/search_jobs_v1). You can also learn more about the integration on [Clay's TheirStack integration page](https://www.clay.com/integrations/data-provider/theirstack) or read about it in [Clay's product roundup changelog](https://www.clay.com/changelog/product-roundup-25-q4-2). --- title: New technologies added description: Expansion of technology detection across AI platforms, data science tools, supply chain solutions, tag management systems, and enterprise software url: https://theirstack.com/en/docs/product-updates/2025-10-31-new-technologies --- We've added 48 new technologies to our detection system, expanding coverage across artificial intelligence, data science, supply chain management, tag management, and enterprise software categories. Artificial Intelligence & Machine Learning [#artificial-intelligence--machine-learning] * [IFS.ai](https://theirstack.com/en/technology/ifs-ai) * [NVIDIA Nemotron](https://theirstack.com/en/technology/nvidia-nemotron) * [NVIDIA Dynamo](https://theirstack.com/en/technology/nvidia-dynamo) * [RAPIDS](https://theirstack.com/en/technology/rapids) * [NVIDIA BioNeMo](https://theirstack.com/en/technology/nvidia-bionemo) * [Triton](https://theirstack.com/en/technology/triton) * [Gurobi Optimizer](https://theirstack.com/en/technology/gurobi-optimizer) * [NVIDIA PhysicsNeMo](https://theirstack.com/en/technology/nvidia-physicsnemo) Data Science & Analytics [#data-science--analytics] * [Google OR-Tools](https://theirstack.com/en/technology/google-or-tools) * [Waaila](https://theirstack.com/en/technology/waaila) * [UTM.io](https://theirstack.com/en/technology/utm-io) * [HiGHS](https://theirstack.com/en/technology/highs) * [PyVRP](https://theirstack.com/en/technology/pyvrp) Supply Chain & Logistics [#supply-chain--logistics] * [Customer Order and Network Density OptimizeR (CONDOR)](https://theirstack.com/en/technology/customer-order-and-network-density-optimizer--condor-) * [RouteSmart Technologies](https://theirstack.com/en/technology/routesmart-technologies) * [Hexaly](https://theirstack.com/en/technology/hexaly) * [NextBillion.ai](https://theirstack.com/en/technology/nextbillion-ai) * [UPS](https://theirstack.com/en/technology/ups) Tag Management & Data Quality [#tag-management--data-quality] * [Website Observer](https://theirstack.com/en/technology/website-observer) * [Enterprise Tag Manager](https://theirstack.com/en/technology/enterprise-tag-manager) * [DataTrue](https://theirstack.com/en/technology/datatrue) * [Tag Inspector](https://theirstack.com/en/technology/tag-inspector1) * [TAGLAB](https://theirstack.com/en/technology/taglab) * [Code Cube](https://theirstack.com/en/technology/code-cube) * [Tag Insight](https://theirstack.com/en/technology/tag-insight) * [Data Kojak](https://theirstack.com/en/technology/data-kojak) * [Netvigie Tracking](https://theirstack.com/en/technology/netvigie-tracking) * [Verified Data](https://theirstack.com/en/technology/verified-data) Application Development & Infrastructure [#application-development--infrastructure] * [Nextmv](https://theirstack.com/en/technology/nextmv1) * [FlashInfer](https://theirstack.com/en/technology/flashinfer) * [Strimzi Kafka Operator](https://theirstack.com/en/technology/strimzi-kafka-operator) * [SGLang](https://theirstack.com/en/technology/sglang) Enterprise Software [#enterprise-software] * [Maximo Asset Management](https://theirstack.com/en/technology/maximo-asset-management) * [SAP Field Service Management](https://theirstack.com/en/technology/sap-field-service-management) * [Apache KIE](https://theirstack.com/en/technology/apache-kie) * [NEC](https://theirstack.com/en/technology/nec) Mapping & Location Services [#mapping--location-services] * [GraphHopper Directions API](https://theirstack.com/en/technology/graphhopper-directions-api) Other Categories [#other-categories] * [Solvice](https://theirstack.com/en/technology/solvice) - Resource Scheduling * [Accutics](https://theirstack.com/en/technology/accutics) - Marketing Performance Management * [LMCache](https://theirstack.com/en/technology/lmcache) - Content Delivery Network * [Leaf Signal](https://theirstack.com/en/technology/leaf-signal) - Conversion Optimization * [Avo](https://theirstack.com/en/technology/avo1) - Data Management Platform * [Adobe Experience Platform Assurance](https://theirstack.com/en/technology/adobe-experience-platform-assurance) - Application Testing * [Terminus](https://theirstack.com/en/technology/terminus) - Link Management Tools * [LlamaIndex](https://theirstack.com/en/technology/llamaindex) - Document Management * [Data On Duty](https://theirstack.com/en/technology/data-on-duty) - GDPR Compliance * [Raisely](https://theirstack.com/en/technology/raisely) - Fundraising and Donation Management * [Jarvi](https://theirstack.com/en/technology/jarvi) - Recruitment --- title: New columns when exporting jobs description: Job exports now include employment status and seniority level columns for better filtering and analysis. url: https://theirstack.com/en/docs/product-updates/2025-11-03-job-export-new-columns --- We've added two new columns to job exports from the [Job Search](/en/docs/app/job-search) feature. These columns help you filter and analyze jobs more effectively when exporting your results. The new columns are: * **`employment_status`** - Displays the employment statuses for the job. This can include values like "Full-time", "Part-time", "Contract", or "Temporary". When a job has multiple statuses, they're listed as a comma-separated string. * **`seniority`** - Indicates the seniority level of the position. This field uses values like `c_level`, `staff`, `senior`, `mid_level`, or `junior` to help you categorize roles by experience level. These columns are automatically included in all job exports (CSV and Excel formats), so you'll have richer data to work with when analyzing job postings or building integrations. --- title: Rate Limit Headers description: API responses now include rate limit information in response headers for better monitoring and integration management. url: https://theirstack.com/en/docs/product-updates/2025-11-03-rate-limit --- We've added rate limit information to API response headers, making it easier to monitor your usage and manage your API integrations. Every API response now includes these headers: * **RateLimit** - Current quota status per policy with remaining requests and reset time * **RateLimit-Policy** - Applied policy definitions with limits and window durations * **RateLimit-Remaining** - Shows how many requests you have left in each time window * **RateLimit-Reset** - Tells you when each limit resets (in seconds) * **RateLimit-Limit** - Your total allowed requests per window For complete details on which headers are included, what they mean, and how to use them, check out our [API documentation](/en/docs/api-reference/rate-limit). The rate limiting section explains everything you need to know about rate limits and how to handle them in your applications. --- title: Fill Rate Metrics description: See fill rate percentages for every field across Job, Company, Technographic, and Technology entities, updated in real time. url: https://theirstack.com/en/docs/product-updates/2025-11-10-fill-rate --- You can now see the fill rate for every field across our main entities: [Job](/en/docs/datasets/options/job), [Company](/en/docs/datasets/options/company), [Technographic](/en/docs/datasets/options/technographic), and [Technology](/en/docs/datasets/options/technographic). Fill rate shows what percentage of records have a value for each field. We update this metric in real time, so you'll always see the latest data coverage. --- title: Jobs and Companies Statistics Pages description: New statistics pages for Jobs and Companies with monthly totals, breakdowns by country, source, workplace type, industry, employee size, and headquarters location. url: https://theirstack.com/en/docs/product-updates/2025-11-10-job-company-statistics --- We've added a new [Jobs Statistics page](/en/docs/data/job/statistics) where you can see the total number of jobs discovered each month. You'll also find breakdowns by country, source, and workplace type. We've also created a [Companies Statistics page](/en/docs/data/company/statistics) with breakdowns by industry, employee size, and headquarters country. --- title: Smarter company matching using multiple data points description: We've enhanced our company matching algorithm to accurately associate jobs with companies, even when multiple companies share the same name. url: https://theirstack.com/en/docs/product-updates/2025-11-17-company-matching --- We've fixed an issue where jobs weren't always matched to the correct company. When multiple companies had the same name, our system couldn't tell them apart reliably. Now our matching algorithm uses the job's company domain and source as additional signals to identify the right company. This means each job gets linked to the correct company profile, even when company names are identical. All new jobs posted from November 17, 2025 onward use this improved matching. We're also updating existing jobs over the next few weeks so they benefit from the same enhancement. --- title: Full locations catalog now searchable - over 4.2M locations available description: The locations catalog endpoint now supports searching through the complete catalog of over 4.2M locations, expanded from the previous 250k limit url: https://theirstack.com/en/docs/product-updates/2025-12-19-expanded-location-catalog --- We've expanded the [locations catalog endpoint](/en/docs/api-reference/catalog/get_catalog_locations_v0) to include the full catalog of over 4.2 million searchable locations, up from the previous limit of 250,000 locations. What's changed [#whats-changed] When we first introduced the [locations catalog](/en/product-updates/2025-09-05-new-location-catalog) alongside the [new location filters](/en/product-updates/2025-09-04-add-new-filter-for-locations), we initially limited searchable locations to 250k to ensure fast response times. Now, you can search through and use the complete catalog of over 4.2 million locations in your job searches. This means you can now find and use location IDs for: * **More cities and towns** - Access to smaller cities, towns, and localities that weren't previously searchable * **Broader geographic coverage** - More comprehensive location data across all countries and regions * **Greater precision** - Find exact location IDs for even the most specific geographic areas All locations in the catalog can be used with the `job_location_or` and `job_location_not` filters in the [Jobs Search API](/en/docs/api-reference/jobs/search_jobs_v1) and the New Job Location filter in the UI, giving you access to the full breadth of our location data for precise geographic targeting. --- title: More accurate job location filtering - 20% fewer false matches description: The job_location_or filter (New Job Location filter in the UI) now has significantly fewer false positives, providing more accurate location-based job search results url: https://theirstack.com/en/docs/product-updates/2025-12-18-location-or-filter-false-positives-reduced --- We've significantly improved the accuracy of the `job_location_or` filter (shown as "New Job Location" in the UI) reducing false positives in location matching by \~20%. Before [#before] When looking for jobs from many cities, around 20% of the results were false positives. For example, when looking for jobs from Manchester, one would get results from different places as shown in the image below: Before After [#after] This happened because for jobs where we didn't have structured location data but just a location string, we'd fall back to making string matches on the name of the location being searched, as well as it's parent administrative units (state, country, etc.). So we'd be looking for jobs mentioning 'England' as well, which would yield many false positives. This is now fixed and in the following image you can see that both the number of jobs found is lower, and there are no false positives anymore: After --- title: New technologies added description: Expansion of technology detection across AI models, accounting software, meeting tools, and development platforms url: https://theirstack.com/en/docs/product-updates/2026-01-15-new-technologies --- We've added 24 new technologies to our detection system, expanding coverage across artificial intelligence models, accounting software, meeting tools, and development platforms. Artificial Intelligence & Machine Learning [#artificial-intelligence--machine-learning] * [Kimi K2](https://theirstack.com/en/technology/kimi-k2) * [Llama 3](https://theirstack.com/en/technology/llama-3) * [DeepSeek-R1](https://theirstack.com/en/technology/deepseek-r1) * [Qwen3](https://theirstack.com/en/technology/qwen3) * [DeepSeek-V3](https://theirstack.com/en/technology/deepseek-v3) * [gpt-oss](https://theirstack.com/en/technology/gpt-oss) * [Llama 4](https://theirstack.com/en/technology/llama-4) * [Gemma](https://theirstack.com/en/technology/gemma) Accounting & Financial Management [#accounting--financial-management] * [MyUnisoft](https://theirstack.com/en/technology/myunisoft) * [Cegid Expert](https://theirstack.com/en/technology/cegid-expert) * [Cegid Loop](https://theirstack.com/en/technology/cegid-loop) * [Cegid Quadra](https://theirstack.com/en/technology/cegid-quadra) * [Pennylane](https://theirstack.com/en/technology/pennylane) * [Ingeneo](https://theirstack.com/en/technology/ingeneo) * [ACD Groupe](https://theirstack.com/en/technology/acd-groupe) * [Tiime](https://theirstack.com/en/technology/tiime) Meeting & Collaboration Tools [#meeting--collaboration-tools] * [tl;dv](https://theirstack.com/en/technology/tl-dv) * [Otter.ai](https://theirstack.com/en/technology/otter-ai) * [Fireflies](https://theirstack.com/en/technology/fireflies) Development & Testing [#development--testing] * [Keploy](https://theirstack.com/en/technology/keploy) - Test Automation * [Module Federation](https://theirstack.com/en/technology/module-federation) - Web Framework Other Categories [#other-categories] * [Notify](https://theirstack.com/en/technology/notify) - Push Notifications * [HiveMQ](https://theirstack.com/en/technology/hivemq) - IoT Platform * [Praiz](https://theirstack.com/en/technology/praiz) - Call Recording * [Claap](https://theirstack.com/en/technology/claap) - Sales Productivity --- title: Increased amount of discovered jobs description: We've significantly increased the number of daily jobs in our system by scaling our discovery agents and enhancing our job discovery strategy to capture more job types than ever before. url: https://theirstack.com/en/docs/product-updates/2026-01-19-increased-daily-jobs-discovery --- Since November we've constantly increased the number of daily jobs in our system by scaling up our discovery agents and improving how we find new job postings. We now have more agents scanning job boards, so we're catching jobs faster and more frequently. We've also improved our discovery strategy to find a wider variety of job types, job roles and jobs in countries that we might have missed before. What this means for you: [#what-this-means-for-you] * **More hits on your job searches**: Your searches will return more results * **More jobs for each company**: Companies now have more job postings in our system * **More technology hits**: When searching for jobs or companies using specific technologies, you'll find more matches These improvements are live now. You'll see more jobs in your searches and exports as we continue discovering new postings every day. --- title: Search within your Company Lists description: New "Add filter" button lets you apply job and technology filters to your saved company lists url: https://theirstack.com/en/docs/product-updates/2026-02-02-search-within-company-lists --- **The problem:** When you save companies to a list after searching by job title or technology, the list only shows basic company information. You lose the job and technology context that made those companies relevant in the first place — and exports don't include those fields either. **The solution:** You can now click the **"Add filter"** button next to the search bar on any company list page. This opens the company search with your list pre-selected as a filter, where you can: * Re-apply job title or description filters to see matching jobs * Add technology filters to see which tools each company uses * Export results with job titles, technologies, and other fields included Step 2: Company search with your list filter applied This bridges the gap between your curated company lists and TheirStack's full search capabilities — so you never lose the context of why a company was added to your list.