> For the complete documentation index, see [llms.txt](https://thecontentforge.gitbook.io/thecontentforge-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://thecontentforge.gitbook.io/thecontentforge-docs/feature-guides/trend-scan.md).

# Trend Scan

Trend Scan is the 12-hour scan of the top 20 things on X right now, paired with brand-relevant angles you can send straight into [Content Forge](/thecontentforge-docs/feature-guides/content-studio.md). It's the trend-to-brand adaptation layer for [ForgeSays](/thecontentforge-docs/feature-guides/forge-says.md) - not generic trend commentary.

The page lives at `/forge-says/trends`. From [ForgeSays](/thecontentforge-docs/feature-guides/forge-says.md), click into the **12-Hour Trend Scan** entry to open it.

### How the scan works

* **Cadence** - a fresh scan runs roughly every 12 hours. The status banner shows the last scan timestamp and a countdown to the next one.
* **Live trend data** - each trend arrives already summarized and in context. The banner also indicates when the feed is running in a reduced state because a data input is temporarily unavailable, so you always know what you are looking at.
* **Top 20** - each snapshot caps at 20 trends.
* **Enrichment progress** - the banner shows live progress ("Enriching 15/20") while a scan runs.
* **Personalization** - once your [Brand Voice](/thecontentforge-docs/feature-guides/brand-voice.md) is configured, click **Personalize for my brand** to layer per-org relevance and angle suggestions on top of the generic snapshot. The banner reports "Personalizing for your brand…" then "Ready for your brand · 20/20" when done. Personalization is rate-limited per user.

### Trend cards

Each card shows:

* **Rank** (1–20) in a numbered box
* **Topic** (the headline)
* **Freshness pill** - Breaking, Rising, Steady, or Cooling
* **Risk pill** - Low, Medium, or High (when relevant)
* **Region tags** - US, UK, CA, and others
* **Fit badge** - Strong fit, Moderate fit, Low fit, Not recommended, or Set up brand voice (depending on personalization state)
* **Volume** - approximate post count (e.g. ≈500k posts)
* **External link** - open the trend on X
* **Narrative summary** - a one-line read on what's going on

Cards are sorted with the strongest fits for your brand first.

### Drilldown

Clicking **Details** expands a card to reveal:

* **Why it's trending**
* **What people are saying** - sentiment / takes summary
* **Related hashtags** - chips for each
* **Key voices on X** - handles with a one-line "why this account matters" explanation, clickable through to X
* **Top 3 X posts** - snippet, author, timestamp, each clickable through to X
* **Risk notes** - when the risk pill is anything other than none
* **Brand fit breakdown** - the reasoning behind the fit verdict, so a rating is never a black box
* **Citations** - expandable, up to 8 visible

### Adapted angles

When personalization has run for your org, each card includes one or more **Adapted angles**. Each angle contains:

* **Angle title** + content-intent badge (thought leadership, meme, explainer, etc.)
* **Why this fits your org** - the relevance reasoning
* **Trend bridge** - how your brand connects to the trend
* **Impression opportunity** - the why-now framing
* **Suggested angle** - full summary
* **Hook** with a one-click copy
* **CTA** - optional
* **Risk notes** + **avoid list**
* **Platform suggestion** - X, IG, FB, or auto
* **Send to Content Studio** - sends the full trend context plus angle straight into Content Forge with an instruction reminding the AI to keep your brand as the subject and the trend as the timely hook

If a trend's fit badge says **Low fit** or **Not recommended**, the adapted angles still appear so you can override if your editorial judgment differs. Use **Re-personalize** to refresh stale overlays.

### Fit tiers

| Tier                   | Meaning                                                                                                                                  |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Strong fit**         | High brand relevance and momentum - top candidates                                                                                       |
| **Moderate fit**       | Workable; treat as second-tier picks                                                                                                     |
| **Low fit**            | Marginal - only pursue if you have a unique angle                                                                                        |
| **Not recommended**    | Brand mismatch or risky - skip unless you have a strong override reason                                                                  |
| **Set up brand voice** | Brand Voice profile not configured yet - finish [Brand Voice](/thecontentforge-docs/feature-guides/brand-voice.md) to unlock fit scoring |

Every tier produces angles - even **Not recommended** trends get them, sorted to the bottom. That way you can still scan the field without losing context.

### Workflow

1. Open the 12-Hour Trend Scan from [ForgeSays](/thecontentforge-docs/feature-guides/forge-says.md)
2. If the banner is generic or stale, click **Personalize for my brand**
3. Scan the top of the list - Strong fit trends with Breaking / Rising freshness are first
4. Open **Details** on the ones that match your editorial angle
5. Pick an **Adapted angle**, copy the hook, and click **Send to Content Studio**
6. Finish the post in [Content Forge](/thecontentforge-docs/feature-guides/content-studio.md) with the trend's context already attached

### Tips

* The 12-hour cadence means you don't need to refresh constantly - the next snapshot lands on its schedule
* **Personalize for my brand** is the difference between generic trend commentary and brand-grounded angles. Use it.
* When the freshness pill flips to **Cooling**, prioritise other trends - the window is closing
* Combine with [Experiments](/thecontentforge-docs/feature-guides/experiments.md) - when you publish off a trend, attach the post to an experiment so you can measure whether trend-driven posts actually pay off for you


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://thecontentforge.gitbook.io/thecontentforge-docs/feature-guides/trend-scan.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.