> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Theirstack Technographics: Inputs, Cost & CLI Example
> Getting the detected technology stack for a specific company. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=theirstack_technographics:{}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| -------------------------------------------- | --------- | -------- | --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.company_id` | `string` | No | | Only return companies that match this TheirStack Company ID exactly. This ID is temporary and internal and will change in the future and become stable. Until then, it is only meant to be used internally by our UI (app.theirstack.com). For deduplication logic, use company\_domain or company\_linkedin\_url instead. |
| `payload.company_name` | `string` | No | | Only return companies that match this name exactly, case-sensitively. |
| `payload.company_domain` | `string` | No | | Only return companies that match this domain exactly. It accepts full urls ([https://www.google.com/](https://www.google.com/)) and emails ([john.polo@gmail.com](mailto:john.polo@gmail.com)). |
| `payload.company_linkedin_url` | `string` | No | | Return companies whose LinkedIn URL matches this URL exactly. |
| `payload.company_name_or` | `array` | No | `[]` | Only return companies that match these names exactly, case-sensitively. Deprecated, use the `company_name` filter instead. |
| `payload.order_by` | `array` | No | `[{"desc":true,"field":"confidence"},{"desc":true,"field":"jobs"}]` | List of column objects. You can pass several columns to order by, in order of priority. Only `field` is required, `desc` is True by default. |
| `payload.include_total_results` | `boolean` | No | `false` | When enabled, calculates and returns `total_results` and `total_companies` fields in the response. WARNING: This significantly slows down responses as it requires reading the entire dataset. Recommended usage: enable only for the initial request to get totals, then disable for subsequent pagination requests. |
| `payload.offset` | `integer` | No | | Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination). |
| `payload.page` | `integer` | No | | Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination). |
| `payload.limit` | `integer` | No | | Number of results per page. Maximum 500 per page; use `page` to fetch additional pages. |
| `payload.keyword_slug_or` | `array` | No | `[]` | Return companies that have mentioned any of these keywords (technologies or buying intent topics) in their jobs. Case sensitive. Pass slugs. Check out all keywords at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0) |
| `payload.keyword_category_slug_or` | `array` | No | `[]` | Return companies that have mentioned any keyword from any of these categories in their jobs. Case sensitive. Pass slugs. Check out all keyword categories at [GET /v0/catalog/keywords/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_categories_v0) |
| `payload.keyword_parent_category_slug_or` | `array` | No | `[]` | Return companies that have mentioned any keyword from any of these parent categories in their jobs. Case sensitive. Pass slugs. Check out all keyword categories at [GET /v0/catalog/keywords/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_categories_v0) |
| `payload.technology_slug_or` | `array` | No | `[]` | Deprecated: use `keyword_slug_or` instead. Will return companies that have mentioned any of these technologies in their jobs. Case sensitive. Pass slugs. |
| `payload.technology_category_slug_or` | `array` | No | `[]` | Deprecated: use `keyword_category_slug_or` instead. Will return companies that have mentioned any keyword from any of these categories in their jobs. Case sensitive. Pass slugs. |
| `payload.technology_parent_category_slug_or` | `array` | No | `[]` | Deprecated: use `keyword_parent_category_slug_or` instead. Will return companies that have mentioned any keyword from any of these parent categories in their jobs. Case sensitive. Pass slugs. |
| `payload.max_rank` | `integer` | No | | The rank measures how common is a technology within its category. The technology most used among similar ones by a company will have a rank of 1, the second: 2, etc. This is useful to filter results by technology and get only results for the primary technology. |
| `payload.min_jobs` | `integer` | No | | Minimum number of jobs found by each company using a technology |
| `payload.max_jobs` | `integer` | No | | Maximum number of jobs found by each company using a technology |
| `payload.min_relative_occurrence` | `number` | No | | Minimum value of relative\_occurrence\_within\_category for each technology. Higher values increase the probability that this technology is actually used by the company, because it means a higher percentage of mentions to technologies among this category are of this technology. |
| `payload.first_date_found_gte` | `string` | No | | Only return technologies where the first time they were found was after or on this date. Format: "YYYY-MM-DD" |
| `payload.first_date_found_lte` | `string` | No | | Only return technologies where the first time they were found was before or on this date. Format: "YYYY-MM-DD" |
| `payload.last_date_found_gte` | `string` | No | | Only return technologies where the last time they were found was after or on this date. Format: "YYYY-MM-DD" |
| `payload.last_date_found_lte` | `string` | No | | Only return technologies where the last time they were found was before or on this date. Format: "YYYY-MM-DD" |
| `payload.confidence_or` | `array` | No | `[]` | Returns technologies with any of these confidence values that the companies use them. Available values: "high", "medium", "low" |
| `payload.company_keyword_slug_or` | `array` | No | `[]` | Return companies that have mentioned any of these keywords (technologies or buying intent topics) in their jobs. Case sensitive. Pass slugs. Check out all keywords at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0) |
| `payload.company_technology_slug_or` | `array` | No | `[]` | Return companies that have mentioned any of these keywords (technologies or buying intent topics) in their jobs. Case sensitive. Pass slugs. Check out all keywords at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0) |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Filter technologies and buying intent topics detected for a company.",
"properties": {
"company_id": {
"type": [
"string",
"null"
],
"description": "Only return companies that match this TheirStack Company ID exactly. This ID is temporary and internal and will change in the future and become stable. Until then, it is only meant to be used internally by our UI (app.theirstack.com). For deduplication logic, use company_domain or company_linkedin_url instead."
},
"company_name": {
"type": [
"string",
"null"
],
"description": "Only return companies that match this name exactly, case-sensitively."
},
"company_domain": {
"type": [
"string",
"null"
],
"description": "Only return companies that match this domain exactly. It accepts full urls (https://www.google.com/) and emails (john.polo@gmail.com)."
},
"company_linkedin_url": {
"type": [
"string",
"null"
],
"description": "Return companies whose LinkedIn URL matches this URL exactly."
},
"company_name_or": {
"type": "array",
"description": "Only return companies that match these names exactly, case-sensitively. Deprecated, use the `company_name` filter instead.",
"default": [],
"items": {
"type": "string"
}
},
"order_by": {
"type": "array",
"description": "List of column objects. You can pass several columns to order by, in order of priority. Only `field` is required, `desc` is True by default.",
"default": [
{
"desc": true,
"field": "confidence"
},
{
"desc": true,
"field": "jobs"
}
],
"items": {
"type": "object",
"properties": {
"desc": {
"type": "boolean",
"description": "Whether to order by descending or ascending values",
"default": true
},
"field": {
"description": "Order the results by some of these fields",
"enum": [
null,
"jobs",
"jobs_last_7_days",
"jobs_last_30_days",
"jobs_last_180_days",
"last_date_found",
"first_date_found",
"relative_occurrence_within_category",
"theirstack_score",
"confidence"
]
}
},
"additionalProperties": false
}
},
"include_total_results": {
"type": [
"boolean",
"null"
],
"description": "When enabled, calculates and returns `total_results` and `total_companies` fields in the response. WARNING: This significantly slows down responses as it requires reading the entire dataset. Recommended usage: enable only for the initial request to get totals, then disable for subsequent pagination requests.",
"default": false
},
"offset": {
"type": [
"integer",
"null"
],
"description": "Number of results to skip. Required for [offset-based pagination](https://theirstack.com/en/docs/api-reference/pagination).",
"minimum": 0
},
"page": {
"type": [
"integer",
"null"
],
"description": "Page number. Required when using [page-based pagination](https://theirstack.com/en/docs/api-reference/pagination).",
"minimum": 0
},
"limit": {
"type": [
"integer",
"null"
],
"description": "Number of results per page. Maximum 500 per page; use `page` to fetch additional pages.",
"minimum": 1
},
"keyword_slug_or": {
"type": "array",
"description": "Return companies that have mentioned any of these keywords (technologies or buying intent topics) in their jobs. Case sensitive. Pass slugs. Check out all keywords at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)",
"default": [],
"items": {
"type": "string"
}
},
"keyword_category_slug_or": {
"type": "array",
"description": "Return companies that have mentioned any keyword from any of these categories in their jobs. Case sensitive. Pass slugs. Check out all keyword categories at [GET /v0/catalog/keywords/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_categories_v0)",
"default": [],
"items": {
"type": "string"
}
},
"keyword_parent_category_slug_or": {
"type": "array",
"description": "Return companies that have mentioned any keyword from any of these parent categories in their jobs. Case sensitive. Pass slugs. Check out all keyword categories at [GET /v0/catalog/keywords/categories](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_categories_v0)",
"default": [],
"items": {
"type": "string"
}
},
"technology_slug_or": {
"type": "array",
"description": "Deprecated: use `keyword_slug_or` instead. Will return companies that have mentioned any of these technologies in their jobs. Case sensitive. Pass slugs.",
"default": [],
"items": {
"type": "string"
}
},
"technology_category_slug_or": {
"type": "array",
"description": "Deprecated: use `keyword_category_slug_or` instead. Will return companies that have mentioned any keyword from any of these categories in their jobs. Case sensitive. Pass slugs.",
"default": [],
"items": {
"type": "string"
}
},
"technology_parent_category_slug_or": {
"type": "array",
"description": "Deprecated: use `keyword_parent_category_slug_or` instead. Will return companies that have mentioned any keyword from any of these parent categories in their jobs. Case sensitive. Pass slugs.",
"default": [],
"items": {
"type": "string"
}
},
"max_rank": {
"type": [
"integer",
"null"
],
"description": "The rank measures how common is a technology within its category. The technology most used among similar ones by a company will have a rank of 1, the second: 2, etc. This is useful to filter results by technology and get only results for the primary technology."
},
"min_jobs": {
"type": [
"integer",
"null"
],
"description": "Minimum number of jobs found by each company using a technology"
},
"max_jobs": {
"type": [
"integer",
"null"
],
"description": "Maximum number of jobs found by each company using a technology"
},
"min_relative_occurrence": {
"type": [
"number",
"null"
],
"description": "Minimum value of relative_occurrence_within_category for each technology. Higher values increase the probability that this technology is actually used by the company, because it means a higher percentage of mentions to technologies among this category are of this technology."
},
"first_date_found_gte": {
"type": [
"string",
"null"
],
"description": "Only return technologies where the first time they were found was after or on this date. Format: \"YYYY-MM-DD\"",
"format": "date"
},
"first_date_found_lte": {
"type": [
"string",
"null"
],
"description": "Only return technologies where the first time they were found was before or on this date. Format: \"YYYY-MM-DD\"",
"format": "date"
},
"last_date_found_gte": {
"type": [
"string",
"null"
],
"description": "Only return technologies where the last time they were found was after or on this date. Format: \"YYYY-MM-DD\"",
"format": "date"
},
"last_date_found_lte": {
"type": [
"string",
"null"
],
"description": "Only return technologies where the last time they were found was before or on this date. Format: \"YYYY-MM-DD\"",
"format": "date"
},
"confidence_or": {
"type": "array",
"description": "Returns technologies with any of these confidence values that the companies use them. Available values: \"high\", \"medium\", \"low\"",
"default": [],
"items": {
"type": "string",
"enum": [
"low",
"medium",
"high"
]
}
},
"company_keyword_slug_or": {
"type": "array",
"description": "Return companies that have mentioned any of these keywords (technologies or buying intent topics) in their jobs. Case sensitive. Pass slugs. Check out all keywords at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)",
"default": [],
"items": {
"type": "string"
}
},
"company_technology_slug_or": {
"type": "array",
"description": "Return companies that have mentioned any of these keywords (technologies or buying intent topics) in their jobs. Case sensitive. Pass slugs. Check out all keywords at [GET /v0/catalog/keywords](https://theirstack.com/en/docs/api-reference/catalog/get_catalog_keywords_v0)",
"default": [],
"items": {
"type": "string"
}
}
},
"required": [],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | | Provider response payload. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Provider response payload.",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"description": "Response schema for /companies/keywords (no deprecated fields).",
"properties": {
"technology": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
],
"description": "Category of the keyword"
},
"type": {
"type": [
"string",
"null"
],
"description": "Type of the keyword (e.g. technology, operational_activity)",
"enum": [
"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"
]
},
"slug": {
"type": "string",
"description": "Slug of the keyword"
},
"category_slug": {
"type": [
"string",
"null"
],
"description": "Slug of the category of the keyword"
},
"parent_category": {
"type": [
"string",
"null"
],
"description": "Parent category of the keyword"
},
"parent_category_slug": {
"type": [
"string",
"null"
],
"description": "Slug of the parent category of the keyword"
},
"logo": {
"type": [
"string",
"null"
],
"description": "Logo of the keyword"
},
"logo_thumbnail": {
"type": [
"string",
"null"
],
"description": "Thumbnail of the keyword"
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
},
"confidence": {
"type": "string",
"description": "How confident we are that the company uses this technology",
"enum": [
"low",
"medium",
"high"
]
},
"jobs": {
"type": "integer",
"description": "Number of jobs found mentioning this technology"
},
"jobs_last_7_days": {
"type": "integer",
"description": "Number of jobs from the given company mentioning this technology in the last 7 days"
},
"jobs_last_30_days": {
"type": "integer",
"description": "Number of jobs from the given company mentioning this technology in the last 30 days"
},
"jobs_last_180_days": {
"type": "integer",
"description": "Number of jobs from the given company mentioning this technology in the last 180 days"
},
"first_date_found": {
"type": "string",
"description": "Date when the keyword was first mentioned by the company in a job post",
"format": "date"
},
"last_date_found": {
"type": "string",
"description": "Date when the keyword was last mentioned by the company in a job post",
"format": "date"
},
"rank_within_category": {
"type": "integer",
"description": "Measures how common this technology is among the company's jobs, compared to other technologies in the same category. The most mentioned technology in its category will have a rank of 1. This helps you infer which is the technology the company is most likely to be using, when they mention several technologies that belong to the same category."
},
"relative_occurrence_within_category": {
"type": "number",
"description": "Measures the relative occurance of this technology among other technologies in the same category, in jobs by this company. If there are 10 jobs where a company mentions 3 categories, and they appear in 8, 3 and 2 jobs respectively, its relative occurrences will be 0.8, 0.3 and 0.2. This helps you infer how likely it is that the company is using this technology, when they mention several technologies that belong to the same category."
}
},
"required": [
"technology",
"confidence",
"jobs",
"jobs_last_7_days",
"jobs_last_30_days",
"jobs_last_180_days",
"first_date_found",
"last_date_found",
"rank_within_category",
"relative_occurrence_within_category"
],
"additionalProperties": false
}
},
"metadata": {
"type": "object",
"properties": {
"total_results": {
"type": [
"integer",
"null"
],
"description": "Total number of results"
},
"truncated_results": {
"type": [
"integer",
"null"
],
"description": "Number of results that were not returned because the user doesn't have enough credits to fetch them all the possible results the API could have returned",
"default": 0
},
"truncated_companies": {
"type": [
"integer",
"null"
],
"description": "Number of companies that were not returned because the user doesn't have enough credits to fetch all the possible results the API could have returned",
"default": 0
},
"total_companies": {
"type": [
"integer",
"null"
],
"description": "Total number of companies"
}
},
"additionalProperties": false
}
},
"required": [
"data",
"metadata"
],
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute theirstack_technographics --payload '{}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `per_result` (per result).
* Estimated Deepline credits: `1.66` per pricing unit.
* Billing mode: `post_deduct`.