> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TheirStack

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

![TheirStack logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/theirstack.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=94d564b8d6489dba3951e859010a6c90)

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

## Tools

> [accordion] 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **timezone** `string`
>
> IANA timezone used to group daily consumption, such as UTC or America/New\_York.
>
> **end\_datetime** `string`
>
> Inclusive range end as an ISO 8601 datetime.
>
> **start\_datetime** `string`
>
> Inclusive range start as an ISO 8601 datetime.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Saved Searches
>
> **Slug:** `THEIRSTACK_LIST_SAVED_SEARCHES`
>
> List saved searches available to the connected team without creating, updating, archiving, or unsubscribing anything.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Companies
>
> **Slug:** `THEIRSTACK_SEARCH_COMPANIES`
>
> Search companies by identifiers and firmographic, industry, funding, or technology filters, returning one bounded zero-based page. Each returned company costs 3 API credits, but the balance must cover the full requested limit; free accounts share a 4/second, 10/minute, 50/hour, and 400/day search limit.
>
> #### Input Parameters
>
> **page** `integer`
>
> Zero-based result page (0 or greater).
>
> **limit** `integer`
>
> 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`
>
> Industry IDs from THEIRSTACK\_SEARCH\_INDUSTRIES; matches any supplied industry.
>
> **company\_names** `array`
>
> Exact case-sensitive company names; matches any supplied name.
>
> **country\_codes** `array`
>
> ISO 3166-1 alpha-2 headquarters country codes to match.
>
> **funding\_stages** `array`
>
> TheirStack funding stages to match, such as seed, series\_a, series\_b, or private\_equity.
>
> **company\_domains** `array`
>
> Exact company domains, full URLs, or email domains to match; prefer this durable identifier when available.
>
> **max\_revenue\_usd** `integer`
>
> Maximum estimated company revenue in USD.
>
> **min\_revenue\_usd** `integer`
>
> Minimum estimated company revenue in USD.
>
> **technology\_slugs** `array`
>
> Case-sensitive technology slugs from THEIRSTACK\_SEARCH\_KEYWORDS; matches companies mentioning any supplied technology.
>
> **max\_employee\_count** `integer`
>
> Maximum company employee count.
>
> **min\_employee\_count** `integer`
>
> Minimum company employee count.
>
> **company\_linkedin\_urls** `array`
>
> LinkedIn company URLs, slugs, or numeric IDs to match.
>
> **include\_total\_results** `boolean`
>
> Calculate totals. Leave false for faster calls; enabling this can significantly slow the request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **page** `integer`
>
> Zero-based result page (0 or greater).
>
> **limit** `integer`
>
> Industries to return on this page (1-100).
>
> **query** `string`
>
> Case-insensitive text matched against industry name, hierarchy, or description.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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, returning one bounded zero-based page. Each returned job costs 1 API credit, but the balance must cover the full requested limit; free accounts share a 4/second, 10/minute, 50/hour, and 400/day search limit.
>
> #### Input Parameters
>
> **page** `integer`
>
> Zero-based result page (0 or greater).
>
> **limit** `integer`
>
> Jobs to return on this page (1-25). Each returned job costs 1 API credit.
>
> **remote** `boolean`
>
> True for remote jobs only or false for non-remote jobs only; omit for both.
>
> **job\_titles** `array`
>
> Case-insensitive title phrases; each phrase matches all its words in any order, and multiple phrases are ORed.
>
> **seniorities** `array`
>
> Normalized seniority levels to match.
>
> **industry\_ids** `array`
>
> Industry IDs from THEIRSTACK\_SEARCH\_INDUSTRIES.
>
> **location\_ids** `array`
>
> TheirStack location IDs from THEIRSTACK\_SEARCH\_LOCATIONS; each ID is sent as a structured \{id} filter.
>
> **company\_names** `array`
>
> Exact case-sensitive company names to match.
>
> **country\_codes** `array`
>
> ISO 3166-1 alpha-2 job-location country codes to match.
>
> **posted\_at\_gte** `string`
>
> Return jobs posted on or after this ISO 8601 date (YYYY-MM-DD).
>
> **posted\_at\_lte** `string`
>
> Return jobs posted on or before this ISO 8601 date (YYYY-MM-DD).
>
> **max\_salary\_usd** `number`
>
> Maximum annual salary in USD.
>
> **min\_salary\_usd** `number`
>
> Minimum annual salary in USD.
>
> **company\_domains** `array`
>
> 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`
>
> Case-sensitive technology slugs from THEIRSTACK\_SEARCH\_KEYWORDS; the provider requires all supplied technologies to appear.
>
> **company\_linkedin\_urls** `array`
>
> LinkedIn company URLs, slugs, or numeric IDs to match.
>
> **include\_total\_results** `boolean`
>
> Calculate totals. Leave false for faster calls; enabling this can significantly slow the request.
>
> **posted\_at\_max\_age\_days** `integer`
>
> Maximum posting age in days; 0 means today only.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **page** `integer`
>
> Zero-based result page (0 or greater).
>
> **limit** `integer`
>
> Keywords to return on this page (1-100).
>
> **query** `string`
>
> Case-insensitive search across keyword name, type, category, and parent category.
>
> **slugs** `array`
>
> 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")`
>
> Return only keywords in one provider-defined semantic type.
>
> **category\_slug** `string`
>
> Return keywords in this category slug.
>
> **parent\_category\_slug** `string`
>
> Return keywords in this parent-category slug.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] 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
>
> **name** `string`
>
> Location name text, such as Paris.
>
> **limit** `integer`
>
> Locations to return (1-100).
>
> **offset** `integer`
>
> Zero-based result offset.
>
> **country\_code** `string`
>
> ISO 3166-1 alpha-2 country code.
>
> **location\_ids** `array`
>
> Exact TheirStack location IDs to resolve.
>
> **feature\_codes** `array`
>
> GeoNames feature codes such as PPL for populated place or ADM1 for first-order administrative division.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
