TheirStack

This endpoint lists the buying intent topics detected for a company. For each topic, it returns the confidence level (`low`, `medium`, `high`), the number of jobs that mention the topic, and the first and last dates it was mentioned. You must specify `company_domain`, `company_name`, `company_linkedin_url`. It consumes **3 API credits** per company lookup, regardless of the number of buying intent topics returned. It doesn't consume credits if there is no response.

Delete Company List

Build a deep link into the TheirStack app for a given resource and return it as `{"url": ...}`. Pick the resource with the `type` field: `company_list` (view a list), `job_search` / `company_search` (open a search from filters — same filter shape as `search_jobs_v1` / `search_companies_v1`), `saved_search` (open a saved search), or `webhook` (view a webhook). Search links (`job_search` / `company_search`) are workspace-independent — the encoded query opens against whoever's session loads it, so the link is portable when shared. The other types point at a workspace-specific resource and include the workspace, which is taken from the authenticated caller, so it is never passed in.

Retrieve your team's current credit balance including remaining credits available for API calls, searches, and data exports across all endpoints.

Retrieve all ISO country codes with the number of companies headquartered in each country. Use this endpoint for geographic distribution analysis. Calls to this endpoint are free and do not consume any API credits.

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

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. Calls to this endpoint don't cost you credits.

List all keywords tracked by TheirStack, including both technologies and buying intent topics. Search for any keyword and filter by one or more categories. Calls to this endpoint don't cost you credits. - To get technologies only: filter with `keyword_type=technology` - To get only buying intent topics: filter with `keyword_type_not=technology` - By default this endpoint returns 25 keywords. To get all keywords, set `limit=100000`. Response always includes `data` (array of keywords) and `metadata` (total_results, page, limit).

Search for geographic locations by name or ID to retrieve standardized location data including city, region, and country. Use location IDs with job_location_or and job_location_not filters for precise geographic targeting in job searches.

Get List

Export companies from a saved list to a downloadable CSV or XLSX file. The export includes company details such as domain, industry, size, location, funding, and revenue data for offline analysis.

Get Companies From List

Retrieve all company lists for the current team including list name, company count, and creation date. Use company lists to organize and segment companies for targeted outreach and analysis.

Retrieve all datasets available for your team including jobs, companies, and technographics. Datasets are updated daily in Parquet format. Use this endpoint to get the latest download URLs for bulk data access.

Get Email Preferences

Retrieve the daily count of API requests made by your team within a specified date range. Use this endpoint to monitor API usage patterns, identify peak activity periods, and plan capacity.

List your team's individual API and app requests in a time range. Each request reports how many credits it consumed (api_credits, ui_credits), its response time (duration, in seconds), HTTP status code, endpoint type and the number of records returned. Use it to inspect per-request consumption and latency. Defaults to the last 5 days when no dates are given.

Get Saved Search

Retrieve all active saved searches for the current user including search filters, type, and creation date. Archived saved searches are excluded. Filter by user IDs or search type and sort by name, created, or updated date.

Retrieve daily credit consumption data for your team showing the number of API records returned per day. Use this endpoint to monitor usage trends, track spending, and optimize your API integration.

Retrieve the full details of a specific webhook by its ID including configuration, status, target URL, event type, linked saved search, and creation timestamp. Use this to inspect or debug a webhook setup.

Returns supported webhook event types with their metadata. Pass `search_type=jobs` or `search_type=companies` to get only the events relevant to that search type.

Retrieve webhook event counts aggregated by day within a date range, with options to group by delivery status or webhook ID. Use this endpoint to build time-series charts for monitoring webhook performance and reliability.

Get the total count of events triggered for a specific webhook. Use this endpoint to quickly check webhook activity volume without fetching the full event list, useful for monitoring dashboards and usage tracking.

Retrieve a paginated list of all events triggered for a specific webhook including delivery status, payload, and timestamps. Filter by event status to find failed deliveries that may need to be retried.

Retrieve all active webhooks configured for your team including their status, target URL, event type, and linked saved search. Archived webhooks are excluded from the response. Use this to monitor your webhook integrations.

Returns a list of main keyword categories (technologies and buying intents) with the number of keywords and companies in each. Optionally filters to return a specific category if category_slug is provided.

Returns a list of keyword subcategories with their keywords. 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.

Rename Company List

Archive a saved search by its ID to remove it from the active list. Archived searches are hidden from the default listing but can still be referenced. Associated webhooks will stop triggering for archived searches.

Update Saved Search

Archive a webhook by its ID to permanently stop event delivery and remove it from the active webhook list. Archived webhooks and their event history are retained for reference but will no longer trigger notifications.

Update Webhook

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.

Add Companies To Multiple Lists

Add Companies To List

Duplicate List

Remove Companies From List

Create Company List

Generate temporary S3 credentials to directly access and download dataset files from cloud storage. Credentials are valid for 7 days by default and provide read-only access to your team's available datasets.

Create Saved Search

Retry delivery of failed webhook events by providing their event IDs. Use this endpoint to recover from transient failures such as network timeouts or temporary server errors on your receiving endpoint.

Send a test event to verify connectivity and payload handling. Either provide a webhook_id to test an existing webhook (with optional url/secret overrides), or provide url and event_type directly to test before creating a webhook.

Create a new webhook that listens for events from a saved search and sends real-time HTTP POST notifications to your specified URL. Configure event types, filters, and delivery settings for automated data pipelines.

Update Email Preferences

Search and filter companies and accounts by firmographics (industry, country, employee count, revenue), funding, technology and tech stack (technographics), and hiring signals (which roles and technologies they are actively hiring for). Built for ABM, account and lead prospecting, lookalike-account discovery, competitive displacement, and buying-intent targeting. Returns the matching companies along with the jobs and technology objects that matched the filters you passed. 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.

Search and filter job postings (job ads, vacancies, hiring data) from thousands of company career sites and job boards. Filter by job title, keywords in the job description, company (name, domain or LinkedIn URL), location and country, technology and tech stack, salary, seniority, remote/hybrid, employment type, and posting date. Used for sales prospecting and lead generation, recruiting, and hiring-trend and market research. 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)

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

One-Click Unsubscribe (Rfc 8058)

Unsubscribe From Email

One-Click Unsubscribe From A Saved Search Alert (Rfc 8058)

Unsubscribe From A Saved Search Alert