> ## 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.

# Context.dev: Contextdev Get Brand Search

> Brand Search. Context.dev Contextdev Get Brand Search reference includes SDK V2 and CLI requests, input constraints, response fields, and Deepline cost.

Brand Search.

<Info>
  Tool ID: `contextdev_get_brand_search`
</Info>

## Run this action

Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.

```ts theme={null}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'contextdev_get_brand_search',
  {
    "query": "software companies hiring engineers"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={null}
deepline tools execute contextdev_get_brand_search --input '{
  "query": "software companies hiring engineers"
}' --json
```

## Example response

The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative.

```json theme={null}
{
  "data": {
    "results": [
      {
        "domain": "example.com",
        "name": "Example",
        "logo": "example"
      }
    ]
  }
}
```

Use `deepline tools get contextdev_get_brand_search --json` for the latest machine-readable contract.

## Input reference

Search brands by name or domain and get back up to 10 lightweight matches (domain, name, logo). Name matches rank ahead of domain matches; within each group the most popular brands come first: by Tranco rank, then market cap for brands outside the Tranco list, with text relevance breaking ties. Matching is prefix-based with no typo tolerance, so it is suited to autocomplete. Only brands already in the Context.dev index are returned — use /brand/retrieve to fetch (and index) a specific domain.

| Name            | Type     | Required | Default | Details                                                                                                                                                                                                                                   |
| --------------- | -------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.query` | `string` | Yes      | —       | Search term, matched against brand names and domains by prefix (e.g. 'nike', 'nike.com', 'nik'). Minimum length: 1. Maximum length: 100.                                                                                                  |
| `payload.tags`  | `array`  | No       | —       | Optional comma-separated caller-defined tags for tracking this request. Tags are recorded on the request's usage log and can be used to filter usage on the dashboard usage page. Up to 20 tags, each 1-50 characters. Maximum items: 20. |

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

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Search brands by name or domain and get back up to 10 lightweight matches (domain, name, logo). Name matches rank ahead of domain matches; within each group the most popular brands come first: by Tranco rank, then market cap for brands outside the Tranco list, with text relevance breaking ties. Matching is prefix-based with no typo tolerance, so it is suited to autocomplete. Only brands already in the Context.dev index are returned — use /brand/retrieve to fetch (and index) a specific domain.",
    "properties": {
      "query": {
        "type": "string",
        "description": "Search term, matched against brand names and domains by prefix (e.g. 'nike', 'nike.com', 'nik').",
        "minLength": 1,
        "maxLength": 100
      },
      "tags": {
        "type": "array",
        "description": "Optional comma-separated caller-defined tags for tracking this request. Tags are recorded on the request's usage log and can be used to filter usage on the dashboard usage page. Up to 20 tags, each 1-50 characters.",
        "maxItems": 20,
        "items": {
          "type": "string",
          "minLength": 1,
          "maxLength": 50
        }
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

| Name                           | Type     | Required | Default | Details            |
| ------------------------------ | -------- | -------- | ------- | ------------------ |
| `result.data`                  | `object` | Yes      | —       | —                  |
| `result.data.results`          | `array`  | Yes      | —       | Maximum items: 10. |
| `result.data.results[].domain` | `string` | Yes      | —       | —                  |
| `result.data.results[].name`   | `string` | Yes      | —       | —                  |
| `result.data.results[].logo`   | `string` | Yes      | —       | —                  |
| `result.data.key_metadata`     | `object` | No       | —       | —                  |
| `result.meta`                  | `object` | No       | —       | —                  |

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

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "data": {
        "type": "object",
        "properties": {
          "results": {
            "type": "array",
            "maxItems": 10,
            "items": {
              "type": "object",
              "properties": {
                "domain": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "logo": {
                  "type": "string"
                }
              },
              "required": [
                "domain",
                "name",
                "logo"
              ],
              "additionalProperties": false
            }
          },
          "key_metadata": {
            "type": "object",
            "properties": {},
            "required": [],
            "additionalProperties": false
          }
        },
        "required": [
          "results"
        ],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Context.dev provider guide](/docs/providers/contextdev/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)