Theirstack · Jobs

TheirStack API Reference / Technographics

Lists the technologies a company uses, each with a confidence level (low, medium, high), the number of job posts that mention it, and the first and last dates it was seen. Send companydomain, companyname or companylinkedinurl, and limit (1 to 25). 3 TheirStack credits per company found; no charge when nothing is found.

Private Gateway connection

Data below comes from the configured private Gateway. Provider activation remains governed by its evidence and policy gates.

unverifiedRequest shape unavailableUnverified

Published API evidence

Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

company_domain body · optional
Only return companies that match this domain exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com).
company_id body · optional
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.
company_linkedin_url body · optional
Return companies whose LinkedIn URL matches this URL exactly.
company_name body · optional
Only return companies that match this name exactly, case-sensitively.
company_name_or body · optional
Only return companies that match these names exactly, case-sensitively. Deprecated, use the `company_name` filter instead.
confidence_or body · optional
Returns technologies with any of these confidence values that the companies use them. Available values: "high", "medium", "low"
first_date_found_gte body · optional
Only return technologies where the first time they were found was after or on this date. Format: "YYYY-MM-DD"
first_date_found_lte body · optional
Only return technologies where the first time they were found was before or on this date. Format: "YYYY-MM-DD"
include_total_results body · optional
When enabled, calculates and returns `total_results` and `total_companies` fields in the response. WARNING: This significantly slows down responses as it requires reading the entire dataset. Recommended usage: enable only for the initial request to get totals, then disable for subsequent pagination requests.
keyword_category_slug_or body · optional
Return companies that have mentioned any keyword from any of these categories in their jobs. Case sensitive. Pass slugs. Check out all keyword categories at [GET /v0/catalog/keywords/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_categories_v0)
keyword_parent_category_slug_or body · optional
Return companies that have mentioned any keyword from any of these parent categories in their jobs. Case sensitive. Pass slugs. Check out all keyword categories at [GET /v0/catalog/keywords/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_categories_v0)
keyword_slug_or body · optional
Return companies that have mentioned any of these keywords (technologies or buying intent topics) in their jobs. Case sensitive. Pass slugs. Check out all keywords at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)
last_date_found_gte body · optional
Only return technologies where the last time they were found was after or on this date. Format: "YYYY-MM-DD"
last_date_found_lte body · optional
Only return technologies where the last time they were found was before or on this date. Format: "YYYY-MM-DD"
limit body · required
Number of results per page Bounded 1-25 by looot; required, see endpoint description. Example: 1
max_jobs body · optional
Maximum number of jobs found by each company using a technology
max_rank body · optional
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.
min_jobs body · optional
Minimum number of jobs found by each company using a technology
min_relative_occurrence body · optional
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.
offset body · optional
Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination). Example: 0
order_by body · optional
List of column objects. You can pass several columns to order by, in order of priority. Only `field` is required, `desc` is True by default.
page body · optional
Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination). Example: 0
technology_category_slug_or body · optional
Deprecated: use `keyword_category_slug_or` instead. Will return companies that have mentioned any keyword from any of these categories in their jobs. Case sensitive. Pass slugs.
technology_parent_category_slug_or body · optional
Deprecated: use `keyword_parent_category_slug_or` instead. Will return companies that have mentioned any keyword from any of these parent categories in their jobs. Case sensitive. Pass slugs.
technology_slug_or body · optional
Deprecated: use `keyword_slug_or` instead. Will return companies that have mentioned any of these technologies in their jobs. Case sensitive. Pass slugs.

Provider docs How to run it