> For the complete documentation index, see [llms.txt](https://mcp-docs.nichefire.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mcp-docs.nichefire.com/tools/insights-api/get-trend-topic.md).

# Get Trend Topic

### `get_trend_topic`

### What it does

Returns the detail of a single trend topic, including the prompt it was built from and the IDs of the trends inside it, split into **rising** and **sustaining**.

This reads your organization's own saved data, not the public web.

### When to use it

* To understand what a topic is actually tracking — the [`prompt`](broken://pages/tRaqHSDxGJheu2NzVTFE) shows the brief behind it.
* To see at a glance how many trends are rising versus sustaining within a topic.
* To get trend IDs when you already know which group you care about.

If you need names, dates, and statuses rather than bare IDs, use [`list_trends`](/tools/insights-api/list-trends.md) instead — it returns readable summaries and supports filtering.

### Parameters

| Parameter  | Required | Description                                                                             |
| ---------- | -------- | --------------------------------------------------------------------------------------- |
| `topic_id` | Yes      | The topic's UUID, from [`list_trend_topics`](/tools/insights-api/list-trend-topics.md). |

### Cost

Free. Insights tools do not consume the shared search quota — only a per-key rate limit applies.

[Quota](/errors-and-limits/quota.md)

### Example request

```json
{ "topic_id": "bf09eef2-e86f-430f-84d2-a71aab335d46" }
```

### Example response

```json
{
  "id": "bf09eef2-e86f-430f-84d2-a71aab335d46",
  "topic_name": "Specialty Coffee",
  "prompt": "Track emerging consumer and retail trends in specialty coffee",
  "rising_trend_ids": [
    "3f7c2a10-58d6-4c91-b0a4-1e93f7d25c88",
    "a2b6e441-7c03-4f8d-91ba-6d5c0e17f234"
  ],
  "sustaining_trend_ids": [
    "d81f9c65-2a47-4b30-8e15-9f0c3b76a512"
  ],
  "all_trend_ids": [
    "3f7c2a10-58d6-4c91-b0a4-1e93f7d25c88",
    "a2b6e441-7c03-4f8d-91ba-6d5c0e17f234",
    "d81f9c65-2a47-4b30-8e15-9f0c3b76a512"
  ]
}
```

#### Reading the payload

| Field                  | What it holds                                                       |
| ---------------------- | ------------------------------------------------------------------- |
| `id`                   | The topic ID.                                                       |
| `topic_name`           | The topic name.                                                     |
| `prompt`               | The brief the topic was set up with — what it was told to look for. |
| `rising_trend_ids`     | Trends gaining momentum in this topic.                              |
| `sustaining_trend_ids` | Trends holding steady rather than accelerating.                     |
| `all_trend_ids`        | Every trend in the topic, rising and sustaining together.           |

The response contains IDs only. Pass any of them to [`get_trend`](/tools/insights-api/get-trend.md) for the full detail of that trend.