English Français العربية

App Store Trends API

Official registry AI and agents

App downloads and chart ranking trends for iOS and Android. Free key at trendsapi.ai

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http app-store-trends-api 'https://app-store.api.trendsapi.ai/mcp' --header 'Authorization: <Bearer token. Get your free API key at https://trendsapi.ai>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "app-store-trends-api": {
            "type": "http",
            "url": "https://app-store.api.trendsapi.ai/mcp",
            "headers": {
                "Authorization": "<Bearer token. Get your free API key at https://trendsapi.ai>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. App Store and Google Play chart API
  2. Authentication
  3. Methods
  4. get_time_series
  5. get_growth
  6. get_live
  7. Async
  8. Pandas
  9. Call (curl)
  10. Source notes
  11. Errors
  12. License

App Store and Google Play chart API

App Store and Google Play demand via the Trends API. Android download history plus live iOS and Play charts.

Key: trendsapi.ai/#get-key. HTTP contract and every source: trendsapi-ai/trendsapi.

Authentication

pip install trendsapi-app-store
export TRENDSAPI_KEY=your_key

Python 3.9+. Same key as the HTTP API.

from trendsapi_app_store import TrendsAPI

client = TrendsAPI()                    # TRENDSAPI_KEY
# client = TrendsAPI(api_key="YOUR_KEY")

Keyword helpers default to source: "app downloads". Pass source= to hit any other platform with the same client. Official full client (every source, no preset): trendsapi.

Methods

MethodREST modeReturns
get_time_series(keyword, source=, data_mode=)get_time_serieslist[TrendsDataPoint]
get_growth(keyword, percent_growth=, source=, data_mode=)get_growthGetGrowthResponse
get_live(limit=, offset=, category=)get_top_trendsGetTopTrendsResponse
get_top_trends(type=, ...)get_top_trendsGetTopTrendsResponse

source is lowercase (app downloads). type is exact (App Store Top Free). Mixing them is a 400.

from trendsapi_app_store import TrendsAPI

client = TrendsAPI()                    # TRENDSAPI_KEY
# client = TrendsAPI(api_key="YOUR_KEY")

series = client.get_time_series("com.openai.chatgpt")
print(series[-1].date, series[-1].value)

growth = client.get_growth("com.openai.chatgpt", percent_growth=["3M", "12M"])
print(growth.results[0].growth, growth.results[0].direction)

hot = client.get_live(limit=10)
print(hot.data)                         # [[1, "..."], ...]

get_time_series

points = client.get_time_series("com.openai.chatgpt")

Each point:

FieldAlwaysMeaning
dateyesYYYY-MM-DD
valueyes0-100 index for this series
keywordyesEcho
volumenoAbsolute volume when available
source or datatypenoPipeline label

Python returns list[TrendsDataPoint]. Use .date and .value, not ["date"]. JS returns the same fields as object properties.

get_growth

g = client.get_growth("com.openai.chatgpt", percent_growth=["12M", "3M", "YTD"])
print(g.results[0].growth, g.results[0].direction)

percent_growth default: ["12M"]. Presets: 7D 14D 30D 1M 2M 3M 6M 9M 12M/1Y 18M 24M/2Y 36M/3Y 48M 60M/5Y MTD QTD YTD. Custom: {"name": "Launch", "recent": "2024-06-01", "baseline": "2024-01-01"}.

FieldMeaning
search_termKeyword
data_sourceSource
resultsOne object per window (period, growth, direction, dates, values)
metadataCounts / success flag

Several windows still count as one request. Python: growth.results[0].growth. JS: growth.results[0].growth.

get_live

hot = client.get_live(limit=10)
FieldMeaning
as_of_tsSnapshot time
typeFeed name
limit, offset, countPagination
data[rank, label] rows

Python: hot.data. JS: hot.data. Optional offset= and category= (Amazon Best Sellers by Category, Top Websites only).

Async

import asyncio
from trendsapi_app_store import AsyncTrendsAPI

async def main():
    c = AsyncTrendsAPI()
    return await asyncio.gather(
        c.get_time_series("com.openai.chatgpt"),
        c.get_time_series("com.openai.chatgpt", source="google search"),
    )

asyncio.run(main())

Each 200 is one billed request.

Pandas

from dataclasses import asdict
import pandas as pd
from trendsapi_app_store import TrendsAPI

df = pd.DataFrame(asdict(p) for p in TrendsAPI().get_time_series("com.openai.chatgpt"))
df["date"] = pd.to_datetime(df["date"])
print(df.set_index("date")["value"].resample("ME").mean().tail())

Call (curl)

FieldValue
EndpointPOST https://api.trendsapi.ai/api
AuthAuthorization: Bearer $TRENDSAPI_KEY
Historysource: app downloads with get_time_series or get_growth
KeywordAndroid bundle ID, e.g. com.openai.chatgpt (not chatgpt)
Live typeApp Store Top Free, App Store Top Paid, Google Play
curl -sS -X POST https://api.trendsapi.ai/api \
  -H "Authorization: Bearer $TRENDSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"get_time_series","source":"app downloads","keyword":"com.openai.chatgpt"}'

Source notes

  • chatgpt as keyword is 404. Use the Play Store id.
  • app downloads is Android history. iOS lists are live feeds only.
  • Live type values: App Store Top Free, App Store Top Paid, Google Play.

Errors

HTTPClient
200Parsed payload. Python dataclasses / JS typed objects
400Raises. Fix source or type spelling
401Raises. Check TRENDSAPI_KEY
404Raises. No series for that keyword. Do not retry
429Raises. Quota
5xxClient retries, then raises

The HTTP body field is a JSON string. SDKs decode it. Raw curl must parse body a second time.

Site: https://trendsapi.ai/trends/app-store-trends.

License

MIT. See LICENSE.

Frequently asked questions

What is App Store Trends API?

App downloads and chart ranking trends for iOS and Android. Free key at trendsapi.ai

How do I install App Store Trends API?

It runs as a remote server. In Claude Code: claude mcp add --transport http app-store-trends-api 'https://app-store.api.trendsapi.ai/mcp' --header 'Authorization: <Bearer token. Get your free API key at https://trendsapi.ai>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does App Store Trends API need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is App Store Trends API open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains App Store Trends API?

It is published by trendsapi-ai. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.