> ## 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 Priority Signals: Inputs, Cost & CLI Example

> Search priority signals. Requires the workspace's own Sumble API key. Sumble Sumble Search Priority Signals docs include request fields, response shape, pricing

## Run in Enrichment Spreadsheet

<Info>
  Use this function as a column step in `deepline enrich`.
</Info>

```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=sumble_search_priority_signals:{}' --json
```

<Tip>
  Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
</Tip>

## Input Schema

| Name             | Type     | Required | Default | Description |
| ---------------- | -------- | -------- | ------- | ----------- |
| `payload.filter` | `object` | No       |         |             |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Priority signals are AI-generated digest items summarizing the most important signals in a user's account feed. They optionally can be searched by signal, organization, person, or job post IDs attached to their source signals. Returns the most recent 20 priority signals based on the specified filters, or omit filters to simply return the latest.",
    "properties": {
      "filter": {
        "type": "object",
        "properties": {
          "organization_ids": {
            "type": [
              "array",
              "null"
            ],
            "description": "Organization IDs to filter priority signals by.",
            "items": {
              "type": "integer",
              "exclusiveMinimum": 0
            }
          },
          "person_ids": {
            "type": [
              "array",
              "null"
            ],
            "description": "Sumble person IDs to filter priority signals by.",
            "items": {
              "type": "integer",
              "exclusiveMinimum": 0
            }
          },
          "signal_ids": {
            "type": [
              "array",
              "null"
            ],
            "description": "Signal IDs to filter priority signals by.",
            "items": {
              "type": "integer",
              "exclusiveMinimum": 0
            }
          },
          "job_post_ids": {
            "type": [
              "array",
              "null"
            ],
            "description": "Job post IDs to filter priority signals by.",
            "items": {
              "type": "integer",
              "exclusiveMinimum": 0
            }
          }
        },
        "additionalProperties": false
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output Schema

| Name          | Type     | Required | Default | Description                                    |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes      |         | Provider response payload.                     |
| `result.meta` | `object` | No       |         | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### 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"
          },
          "priority_signals": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string"
                },
                "headline": {
                  "type": "string"
                },
                "content": {
                  "type": "string"
                },
                "date": {
                  "type": "string",
                  "format": "date"
                },
                "signal_ids": {
                  "type": "array",
                  "items": {
                    "type": "integer"
                  }
                },
                "organization_ids": {
                  "type": "array",
                  "items": {
                    "type": "integer"
                  }
                },
                "person_ids": {
                  "type": "array",
                  "items": {
                    "type": "integer"
                  }
                },
                "job_post_ids": {
                  "type": "array",
                  "items": {
                    "type": "integer"
                  }
                }
              },
              "required": [
                "url",
                "headline",
                "content",
                "date"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "id",
          "priority_signals"
        ],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Advanced: Direct CLI

<Info>
  Use direct execution for single payload debugging.
</Info>

```bash theme={null}
deepline tools execute sumble_search_priority_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`.