> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcargo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# TheirStack

> Connect TheirStack to discover companies and job postings by technology stack in your workflows.

## How to set up TheirStack

### Authentication

TheirStack uses API key authentication:

1. Sign up at [theirstack.com](https://theirstack.com)
2. Navigate to your API settings
3. Copy your API key
4. Paste the API key in Cargo when connecting

## TheirStack actions

### Search companies

Find companies based on hiring signals and technology usage.

**Company filters:**

| Filter              | Description                          |
| ------------------- | ------------------------------------ |
| Revenue             | Revenue range in USD                 |
| Employee count      | Number of employees                  |
| Company type        | Type of company                      |
| Industries          | LinkedIn industry codes              |
| YC companies only   | Filter to Y Combinator companies     |
| Company name/domain | Exact or partial matching            |
| LinkedIn URL        | Company LinkedIn page                |
| Description pattern | Regex search in company descriptions |
| Country/location    | Geographic filters                   |
| Technologies        | Tech stack filters (OR/AND/NOT)      |
| Funding             | Funding amount and stage             |
| Investors           | Filter by investors                  |

**Job filters (for companies with matching jobs):**

| Filter           | Description                      |
| ---------------- | -------------------------------- |
| Job title        | Title patterns (regex supported) |
| Job seniority    | Level filters                    |
| Job description  | Content matching                 |
| Job location     | Geographic filters               |
| Remote           | Remote job filter                |
| Job technologies | Tech mentioned in job postings   |
| Salary range     | Compensation filters             |
| Posted date      | Job posting date range           |

**Use case:** Find companies actively hiring for specific technologies.

### Search jobs

Find job postings with detailed filtering.

**Job filters:** Same as company search job filters.

**Company filters:** Same as company search company filters.

**Credits:** 0.5 credits per result

**Use case:** Discover companies hiring for specific roles and technologies.

### Search technologies

Find companies by their technology usage patterns.

**Technology filters:**

| Filter                | Description                  |
| --------------------- | ---------------------------- |
| Technology slug       | Specific technologies        |
| Technology category   | Technology categories        |
| Parent category       | High-level technology groups |
| Confidence            | High/medium/low confidence   |
| Max rank              | Technology importance rank   |
| Relative occurrence   | Usage frequency              |
| Min/max jobs          | Job count with technology    |
| First/last date found | Discovery timeline           |

**Credits:** 0.5 credits (fixed)

**Use case:** Find companies adopting or using specific technologies.

## TheirStack data models

### Fetch companies

Pull companies matching your criteria into Cargo.

**Configuration:** Same as search companies.

**Features:**

* Incremental sync (daily)
* Unifies accounts by domain and LinkedIn
* 0.5 credits per result

### Fetch jobs

Pull job postings into Cargo.

**Configuration:** Same as search jobs.

**Features:**

* Incremental sync (daily)
* 0.5 credits per result

## Credits

| Action              | Credits        |
| ------------------- | -------------- |
| Search companies    | Per result     |
| Search jobs         | 0.5 per result |
| Search technologies | 0.5 (fixed)    |
| Fetch companies     | 0.5 per result |
| Fetch jobs          | 0.5 per result |

## Rate limits

TheirStack API has a rate limit of 4 requests per second. Cargo handles rate limiting automatically.

## Best practices

* Use technology filters to find companies by their tech stack
* Combine job and company filters for precise targeting
* Use job posting recency for hiring intent signals
* Filter by funding stage for growth-stage companies
* Leverage description patterns for niche use cases