Integration guide for sales intelligence software
This guide provides detailed instructions on integrating TheirStack into your product, including all possible connectors, marketing content and best practices.
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
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.
Integration Methods
TheirStack offers two ways to integrate our data into your platform:
-
On-Demand Actions (API): When your users actively request information, such as finding companies using specific software, discovering developer jobs posted in the US, searching for companies by technology stack, or finding job postings with specific criteria.
-
Real-Time Signal Listening (Webhooks): Keep your users informed with automatic updates about new job postings matching their criteria, companies adopting new technologies, and changes to existing job postings.
How API credits work
API credits are used to make API requests. One API Credit is consumed for each record (job or company) returned from our API endpoints.
How API credits work:
- Credits are only consumed when the API returns data in the response.
- Each API call is processed independently - repeated requests for the same data will consume credits each time.
- Unused paid credits will roll over and accumulate in your account.
Auto recharge credits
We know you want to make sure our users never lose access because of sudden demand, and be able to scale up or down easily.
Free records count
Get the count of records that match your search criteria is free. This is useful to show a preview to your end users.
Preview mode
Our Job Search and Company Search endpoints include a preview mode that does not consume credits. Use this mode to display a preview for your end users by using the blur_company_data
field.
Connectors
Search jobs
Content
Short description
Long description
Technical details
Endpoint documentation: https://api.theirstack.com/#tag/jobs/POST/v1/jobs/search
Recommended filters sorted by importance:
Order | Filter | Description | API Field |
---|---|---|---|
1 | Posted date (required) | Last n days (default 30 days). | posted_at_max_age_days , posted_at_gte , posted_at_lte |
2 | Job Country | Include countries (1 to n values). Exclude countries (1 to n values). | job_country_code_or (recommended), job_country_code_not |
3 | Job Title | Include any of these keywords in the job title (tags format, 1 to n values). Exclude keywords. | job_title_or (recommended), job_title_not |
4 | Job Description | Include any of these keywords in the job description (tags format, 1 to n values). Exclude keywords. | job_description_pattern_or , job_description_pattern_not |
5 | Job Location | Include City. Text match. List of strings. Exclude City. Text match, List of strings. | job_location_pattern_or , job_location_pattern_not |
6 | Job Technologies | Include technologies mentioned in the job description. Exclude technologies. | company_technology_slug_or , company_technology_slug_and |
7 | Is a remote position | Yes or no. | N/A |
8 | Company Industry | List of IDs, IDs available with this endpoint. | Industry IDs |
9 | Company Headcount | Look for "employee_count" in the endpoint docs. | Employee Count |
10 | Company Headquarters Country | company_country_code_or |
Search companies by tech stack
Content
Short description
Long description
Technical details
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 |
Get a company's tech stack
Content
Short description
Long description
Technical details
Endpoint documentation: https://api.theirstack.com/#tag/companies/POST/v1/companies/technologies
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 |
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.
Title
Subtitle
Description
How is this guide?
Last updated on
Monitoring open jobs from current and past customers
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.
Users and Teams
Learn about users and teams in TheirStack.