---
canonical_url: "https://docs.composio.dev/toolkits/theirstack"
markdown_url: "https://docs.composio.dev/toolkits/theirstack.md"
product: "platform"
version: null
last_updated: null
---

# TheirStack

TheirStack provides job posting, company, and technographic data for sales intelligence, market research, and recruiting workflows.

- **Category:** ai sales tools
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `THEIRSTACK`
- **Version:** 00000000_00

## Tools

### Get Credit Balance

**Slug:** `THEIRSTACK_GET_CREDIT_BALANCE`

Return the connected team's API/UI credit allowances, cumulative usage, and earliest expiration so an agent can budget credit-consuming searches.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Credit Consumption

**Slug:** `THEIRSTACK_GET_CREDIT_CONSUMPTION`

Return daily API and UI credit consumption for an optional time range and timezone to monitor usage trends.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `timezone` | string | No | IANA timezone used to group daily consumption, such as UTC or America/New_York. |
| `end_datetime` | string | No | Inclusive range end as an ISO 8601 datetime. |
| `start_datetime` | string | No | Inclusive range start as an ISO 8601 datetime. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Company Lists

**Slug:** `THEIRSTACK_LIST_COMPANY_LISTS`

List company lists available to the connected team, including IDs and company counts, without modifying list membership.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Datasets

**Slug:** `THEIRSTACK_LIST_DATASETS`

List TheirStack dataset families and whether the connected team is entitled to each one. Never returns signed sample URLs or generates dataset credentials.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Saved Searches

**Slug:** `THEIRSTACK_LIST_SAVED_SEARCHES`

List saved searches available to the connected team without creating, updating, archiving, or unsubscribing anything.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Companies

**Slug:** `THEIRSTACK_SEARCH_COMPANIES`

Search companies by durable identifiers and firmographic, industry, funding, or technology filters. Returns one bounded zero-based page; each returned company costs 3 API credits, and free accounts share a 4/second, 10/minute, 50/hour, and 400/day search limit.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Zero-based result page (0 or greater). |
| `limit` | integer | No | Companies to return on this page (1-25). At 3 API credits per result, the default can cost up to 15 credits. |
| `industry_ids` | array | No | Industry IDs from THEIRSTACK_SEARCH_INDUSTRIES; matches any supplied industry. |
| `company_names` | array | No | Exact case-sensitive company names; matches any supplied name. |
| `country_codes` | array | No | ISO 3166-1 alpha-2 headquarters country codes to match. |
| `funding_stages` | array | No | TheirStack funding stages to match, such as seed, series_a, series_b, or private_equity. |
| `company_domains` | array | No | Exact company domains, full URLs, or email domains to match; prefer this durable identifier when available. |
| `max_revenue_usd` | integer | No | Maximum estimated company revenue in USD. |
| `min_revenue_usd` | integer | No | Minimum estimated company revenue in USD. |
| `technology_slugs` | array | No | Case-sensitive technology slugs from THEIRSTACK_SEARCH_KEYWORDS; matches companies mentioning any supplied technology. |
| `max_employee_count` | integer | No | Maximum company employee count. |
| `min_employee_count` | integer | No | Minimum company employee count. |
| `company_linkedin_urls` | array | No | LinkedIn company URLs, slugs, or numeric IDs to match. |
| `include_total_results` | boolean | No | Calculate totals. Leave false for faster calls; enabling this can significantly slow the request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Industries

**Slug:** `THEIRSTACK_SEARCH_INDUSTRIES`

Find industry names and IDs for company and job filters. This catalog consumes no API credits and returns one zero-based page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Zero-based result page (0 or greater). |
| `limit` | integer | No | Industries to return on this page (1-100). |
| `query` | string | No | Case-insensitive text matched against industry name, hierarchy, or description. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Jobs

**Slug:** `THEIRSTACK_SEARCH_JOBS`

Search current and historical jobs using a required posting-date or company filter, optionally refined by title, location, seniority, salary, industry, or technology. Returns one bounded zero-based page; each returned job costs 1 API credit, and free accounts share a 4/second, 10/minute, 50/hour, and 400/day search limit.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Zero-based result page (0 or greater). |
| `limit` | integer | No | Jobs to return on this page (1-25). Each returned job costs 1 API credit. |
| `remote` | boolean | No | True for remote jobs only or false for non-remote jobs only; omit for both. |
| `job_titles` | array | No | Case-insensitive title phrases; each phrase matches all its words in any order, and multiple phrases are ORed. |
| `seniorities` | array | No | Normalized seniority levels to match. |
| `industry_ids` | array | No | Industry IDs from THEIRSTACK_SEARCH_INDUSTRIES. |
| `location_ids` | array | No | TheirStack location IDs from THEIRSTACK_SEARCH_LOCATIONS; each ID is sent as a structured {id} filter. |
| `company_names` | array | No | Exact case-sensitive company names to match. |
| `country_codes` | array | No | ISO 3166-1 alpha-2 job-location country codes to match. |
| `posted_at_gte` | string | No | Return jobs posted on or after this ISO 8601 date (YYYY-MM-DD). |
| `posted_at_lte` | string | No | Return jobs posted on or before this ISO 8601 date (YYYY-MM-DD). |
| `max_salary_usd` | number | No | Maximum annual salary in USD. |
| `min_salary_usd` | number | No | Minimum annual salary in USD. |
| `company_domains` | array | No | Exact company domains, full URLs, or email domains to match. A match may come from a company's alternate possible_domains, not its primary returned domain. |
| `technology_slugs` | array | No | Case-sensitive technology slugs from THEIRSTACK_SEARCH_KEYWORDS; the provider requires all supplied technologies to appear. |
| `company_linkedin_urls` | array | No | LinkedIn company URLs, slugs, or numeric IDs to match. |
| `include_total_results` | boolean | No | Calculate totals. Leave false for faster calls; enabling this can significantly slow the request. |
| `posted_at_max_age_days` | integer | No | Maximum posting age in days; 0 means today only. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Keywords

**Slug:** `THEIRSTACK_SEARCH_KEYWORDS`

Find TheirStack technology and other semantic keyword slugs. Technology-type slugs can be used in company and job technology filters; other types are for catalog discovery. This catalog consumes no API credits and returns one zero-based page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Zero-based result page (0 or greater). |
| `limit` | integer | No | Keywords to return on this page (1-100). |
| `query` | string | No | Case-insensitive search across keyword name, type, category, and parent category. |
| `slugs` | array | No | Return keywords whose slugs exactly match one of these values. |
| `keyword_type` | string ("technology" | "software_product" | "technology_concept" | "operational_activity" | "strategic_initiative" | "metric_or_concept" | "product_or_service_offered" | "regulation" | "threat_or_risk" | "event" | "commodity" | "industry_vertical" | "physical_equipment" | "medical_research" | "government_body") | No | Return only keywords in one provider-defined semantic type. |
| `category_slug` | string | No | Return keywords in this category slug. |
| `parent_category_slug` | string | No | Return keywords in this parent-category slug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Locations

**Slug:** `THEIRSTACK_SEARCH_LOCATIONS`

Resolve place names or country and feature filters to TheirStack location IDs for precise job searches. Returns one bounded offset page; the provider does not document this endpoint's credit cost or return a total/next token.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Location name text, such as Paris. |
| `limit` | integer | No | Locations to return (1-100). |
| `offset` | integer | No | Zero-based result offset. |
| `country_code` | string | No | ISO 3166-1 alpha-2 country code. |
| `location_ids` | array | No | Exact TheirStack location IDs to resolve. |
| `feature_codes` | array | No | GeoNames feature codes such as PPL for populated place or ADM1 for first-order administrative division. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |