TikTok trends: trending now on X, TikTok, Pinterest, YouTube Charts and Google — the five platforms you pick, one row shape with rank, link and a metric where the platform publishes one. TikTok rows are its public top 3 hashtags per 7-, 30- and 90-day window. From $1.00 per 1,000 social trends.
Which trend sources to read, e.g. ["google", "youtube"] — x, pinterest, youtube, google and tiktok. A platform that goes quiet or refuses, and a country a platform does not carry, are never charged: each comes back as an uncharged row naming the fix. Google Trends timelines for your own terms are at steadyfetch/google-trends-scraper and today's trending searches by country at steadyfetch/google-trends-now-scraper. X returns the 50 trends it lists for the country. Pinterest returns its top search terms with the change series. YouTube means YouTube CHARTS — trending MUSIC videos and artists, not general video. Google returns the daily search trends. TikTok returns the top trending hashtags TikTok shows publicly — the top 3 for each of its 7-, 30- and 90-day windows (about 9 rows; TikTok keeps the rest behind a login). Leave this empty and click Start to run a sample of Google and YouTube (5 rows each), charged like any run — any other setting you touched is applied to it.
Type:string[]
Default:
[]
Country
country
Optional
Two-letter country code (US, GB, DE, SA, BR …). Every platform is asked for the same country, so the rows line up. WORLDWIDE works on X only — the one platform that keeps a worldwide list; the other four publish per country and answer WORLDWIDE with an uncharged row naming the fix. X and TikTok each cover a fixed list of countries — see the README; a country they do not carry comes back the same uncharged way. Set only this and no platforms, and Start runs the sample platforms in this market.
Type:string | null
Default:US
Max trends per platform
limitPerPlatform
Optional
Hard cap on the rows taken from any one platform. X lists 50, Pinterest up to 250, YouTube Charts 230, Google 10 or so, TikTok about 9 (the top 3 per time window — the rest sit behind a TikTok login). Set only this and no platforms, and Start runs the sample platforms under it — a value above the sample's own 5 is a ceiling, not a request. Up to 250; ask for more and the run continues at 250, with one uncharged row saying so.
Type:integer | null
Minimum:1
Default:50
Max trends for the whole run
maxItems
Optional
Hard cap on delivered trends across every platform in this run. On a run with no platforms the sample's own 10 is the ceiling. Up to 5,000; ask for more and the run continues at 5,000, with one uncharged row saying so.
Type:integer | null
Minimum:1
Default:500
Max run seconds
maxRunSeconds
Optional
The run stops cleanly before this many seconds and reports what is left, instead of being killed by a timeout. When a platform refuses every connection, the run may wait a few minutes inside this window and ask again before it reports the refusal. On a run with no platforms the sample's own window is the ceiling. Anything from 30 seconds to an hour; ask outside that and the run continues at the nearest end of it, with one uncharged row saying so.