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

# TheirStack: Catalog Keywords

> Look up technology and buying-intent keywords by name or category to get the exact slugs for job and company searches. TheirStack Catalog Keywords reference.

Look up technology and buying-intent keywords by name or category to get the exact slugs for job and company searches.

> [!NOTE]
>
> Tool ID: `theirstack_catalog_keywords`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'theirstack_catalog_keywords',
  {
    "keyword_type": "technology",
    "keyword_type_not": [
      "technology"
    ],
    "name_pattern": "example"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute theirstack_catalog_keywords --input '{
  "keyword_type": "technology",
  "keyword_type_not": [
    "technology"
  ],
  "name_pattern": "example"
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe theirstack_catalog_keywords --json` for the complete live contract.

## Input reference

List all keywords tracked by TheirStack, including both technologies and buying intent topics. Search for any keyword and filter by one or more categories. Calls to this endpoint don't cost you credits. - To get technologies only: filter with `keyword_type=technology` - To get only buying intent topics: filter with `keyword_type_not=technology` - By default this endpoint returns 25 keywords. To get all keywords, set `limit=100000`. Response always includes `data` (array of keywords) and `metadata` (total\_results, page, limit).

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.keyword_type` | `"technology" \| "software_product" \| "technology_concept" \| "operational_activity" \| "strategic_initiative" \| "metric_or_concept" \| "product_or_service_offered" \| "regulation" \| "threat_or_risk" \| "event" \| "commodity" \| "industry_vertical" \| "physical_equipment" \| "medical_research" \| "government_body"` | No | — | Keyword type to filter by Allowed: `technology`, `software_product`, `technology_concept`, `operational_activity`, `strategic_initiative`, `metric_or_concept`, `product_or_service_offered`, `regulation`, `threat_or_risk`, `event`, `commodity`, `industry_vertical`, `physical_equipment`, `medical_research`, `government_body`. |
| `payload.keyword_type_not` | `array` | No | — | Exclude keywords of these types |
| `payload.name_pattern` | `string` | No | — | Case-insensitive text to search for in the keyword name |
| `payload.slug` | `array` | No | — | Keyword slug of a single keyword |
| `payload.slugs` | `array` | No | — | Keyword slugs of one or many keywords |
| `payload.category_pattern` | `string` | No | — | Case-insensitive text to search for in the keyword category. For example, `data` to find 'data tools'. |
| `payload.category_slug` | `string` | No | — | Keyword category slug |
| `payload.parent_category_slug` | `string` | No | — | Keyword parent category slug |
| `payload.parent_category_pattern` | `string` | No | — | Case-insensitive text to search for in the keyword parent category name |
| `payload.q` | `string` | No | — | General search query. Searches across keyword name, keyword type, category, and parent category (case-insensitive). Results where the keyword name starts with the query are ranked first. |
| `payload.starts_with` | `string` | No | — | Filter keywords whose name starts with this string (e.g. 'A' for glossary). Special value '**other**' selects keywords whose name does not start with letters A-Z. |
| `payload.include_metadata` | `boolean` | No | `false` | Deprecated, metadata is always included now |
| `payload.page` | `integer` | No | `0` | Page number. Minimum: 0. |
| `payload.limit` | `integer` | No | `25` | Number of results per page Minimum: 1. |
| `payload.query` | `string` | No | — | Deepline alias for TheirStack q. Searches keyword names, types, categories, and parent categories. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "List all keywords tracked by TheirStack, including both technologies and buying intent topics. Search for any keyword and filter by one or more categories. Calls to this endpoint don't cost you credits. - To get technologies only: filter with `keyword_type=technology` - To get only buying intent topics: filter with `keyword_type_not=technology` - By default this endpoint returns 25 keywords. To get all keywords, set `limit=100000`. Response always includes `data` (array of keywords) and `metadata` (total_results, page, limit).",
    "properties": {
      "keyword_type": {
        "type": [
          "string",
          "null"
        ],
        "description": "Keyword type to filter by",
        "enum": [
          "technology",
          "software_product",
          "technology_concept",
          "operational_activity",
          "strategic_initiative",
          "metric_or_concept",
          "product_or_service_offered",
          "regulation",
          "threat_or_risk",
          "event",
          "commodity",
          "industry_vertical",
          "physical_equipment",
          "medical_research",
          "government_body"
        ]
      },
      "keyword_type_not": {
        "type": [
          "array",
          "null"
        ],
        "description": "Exclude keywords of these types",
        "items": {
          "type": "string",
          "enum": [
            "technology",
            "software_product",
            "technology_concept",
            "operational_activity",
            "strategic_initiative",
            "metric_or_concept",
            "product_or_service_offered",
            "regulation",
            "threat_or_risk",
            "event",
            "commodity",
            "industry_vertical",
            "physical_equipment",
            "medical_research",
            "government_body"
          ]
        }
      },
      "name_pattern": {
        "type": [
          "string",
          "null"
        ],
        "description": "Case-insensitive text to search for in the keyword name"
      },
      "slug": {
        "type": [
          "array",
          "null"
        ],
        "description": "Keyword slug of a single keyword",
        "items": {
          "type": "string"
        }
      },
      "slugs": {
        "type": [
          "array",
          "null"
        ],
        "description": "Keyword slugs of one or many keywords",
        "items": {
          "type": "string"
        }
      },
      "category_pattern": {
        "type": [
          "string",
          "null"
        ],
        "description": "Case-insensitive text to search for in the keyword category. For example, `data` to find 'data tools'."
      },
      "category_slug": {
        "type": [
          "string",
          "null"
        ],
        "description": "Keyword category slug"
      },
      "parent_category_slug": {
        "type": [
          "string",
          "null"
        ],
        "description": "Keyword parent category slug"
      },
      "parent_category_pattern": {
        "type": [
          "string",
          "null"
        ],
        "description": "Case-insensitive text to search for in the keyword parent category name"
      },
      "q": {
        "type": [
          "string",
          "null"
        ],
        "description": "General search query. Searches across keyword name, keyword type, category, and parent category (case-insensitive). Results where the keyword name starts with the query are ranked first."
      },
      "starts_with": {
        "type": [
          "string",
          "null"
        ],
        "description": "Filter keywords whose name starts with this string (e.g. 'A' for glossary). Special value '__other__' selects keywords whose name does not start with letters A-Z."
      },
      "include_metadata": {
        "type": "boolean",
        "description": "Deprecated, metadata is always included now",
        "default": false
      },
      "page": {
        "type": "integer",
        "description": "Page number.",
        "default": 0,
        "minimum": 0
      },
      "limit": {
        "type": "integer",
        "description": "Number of results per page",
        "default": 25,
        "minimum": 1
      },
      "query": {
        "type": [
          "string",
          "null"
        ],
        "description": "Deepline alias for TheirStack q. Searches keyword names, types, categories, and parent categories."
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `array` | Yes | — | TheirStack keyword catalog results. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

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

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "array",
        "description": "TheirStack keyword catalog results.",
        "items": {
          "type": "object",
          "additionalProperties": true
        }
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "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

* [TheirStack provider guide](https://deepline.com/docs/providers/theirstack/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.