> ## 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.
# Sumble Search Signals: Inputs, Cost & CLI Example
> Search signals. Requires the workspace's own Sumble API key. Sumble Sumble Search Signals docs include request fields, response shape, pricing notes, and
## 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=sumble_search_signals:{}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ---------------- | -------- | -------- | ------- | ----------- |
| `payload.filter` | `object` | No | | |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Signals are sales-relevant events such as champion job changes, recent hires and promotions, technology and product mentions, projects and initiatives, and technology and job-function trends. Job-post signals (technology and product mentions, projects, and first mentions) also include `suggested_contacts`: the top few people to consider reaching out to at the account, plus a link to view all of them. Each signal also carries `account_status`: the CRM relationship between the signal's organization and the calling account ('is_customer', 'is_in_crm', or 'is_not_in_crm'). Only populated when the calling account has a linked CRM seat (Salesforce or HubSpot).",
"properties": {
"filter": {
"type": "object",
"properties": {
"organization_ids": {
"type": [
"array",
"null"
],
"description": "Organization IDs to filter signals by.",
"items": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"person_ids": {
"type": [
"array",
"null"
],
"description": "Sumble person IDs to filter signals by.",
"items": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"signal_ids": {
"type": [
"array",
"null"
],
"description": "Signal IDs to filter signals by.",
"items": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"technology_slugs": {
"type": [
"array",
"null"
],
"description": "Canonical technology slugs to filter signals by, such as `kubernetes` or `salesforce`.",
"items": {
"type": "string"
}
},
"job_functions": {
"type": [
"array",
"null"
],
"description": "Job function names to filter signals by, such as `Engineering` or `Sales`.",
"items": {
"type": "string"
}
},
"priorities": {
"type": [
"array",
"null"
],
"description": "Priorities to filter signals by. Matches the `priority` field returned on each signal.",
"items": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
}
},
"account_list_ids": {
"type": [
"array",
"null"
],
"description": "Account list IDs to filter signals to accounts in those lists.",
"items": {
"type": "integer",
"exclusiveMinimum": 0
}
}
},
"additionalProperties": 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": {
"id": {
"type": "string",
"format": "uuid"
},
"signals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"signal_id": {
"type": [
"integer",
"null"
]
},
"title": {
"type": "string"
},
"subtitle": {
"type": [
"string",
"null"
]
},
"explanation": {
"type": [
"string",
"null"
]
},
"sales_angle": {
"type": [
"string",
"null"
]
},
"date": {
"type": "string",
"format": "date-time"
},
"sumble_url": {
"type": [
"string",
"null"
]
},
"display_type": {
"type": "string"
},
"type": {
"type": [
"string",
"null"
]
},
"matched_technologies": {
"type": [
"array",
"null"
],
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"label": {
"type": [
"string",
"null"
]
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
}
},
"organization_name": {
"type": [
"string",
"null"
]
},
"organization_id": {
"type": [
"integer",
"null"
]
},
"job_post_id": {
"type": [
"integer",
"null"
]
},
"person_id": {
"type": [
"integer",
"null"
]
},
"linkedin_url": {
"type": [
"string",
"null"
]
},
"location": {
"type": [
"string",
"null"
]
},
"job_function": {
"type": [
"string",
"null"
]
},
"priority": {
"type": [
"string",
"null"
]
},
"suggested_contacts": {
"type": [
"object",
"null"
],
"properties": {
"people": {
"type": "array",
"items": {
"type": "object",
"properties": {
"person_id": {
"type": [
"integer",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"linkedin_url": {
"type": [
"string",
"null"
]
},
"score": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"sumble_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"people"
],
"additionalProperties": false
},
"account_status": {
"type": [
"string",
"null"
],
"description": "CRM relationship between the signal's organization and the calling account: 'is_customer' (a customer account in the calling account's CRM), 'is_in_crm' (tracked in CRM but not a customer), or 'is_not_in_crm' (no CRM record). Only populated when the calling account has a linked CRM seat (Salesforce or HubSpot); omitted otherwise, even when requested.",
"enum": [
"is_customer",
"is_in_crm",
"is_not_in_crm"
]
}
},
"required": [
"title",
"date",
"display_type"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"signals"
],
"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 sumble_search_signals --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: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.