Run in Enrichment Spreadsheet
Use this function as a column step in
deepline enrich.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/) and emails (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. | |
payload.page | integer | No | Page number. Required when using page-based 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 |
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 |
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 |
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 |
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 |
Output Schema
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
result.data | object | Yes | Provider response payload. | |
result.meta | object | No | Additional response metadata (status, paging). |
Advanced: Direct CLI
Use direct execution for single payload debugging.
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.66per pricing unit. - Billing mode:
post_deduct.