app downloads and app rankings are keyword sources. The keyword is an Android bundle ID, not an app name. Find it on Google Play: open the app's details page and copy the id= query. Example URL shape: https://play.google.com/store/apps/details?id=com.whatsapp. The keyword is com.whatsapp. The call is still POST https://api.trendsapi.ai/api. Parse the string body on the envelope. Other keyword rules sit on keyword formats. The source list sits on the sources hub.
Right and wrong strings
| Intent | Keyword | Result |
|---|---|---|
| ChatGPT on Android | com.openai.chatgpt |
Valid |
| ChatGPT as a name | ChatGPT |
Will not resolve |
| WhatsApp on Android | com.whatsapp |
Valid |
| WhatsApp as a name | WhatsApp |
Will not resolve |
| iOS App Store numeric ID | 123456789 |
Wrong platform |
| A bundle ID that is not Android | an iOS reverse-DNS that is not on Play | Will not resolve |
POST https://api.trendsapi.ai/api
Authorization: Bearer <api_key>
Content-Type: application/json
{"mode":"get_growth","source":"app downloads","keyword":"com.whatsapp","percent_growth":["3M","12M"]}
app rankings uses the same keyword format. Swap only the source string.
The two keyword sources
source |
Series |
|---|---|
app downloads |
Android download history for that bundle ID |
app rankings |
Android chart-rank history for that bundle ID |
Both take get_time_series or get_growth. Neither takes type. Neither is a live store board.
Live store boards are a different call
type on get_top_trends |
What it is |
|---|---|
App Store Top Free |
iOS free chart, no keyword |
App Store Top Paid |
iOS paid chart, no keyword |
Google Play |
Google Play top apps, no keyword |
Those labels belong on the feed catalog. How to send get_top_trends is on the live feeds page. The product write-up for store charts is the App Store guide.
Mixed source lists
If get_growth includes app downloads or app rankings next to tiktok or google search, the keyword must still be the Android bundle ID. There is no second keyword field. Use separate POSTs when the other source needs a phrase.
Play's own URL format is documented by Google at the Play Store details URL. Plan names stay on pricing.