keyword is a string. The format of that string depends on source. Most sources take any name or phrase. Four groups do not: npm, python, steam, and the Android pair app downloads / app rankings. The source list itself is on the sources hub. The HTTP call is POST https://api.trendsapi.ai/api. Parse the string body after the envelope comes back. Mode notes sit on the API reference.
Phrase sources
These source values take any name or phrase, the same way a search box does.
google search, google images, google news, google shopping, youtube, wikipedia, tiktok, reddit, amazon, news sentiment, news volume.
POST https://api.trendsapi.ai/api
Authorization: Bearer <api_key>
Content-Type: application/json
{"mode":"get_growth","source":"tiktok, amazon, youtube","keyword":"nike","percent_growth":["12M"]}
A live board does not take keyword. Those labels are type values on the feed catalog.
Package and project names
source |
Right | Wrong |
|---|---|---|
npm |
react, @babel/core |
React, React.js |
python |
pandas, requests |
Pandas |
npm is the npmjs.com name, case-sensitive, including the scope. python is the PyPI project name, not the import path and not the language name.
Game names
source |
Right | Wrong |
|---|---|---|
steam |
Elden Ring, CS2 |
a Steam App ID, a SteamDB slug |
The matcher uses the first Steam store search result. An ambiguous title can attach to the wrong game.
Android bundle IDs
source |
Right | Wrong |
|---|---|---|
app downloads |
com.openai.chatgpt |
ChatGPT, an iOS App Store ID |
app rankings |
com.whatsapp |
WhatsApp |
The value is the id= query on a Google Play details URL. How to find it, and why these sources are not the live App Store boards, is on the Android bundle ID page.
Mixed source lists
get_growth accepts comma-separated sources. The keyword must satisfy every source in the list. If app downloads or app rankings is in the list, the keyword stays a bundle ID. If npm is in the list, the keyword stays an exact package name. There is no per-source keyword array on this endpoint.
get_time_series accepts exactly one source. Use it when the formats cannot share one string.
Plan names stay on pricing. Platform guides start at https://trendsapi.ai/trends.