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

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.

Long description

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

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

Find companies by the technology they use.

Long description

**Overview:**
Discover companies using any of our 21K 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.

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

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.

Long description

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

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

TheirStack

Subtitle

TheirStack helps you find job postings and find companies by tech stack.

Description

TheirStack is the largest job posting and technographics database, designed to help businesses, recruiters, and sales teams identify opportunities with companies based on their technology stack and hiring needs. With a vast collection of data on which technologies companies use, along with real-time job listings, TheirStack provides a comprehensive platform for discovering leads, qualifying prospects, and strategically targeting outreach efforts.
 
Through TheirStack's Job Postings data, users can access millions of job listings aggregated from multiple global sources, including major job boards, offering a complete view of the job market across 195 countries. The platform's robust filtering options allow users to refine searches by job role, company, and required technology, giving a nuanced perspective on hiring trends and job quality. This empowers recruiters and business developers to target roles and companies with precision, ensuring outreach is both relevant and impactful.
 
TheirStack's Technographics data enables users to search for companies by their technology stack, providing detailed insights into tech adoption across industries. This feature supports sales and marketing teams in identifying high-potential leads based on specific technology use, allowing for strategic alignment with each company's tech landscape. Combining job market insights with technographic data, TheirStack delivers a strategic advantage for more informed and effective decision-making.

Integration guide for sales intelligence software

On this page