> ## 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 Current Customers: Inputs, Cost & CLI
> Returns a list of active customers that is subscribed to a specific tech vendor OR to ANY tech vendor in a specific category 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_current_customers:{}' --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` | companies per page. |
| `payload.category` | `string` | No | | The product category to get active customers for. All possible product categories are available at [https://api.revealera.com/categories.txt](https://api.revealera.com/categories.txt). Pass "all" to get customers 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 name of the vendor to get current customers for. All possible vendor names can be found here: [https://api.revealera.com/vendors.txt](https://api.revealera.com/vendors.txt) . Note: ONLY 1 of category OR vendor\_name MUST be specified, but no more than 1. |
| `payload.company_employee_size_range` | `string` | No | | Only show active customers 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 customers from companies in the industry passed in. We look at at the Linkedin company page to determine industries. All possible industries are in [https://api.revealera.com/linkedin\_industries.txt](https://api.revealera.com/linkedin_industries.txt) Separate multiple values with ';' default(all) |
| `payload.company_country` | `string` | No | | Only show customers from companies headquartered in the country passed in. The country codes must be in ISO 3166-1 alpha-2 format. Separate multiple values with ';' default(all) |
| `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 a list of active customers that is subscribed to a specific tech vendor OR to ANY tech vendor in a specific category 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": "companies per page.",
"default": 20,
"minimum": 1,
"maximum": 20
},
"category": {
"type": "string",
"description": "The product category to get active customers for. All possible product categories are available at https://api.revealera.com/categories.txt. Pass \"all\" to get customers 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 name of the vendor to get current customers for. All possible vendor names can be found here: https://api.revealera.com/vendors.txt . Note: ONLY 1 of category OR vendor_name MUST be specified, but no more than 1."
},
"company_employee_size_range": {
"type": "string",
"description": "Only show active customers 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 customers from companies in the industry passed in. We look at at the Linkedin company page to determine industries. All possible industries are in https://api.revealera.com/linkedin_industries.txt Separate multiple values with ';' default(all)"
},
"company_country": {
"type": "string",
"description": "Only show customers from companies headquartered in the country passed in. The country codes must be in ISO 3166-1 alpha-2 format. Separate multiple values with ';' default(all)"
},
"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": {
"users": {
"type": "array",
"description": "Array of tech signal objects",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Customer ID"
},
"linkedin_username": {
"type": "string",
"description": "LinkedIn username of the company"
},
"linkedin_company_id": {
"type": "string",
"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"
},
"company_address": {
"type": "string",
"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 country"
},
"vendor_name": {
"type": "string",
"description": "Name of the technology vendor"
},
"vendor_category": {
"type": "string",
"description": "Category of the vendor/technology"
},
"vendor_url": {
"type": "string",
"description": "URL to vendor website"
},
"usage_started_at": {
"type": "string",
"description": "Date in which we detected this customer first started usage of this vendor in YYYY-MM-DD format"
},
"plan_name": {
"type": [
"string",
"null"
],
"description": "the name of the product plan this customer is currently in (most of the time it is null, but if we know it, it is indicated here)"
}
},
"required": [
"id",
"domain",
"company_name",
"industry",
"company_size_range",
"company_size_range_estimated",
"country",
"vendor_name",
"vendor_category",
"vendor_url"
],
"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": [
"users",
"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_current_customers --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: `2.11` per pricing unit.
* Billing mode: `post_deduct`.