> 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/list-trend-topics.md).

# List Trend Topics

List the trend topics your organization has already saved.

### `list_trend_topics`

### What it does

Lists the trend topics your organization tracks in Nichefire, as paginated summaries. A topic is a subject you monitor over time (e.g. *Specialty Coffee*, *Coffee Makers )* and the trends underneath it are what Nichefire has detected within that subject.

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

### When to use it

Start here. Topics are addressed by ID everywhere else in the Insights API, so this is how you discover what exists and get the IDs to drill into:

`list_trend_topics` → [`get_trend_topic`](/tools/insights-api/get-trend-topic.md) or [`list_trends`](/tools/insights-api/list-trends.md) → [`get_trend`](/tools/insights-api/get-trend.md)

### Parameters

| Parameter | Required | Description                 |
| --------- | -------- | --------------------------- |
| `page`    | No       | Page number, starting at 1. |
| `limit`   | No       | Items per page, 1–20.       |

### 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
{ "page": 1, "limit": 10 }
```

### Example response

```json
{
  "page": 1,
  "limit": 10,
  "total_count": 2,
  "results": [
    {
      "id": "bf09eef2-e86f-430f-84d2-a71aab335d46",
      "name": "Specialty Coffee",
      "created_at": "2026-02-11T09:24:00Z",
      "status": "active",
      "period": "1Y"
    },
    {
      "id": "9c1d4f37-0b52-4a7e-9f10-2d8ab6c31e05",
      "name": "Coffee Makers",
      "created_at": "2026-04-02T15:10:00Z",
      "status": "active",
      "period": "6M"
    }
  ]
}
```

#### Reading the payload

| Field                  | What it holds                                                                     |
| ---------------------- | --------------------------------------------------------------------------------- |
| `page`, `limit`        | The page you requested.                                                           |
| `total_count`          | Total topics available, across all pages — use it to know whether to keep paging. |
| `results[].id`         | The topic ID. This is the `topic_id` the other Insights tools expect.             |
| `results[].name`       | The topic name.                                                                   |
| `results[].created_at` | When the topic was created.                                                       |
| `results[].status`     | Whether the topic is currently being tracked.                                     |
| `results[].period`     | The time span the topic covers, e.g. `1Y`, `6M`.                                  |

This is a summary view: it tells you which topics exist, not what is inside them. For the trends under a topic, use [`get_trend_topic`](/tools/insights-api/get-trend-topic.md) or [`list_trends`](/tools/insights-api/list-trends.md).