---
title: "Get Technologies And Buying Intents"
method: GET
path: "/v0/catalog/keywords"
tags: ["Catalog"]
---

# Get Technologies And Buying Intents

`GET /v0/catalog/keywords`

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

## Query parameters

- `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'
- `keyword_type_not` KeywordType[], nullable — Exclude keywords of these types
- `name_pattern` string, nullable — Case-insensitive text to search for in the keyword name
- `slug` string[], nullable — Keyword slug of a single keyword
- `slugs` string[], nullable — Keyword slugs of one or many keywords
- `category_pattern` string, nullable — Case-insensitive text to search for in the keyword category. For example, `data` to find 'data tools'.
- `category_slug` string, nullable — Keyword category slug
- `parent_category_slug` string, nullable — Keyword parent category slug
- `parent_category_pattern` string, nullable — Case-insensitive text to search for in the keyword parent category name
- `q` string, nullable — 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` string, nullable — 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` boolean — Deprecated, metadata is always included now
- `page` integer — Page number.
- `limit` integer — Number of results per page

## Response `200`

Successful Response

- CatalogKeywordsResponse
  - `data` KeywordAggregated[]
    - `name` string, required
    - `category` string, nullable — Category of the keyword
    - `type` string, nullable — Type of the keyword (e.g. technology, operational_activity)
    - `slug` string, required — Slug of the keyword
    - `category_slug` string, nullable — Slug of the category of the keyword
    - `parent_category` string, nullable — Parent category of the keyword
    - `parent_category_slug` string, nullable — Slug of the parent category of the keyword
    - `logo` string, nullable — Logo of the keyword
    - `logo_thumbnail` string, nullable — Thumbnail of the keyword
    - `one_liner` string, nullable — One-line description of the keyword
    - `url` string, nullable — URL of the keyword
    - `description` string, nullable — Description of the keyword
    - `jobs` integer, required — Number of jobs found mentioning this keyword
    - `companies` integer, required — Number of companies using this keyword
    - `companies_found_last_week` integer, required — Number of companies found using this keyword in the last week for the first time
  - `metadata` CatalogKeywordsMetadata, required
    - `total_results` integer, required — Total number of keywords
    - `page` integer, required — Current page (0-based)
    - `limit` integer, required — Page size

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/theirstack/apis/theirstack-api-reference.md) · [All operations](https://skmtc.net/theirstack/apis/theirstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/theirstack/theirstack-api-reference/versions/2723cd54b43e/schema)