# Prism Trend Board API (https://www.socialcrawl.dev/platforms/prism/trend-board)

> Pass country_code (an ISO code Google Trends covers, such as DE). The board is computed live for this call and nothing is stored between calls, so there is no history and no days parameter: repeat calls within 15 minutes are served from cache. `breakout_posts` are videos on TikTok's local feed for that country, registered there, whose views are at least 3 times the median of the author's own recent posts (pinned posts and posts under 48 hours are left out, at least 8 posts are compared, and rows without enough posts are counted, not shown). `rising_sounds` are the sounds used most on that feed, with how many of each sound's first page of videos are from the last 3 days and whether it is a returning or new sound. `rising_hashtags` are TikTok's own hashtag board for the country, with growth from its daily popularity curve and the first day in the window it was non-zero. `rising_searches` are Google Trends Trending Now, where Google's own start time is the first-seen date. `sources` and `unavailable` say which parts answered. TikTok's hashtag board covers 27 markets; elsewhere that section is empty and says why. No language model is used. Music charts and Pinterest Trends are not included yet. The price is provisional.

TL;DR: `GET /v1/prism/trend-board` costs 30 credits flat (provisional). One call reads TikTok's local feed, TikTok's hashtag board, Google Trending Now, up to 5 author pages and up to 3 sounds. A source that does not answer is listed under unavailable and its section is empty. Only a call where the feed, the hashtag board and Google Trending Now all fail is refunded. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `country_code` | yes | ISO 3166-1 alpha-2 country code, such as DE, US or KR. Any country Google Trends Trending Now covers. |
| `period` | no | 7 (default) or 30. The window of TikTok's hashtag board. Google Trending Now is always read over its longest window, 7 days. (7 \| 30) |
| `limit` | no | Rows per section, 1 to 10. Default 10. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/prism/trend-board" \
  --data-urlencode "country_code=DE" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the Prism Trend Board API return?

Returns what is rising in one country with no keyword: TikTok posts far above their author's usual views, the most used sounds, TikTok's hashtag board and Google trending searches. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the Prism Trend Board endpoint?

Use it to scan a country for trends before you have a term to search. The board is computed on each call and keeps no history.

### How much does the Prism Trend Board API cost?

Each call costs 30 credits, so the 100 free credits every new account gets cover 3 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Prism Trend Board API need?

The one required parameter is country_code (iSO 3166-1 alpha-2 country code, such as DE, US or KR). It also accepts 2 optional parameters, all listed on this page.

### How do I call the Prism Trend Board API?

Send a GET request to https://www.socialcrawl.dev/v1/prism/trend-board?country_code=DE with your API key in the x-api-key header. An Authorization: Bearer header works too.

See the full Prism API: https://www.socialcrawl.dev/platforms/prism

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What does the SocialCrawl Prism Trend Board API return?
- How do I get Prism Trend Board data with the SocialCrawl API?