App rankings API

Mobile competitive research often means screenshotting Play Store charts or paying for a dashboard export. The app rankings source returns chart position history in the same JSON contract as the npm trends API and other keyword sources. The keyword must be the Android bundle ID.

Endpoint

POST https://api.trendsmcp.ai/api
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Find the bundle ID

Every Google Play listing exposes its package name in the URL:

https://play.google.com/store/apps/details?id=com.spotify.music
                                              ^^^^^^^^^^^^^^^^^
                                              bundle ID (keyword)

Use that string exactly. Display names like "Spotify" or "ChatGPT" will not resolve.

Get a time series

Weekly chart position trend for any Android app, normalized 0-100.

{
  "source": "app rankings",
  "keyword": "com.spotify.music"
}

Response:

[
  {
    "date": "2026-03-21",
    "value": 82,
    "volume": null,
    "keyword": "com.spotify.music",
    "source": "app rankings"
  }
]

Higher value means a stronger chart position (lower rank number on Google Play). A rising series over months signals the app is climbing leaderboards even if absolute install counts are flat.

Measure growth

Ranking momentum is often the signal investors and product teams want before download data confirms the move.

{
  "source": "app rankings",
  "keyword": "com.duolingo",
  "percent_growth": ["3M", "6M", "12M"]
}

Custom date comparison, useful after a major release or store feature placement:

{
  "source": "app rankings",
  "keyword": "com.duolingo",
  "percent_growth": [
    { "name": "post-launch chart lift", "recent": "2026-05-01", "baseline": "2026-02-01" }
  ]
}

Preset periods: 7D 14D 30D 1M 2M 3M 6M 9M 12M 1Y 18M 24M 2Y 36M 3Y 48M 60M 5Y MTD QTD YTD

Pair rankings with install data

Chart position and install volume answer different questions. Run both with the same bundle ID:

{ "source": "app rankings", "keyword": "com.openai.chatgpt", "percent_growth": ["3M"] }

{ "source": "app downloads", "keyword": "com.openai.chatgpt", "percent_growth": ["3M"] }

Rankings rising while downloads flat suggests category competitors are slowing. Downloads rising while rankings fall means the market is growing faster than this app.

See the app downloads API for install volume fields including volume_cumulative.

Code examples

Python

import requests

res = requests.post(
    "https://api.trendsmcp.ai/api",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "source": "app rankings",
        "keyword": "com.spotify.music",
        "percent_growth": ["3M", "12M"]
    }
)
data = res.json()

JavaScript

const res = await fetch("https://api.trendsmcp.ai/api", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    source: "app rankings",
    keyword: "com.spotify.music",
    percent_growth: ["3M", "12M"]
  })
});
const data = await res.json();

Live chart context

Historical rankings show trajectory. For current Play Store leaders, call get_top_trends:

{
  "mode": "top_trends",
  "type": "Google Play",
  "limit": 25
}

This returns today's ranked apps. Cross-check bundle IDs from that feed against ranking history for apps that recently entered the chart.