TheirStack
Overview
Find customers ready to buy your product
Use job postings to uncover ready-to-buy companies through analysis of 50 million jobs from over 195 countries.
Setup
Create connector
From the settings panel or from the node catalog, search for the TheirStack integration and navigate to the 'create connector' view.
Retrieve your TheirStack API key
Navigate to your account and access the API keys section. Copy the API key and paste it into the dedicated field in Cargo.
Configure the connector
First, create a name and a slug for your connector. Then, paste your TheirStack API key into the dedicated field.
Actions
Enrich - Technographics
POST : https://api.theirstack.com/v1/companies/technologies
This endpoint lists all the 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, 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. 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.
Required filters
You must specify company_domain, company_name or company_name_or.
Credits
This endpoint consumes 1 API credit per company lookup, regardless of the number of technologies used. It't consumes credits if there is no response.
| Parameter | Default | Optional | Description |
|---|---|---|---|
| company_name | None | No | Company name. Will return companies that match this name exactly, case-sensitively. |
| company_domain | None | Yes | Company domain, full URL or email |
| order_by | None | Yes | 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. |
| offset | None | Yes | Number of results to skip. Required for offset-based pagination. |
| page | None | Yes | Page number. Required when using page-based pagination. |
| limit | None | Yes | Number of results per page. |
| include_total_results | None | Yes | Include a field in the response with the total number of results. |
| technology_slug_or | None | Yes | Will return jobs from companies that that have mentioned any of these technologies in their jobs. Case sensitive. Pass slugs. |
| technology_category_slug_or | None | Yes | Will return jobs from companies that that have mentioned any technology from any of these categories in their jobs Case sensitive. Pass slugs. |
| technology_parent_category_slug_or | None | Yes | Will return jobs from companies that that have mentioned any technology from any of these parent categories in their jobs Case sensitive. Pass slugs. |
| max_rank | None | Yes | The rank measures how common is a technology within its category. |
| min_jobs | None | Yes | Minimum number of jobs found by each company using a technology. |
| max_jobs | None | Yes | Maximum number of jobs found by each company using a technology. |
| min_relative_occurrence | None | Yes | Minimum value of relative_occurrence_within_category for each technology. |
| first_date_found_gte | None | Yes | Only return technologies where the first time they were found was after or on this date. Format: "YYYY-MM-DD" |
| first_date_found_lte | None | Yes | Only return technologies where the first time they were found was before or on this date. Format: "YYYY-MM-DD" |
| last_date_found_gte | None | Yes | Only return technologies where the last time they were found was after or on this date. Format: "YYYY-MM-DD" |
| last_date_found_lte | None | Yes | Only return technologies where the last time they were found was before or on this date. Format: "YYYY-MM-DD" |
| confidence_or | None | Yes | Returns technologies with any of these confidence values that the companies use them. Available values: "high", "medium", "low |