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

# Get Trend

### `get_trend`

### What it does

Returns the full detail of a single saved trend: what it is, why it matters, the themes and keywords behind it, where it is trending, and its sentiment, trajectory, and volume.

This reads your organization's own saved data, not the public web. For a live, on-demand analysis of a trend from public sources, use [`analyze_trend`](/tools/firesearch/analyze-trends.md) instead.

### When to use it

* After [`list_trends`](/tools/insights-api/list-trends.md) or [`get_trend_topic`](/tools/insights-api/get-trend-topic.md) surfaces a trend worth opening.
* To build a brief, a slide, or a report section around something your organization is already tracking.
* To compare trends within a topic on sentiment, trajectory, or volume.

### Parameters

| Parameter  | Required | Description                                                                                                                                |
| ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `trend_id` | Yes      | The trend's UUID, from [`list_trends`](/tools/insights-api/list-trends.md) or [`get_trend_topic`](/tools/insights-api/get-trend-topic.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
{ "trend_id": "3f7c2a10-58d6-4c91-b0a4-1e93f7d25c88" }
```

### Example response

```json
{
  "trend_id": "3f7c2a10-58d6-4c91-b0a4-1e93f7d25c88",
  "trend_name": "Ready-to-drink cold brew in convenience retail",
  "status": "active",
  "trend_description": "Canned and bottled cold brew is moving out of specialty grocery and into convenience channels, with regional roasters launching single-serve formats.",
  "why_it_matters": "Convenience distribution changes who the category competes with and puts pressure on price per serve.",
  "activity_analysis": "Sustained discussion across retail trade coverage and consumer communities, with recurring mentions of shelf placement.",
  "trending_on": ["News", "Reddit", "X"],
  "top_themes": [
    {
      "cluster_name": "Shelf placement and distribution",
      "cluster_description": "Conversation about where cold brew sits in store and which chains are carrying it.",
      "comments_number": 412,
      "avg_sentiment": 24,
      "avg_expressiveness": 61
    },
    {
      "cluster_name": "Price per serve",
      "cluster_description": "Comparisons against café pricing and multi-serve formats.",
      "comments_number": 268,
      "avg_sentiment": -8,
      "avg_expressiveness": 55
    }
  ],
  "keywords": ["cold brew", "RTD coffee", "single-serve", "convenience"],
  "sentiment": "Positive",
  "average_sentiment": 19.81,
  "trajectory": "Rising",
  "volume": 1234.5,
  "dominant_categories": ["Food & Beverage", "Retail"],
  "diversity": "High",
  "date_created": "2026-06-14",
  "date_stopped": null
}
```

#### Reading the payload

| Field                    | What it holds                                                                                                                                            |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `trend_id`, `trend_name` | Identity of the trend.                                                                                                                                   |
| `status`                 | `active` or `stopped`.                                                                                                                                   |
| `trend_description`      | What the trend is.                                                                                                                                       |
| `why_it_matters`         | Why it is worth attention.                                                                                                                               |
| `activity_analysis`      | How activity around the trend has behaved.                                                                                                               |
| `trending_on`            | Platforms where the trend is visible.                                                                                                                    |
| `top_themes[]`           | The conversation clusters inside the trend — each with a name, a description, how many comments it covers, and its average sentiment and expressiveness. |
| `keywords`               | Terms associated with the trend.                                                                                                                         |
| `sentiment`              | Overall sentiment, as a label.                                                                                                                           |
| `average_sentiment`      | The numeric sentiment score. **Can be negative** — treat it as a signed value, not a percentage.                                                         |
| `trajectory`             | Direction of travel, e.g. `Rising`.                                                                                                                      |
| `volume`                 | Volume metric for the trend.                                                                                                                             |
| `dominant_categories`    | The categories the trend belongs to.                                                                                                                     |
| `diversity`              | How varied the conversation is across sources.                                                                                                           |
| `date_created`           | When the trend was detected.                                                                                                                             |
| `date_stopped`           | When it stopped, or `null` if still running.                                                                                                             |

Fields are omitted or `null` when a trend has not produced them — a young trend may have no `trajectory` or `sentiment` yet — so check for presence rather than assuming the full shape.