> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/use-cases/trend-detection-api>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/use-cases/trend-detection-api.mdx>

---

# Trend detection API

**What API detects trends before they peak?** Social Fetch pairs Google Trends with short-video search. The trending route lists what is rising in a country now, interest over time charts up to five terms, and TikTok search shows whether a trend is spreading in video. One API key, one response shape, and you pay per call.

See what is rising in search today, chart how fast it is climbing, and check whether it is spreading on TikTok, YouTube Shorts and Instagram Reels, all in one JSON shape.

## A real run, measured and priced

Spot a rising search, chart it, then check TikTok, run on 21 Nov 2026 against live public data. A film's searches climbed for a week to a three-month high, with 18.4M views on TikTok in the same week.

| Request | Result | Credits | Time |
| --- | --- | --- | --- |
| `GET /v1/google-trends/trending?geo=US&hours=24&sort=volume` | 25 searches trending in the US in the last 24 hours; 20 are sports, and one is the new Hunger Games film. | 1 | 1.4 s |
| `GET /v1/google-trends/interest-over-time?query=sunrise on the reaping&time=today 3-m&geo=US` | Interest rose from 17 on 14 Nov to 100 on 21 Nov, the highest point in three months. | 1 | 2.4 s |
| `GET /v1/tiktok/search?query=sunrise on the reaping&datePosted=this-week&sortBy=relevance&trim=true` | 30 videos from the past week with 18,412,946 views between them; 26 were posted on 20 or 21 Nov. | 1 | 5.0 s |

Total: 3 credits, 8.8 s of server time. Starter pack ($14 per 1,000 credits): $0.042. Scale pack ($1.64 per 1,000 credits): $0.0049.

The news is too late. By the time a trend is in the news, the cheap attention has gone. Spotting it early means watching search and short video every day, and the Google Trends website has no API you can schedule.

Dashboards track their topics, not yours. Trend tools sell dashboards for the topics they chose to track. Your niche is rarely one of them.

You need the raw signals as data: what started rising today, how steep the curve is, and how many videos it already has, so your own job decides what counts as a trend.

## Endpoints

| Method | Path | What it does |
| --- | --- | --- |
| GET | `/v1/google-trends/trending` | Searches trending in a country or region over the last 4, 24, 48 or 168 hours, with a volume bucket, growth and related searches. |
| GET | `/v1/google-trends/interest-over-time` | Search interest for up to five terms over any window, or one term in two windows to compare with last year. |
| GET | `/v1/google-trends/related-queries` | Rising and top related searches for a term, to find the next keyword. |
| GET | `/v1/tiktok/search` | TikTok videos for a term, limited to the last day, week or month, with views and likes. |
| GET | `/v1/tiktok/feed/trending` | The videos trending on TikTok in a region right now. |
| GET | `/v1/youtube/shorts/trending` | Trending YouTube Shorts. |
| GET | `/v2/instagram/reels/trending` | Trending Instagram Reels. |

## Workflow

1. **Pull trending searches each morning.** List the day's trending searches for each country you sell in, and keep the ones in your categories.
2. **Chart the curve.** Run interest over time on the candidates. A term that climbs for several days running is a trend; a one-day spike is news.
3. **Check short video.** Search TikTok for the term, limited to this week. Lots of fresh videos with high views means it has spread beyond search.
4. **Find the next keyword.** Related queries show what people search for next, which is where the content gap is.
5. **Act while it is still rising.** Send the shortlist to your content, ads or merchandising team the same day.

## Example: three months of search interest for one term

```bash
curl -sS \
  -H "x-api-key: YOUR_API_KEY" \
  -G "https://api.socialfetch.dev/v1/google-trends/interest-over-time" \
  --data-urlencode "query=sunrise on the reaping" \
  --data-urlencode "time=today 3-m" \
  --data-urlencode "geo=US"
```

## Why content and growth teams track trends here

- Search and short video in one place. Google Trends, TikTok, YouTube Shorts and Instagram Reels answer with the same key and the same JSON layout.
- Your topics, not a fixed list. Chart any term, in any country, over any window.
- Cheap to run every day. The day's trending searches plus one chart of up to five terms, every day, is 60 credits a month.
- You only pay for completed lookups. Requests that fail on our side cost nothing.
- Public data only. Every number comes from pages anyone can see.

## FAQ

### What API detects trends before they peak?

Social Fetch. It returns Google Trends trending searches and interest over time as JSON, and pairs them with TikTok search and the TikTok, YouTube Shorts and Instagram Reels trending feeds, all with one API key.

### Is Google Trends interest a count of searches?

No. Google scales interest from 0 to 100 within the window you ask for, where 100 is the busiest point. Put terms in one call to see which is bigger. The trending list gives a volume bucket instead, such as 50,000 searches or more.

### How far back can I chart a term?

Interest over time takes windows from the past hour to the past five years, the full history, or your own start and end dates.

### Can I get an alert when something starts trending?

A [monitor](https://www.socialfetch.dev/docs/monitors) can watch a TikTok search and post new videos to your webhook. For Google Trends, run the trending call on your own schedule and compare it with yesterday's list.
