> ## 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.
# Bloomberry Get Tech Stack Changes: Inputs, Cost & CLI
> Returns companies that added or removed a specific tech vendor or ANY tech vendor within a specific category, sorted by most recent first Need an API key?
## 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=bloomberry_get_tech_stack_changes:{}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ------------------------------------- | --------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.next_token` | `string` | No | | Pagination token from previous response (located in "pagination" > "next\_token") to fetch the next page. Leave blank for the first page |
| `payload.limit` | `integer` | No | `20` | Signals per page |
| `payload.begin_date` | `string` | No | | Start date. Defaults to the first date in our dataset. |
| `payload.end_date` | `string` | No | | End date. Defaults to end of today. |
| `payload.category` | `string` | No | | The product category to get tech stack changes for. All possible product categories are available at [https://api.revealera.com/categories.txt](https://api.revealera.com/categories.txt). Pass "all" to get changes for all categories. Note: ONLY 1 of category OR vendor\_name MUST be specified, but no more than 1. |
| `payload.vendor_name` | `string` | No | | The vendor\_name to get tech stack changes for. For example, 'Google Workspace' to get tech stack changes for Google Workspace. Note: ONLY 1 of category OR vendor\_name MUST be specified, but no more than 1. All possible vendor names can be found here: [https://api.revealera.com/vendors.txt](https://api.revealera.com/vendors.txt) |
| `payload.churn_only` | `string` | No | `false` | true if you want to see churn changes only. false if you want to see all changes, including churn |
| `payload.new_only` | `string` | No | `false` | true if you want to see new installs or new usage changes only. false otherwise |
| `payload.company_employee_size_range` | `string` | No | | Only show tech stack changes from companies with number of employees that match the specified size ranges. Possible ranges are 1 employee, 2-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, 10,001+. Separate multiple values with semicolon. |
| `payload.company_industry` | `string` | No | | Only show tech stack changes from companies in the specified industries. We look at the LinkedIn company page to determine industries. All possible industries are available at [https://api.revealera.com/linkedin\_industries.txt](https://api.revealera.com/linkedin_industries.txt) . Separate multiple values with semicolon. |
| `payload.company_country` | `string` | No | | Only show tech stack changes from companies headquartered in the specified countries. Country codes must be in ISO 3166-1 alpha-2 format. Separate multiple values with semicolon. |
| `payload.omit_linkedin_data` | `string` | No | `false` | true if you to omit linkedin-related fields from the response (ie for compliance reasons) |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Returns companies that added or removed a specific tech vendor or ANY tech vendor within a specific category, sorted by most recent first Need an API key? Get a free API key here",
"properties": {
"next_token": {
"type": "string",
"description": "Pagination token from previous response (located in \"pagination\" > \"next_token\") to fetch the next page. Leave blank for the first page"
},
"limit": {
"type": "integer",
"description": "Signals per page",
"default": 20,
"minimum": 1,
"maximum": 20
},
"begin_date": {
"type": "string",
"description": "Start date. Defaults to the first date in our dataset.",
"format": "date"
},
"end_date": {
"type": "string",
"description": "End date. Defaults to end of today.",
"format": "date"
},
"category": {
"type": "string",
"description": "The product category to get tech stack changes for. All possible product categories are available at https://api.revealera.com/categories.txt. Pass \"all\" to get changes for all categories. Note: ONLY 1 of category OR vendor_name MUST be specified, but no more than 1."
},
"vendor_name": {
"type": "string",
"description": "The vendor_name to get tech stack changes for. For example, 'Google Workspace' to get tech stack changes for Google Workspace. Note: ONLY 1 of category OR vendor_name MUST be specified, but no more than 1. All possible vendor names can be found here: https://api.revealera.com/vendors.txt"
},
"churn_only": {
"type": "string",
"description": "true if you want to see churn changes only. false if you want to see all changes, including churn",
"default": false
},
"new_only": {
"type": "string",
"description": "true if you want to see new installs or new usage changes only. false otherwise",
"default": false
},
"company_employee_size_range": {
"type": "string",
"description": "Only show tech stack changes from companies with number of employees that match the specified size ranges. Possible ranges are 1 employee, 2-10, 11-50, 51-200, 201-500, 501-1,000, 1,001-5,000, 5,001-10,000, 10,001+. Separate multiple values with semicolon."
},
"company_industry": {
"type": "string",
"description": "Only show tech stack changes from companies in the specified industries. We look at the LinkedIn company page to determine industries. All possible industries are available at https://api.revealera.com/linkedin_industries.txt . Separate multiple values with semicolon."
},
"company_country": {
"type": "string",
"description": "Only show tech stack changes from companies headquartered in the specified countries. Country codes must be in ISO 3166-1 alpha-2 format. Separate multiple values with semicolon.",
"pattern": "^[A-Z]{2}(;[A-Z]{2})*$"
},
"omit_linkedin_data": {
"type": "string",
"description": "true if you to omit linkedin-related fields from the response (ie for compliance reasons)",
"default": false
}
},
"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": {
"signals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Signal ID"
},
"change_date": {
"type": "string",
"description": "Date when the tech change occurred (ISO 8601 format with timezone)",
"format": "date-time"
},
"change_type": {
"type": "string",
"description": "Type of change",
"enum": [
"subscribed",
"unsubscribed",
"usage",
"stop_usage",
"upgrade",
"downgrade"
]
},
"change_description": {
"type": "string",
"description": "A description of the tech change"
},
"linkedin_username": {
"type": [
"string",
"null"
],
"description": "LinkedIn username of the company"
},
"linkedin_company_id": {
"type": [
"string",
"null"
],
"description": "LinkedIn company id of the company"
},
"domain": {
"type": "string",
"description": "Company domain/website of the company"
},
"company_name": {
"type": "string",
"description": "Name of the company"
},
"company_logo": {
"type": "string",
"description": "URL to company logo",
"format": "uri"
},
"company_address": {
"type": [
"string",
"null"
],
"description": "Company address, if found"
},
"industry": {
"type": "string",
"description": "Company industry of the company"
},
"company_size_range": {
"type": "string",
"description": "Company size range"
},
"company_size_range_estimated": {
"type": "boolean",
"description": "true if the company_size_range was estimated by us, or false if it was taken directly from their Linkedin company profile"
},
"company_description": {
"type": "string",
"description": "Company description"
},
"country": {
"type": "string",
"description": "Company HQ country"
},
"region": {
"type": "string",
"description": "Company HQ region"
},
"vendor_name": {
"type": [
"string",
"null"
],
"description": "Name of the technology vendor"
},
"vendor_category": {
"type": "string",
"description": "Category of the vendor/technology"
},
"vendor_market": {
"type": "string",
"description": "Market segment of the vendor",
"enum": [
"SMB",
"Shopify",
"Mid-Market",
"Enterprise"
]
},
"vendor_notes": {
"type": "string",
"description": "Additional notes about the vendor such as its unique features/topics"
},
"vendor_market_leader": {
"type": "boolean",
"description": "Whether vendor is a market leader"
},
"vendor_url": {
"type": [
"string",
"null"
],
"description": "URL to vendor website",
"format": "uri"
},
"vendor_source": {
"type": "string",
"description": "Source where we found the signal",
"enum": [
"dns record",
"website javsacript",
"link found",
"internal subdomain"
]
},
"plan_name": {
"type": [
"string",
"null"
],
"description": "the name of the product plan this customer changed to (most of the time it is null, but if we know it, it is indicated here)"
}
},
"required": [
"id",
"change_date",
"change_type",
"change_description",
"domain",
"company_name",
"industry",
"company_size_range",
"country",
"vendor_category",
"vendor_market",
"vendor_market_leader",
"vendor_source"
],
"additionalProperties": false
}
},
"pagination": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"description": "Current page number"
},
"per_page": {
"type": "integer",
"description": "Number of items per page"
},
"total_pages": {
"type": "integer",
"description": "Total number of pages"
},
"total_items": {
"type": "integer",
"description": "Total number of items"
}
},
"required": [
"page",
"per_page",
"total_pages",
"total_items"
],
"additionalProperties": false
}
},
"required": [
"signals",
"pagination"
],
"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 bloomberry_get_tech_stack_changes --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: `4.21` per pricing unit.
* Billing mode: `post_deduct`.