Skip to main content

Market Movers

Identifies apps with the biggest rank changes between chart snapshots. Compares the latest snapshot with the previous one to surface top gainers, top losers, new entries, and apps that dropped out.
GET /v1/market/movers?country=us&chart=top-free&genre=all&limit=10

Query Parameters

ParameterTypeDefaultDescription
countrystringusISO country code
chartstringtop-freeChart type: top-free, top-paid, top-grossing
genrestringallGenre ID (e.g. 6014 for Games) or all
limitnumber10Max results per section (1-25)

Response

{
  "ok": true,
  "data": {
    "chartType": "top-free",
    "country": "us",
    "genreId": "all",
    "period": {
      "current": "2026-02-24",
      "previous": "2026-02-23"
    },
    "topGainers": [
      {
        "appId": "123456789",
        "appName": "Rising App",
        "developer": "Developer Inc",
        "iconUrl": "https://...",
        "genreId": "6014",
        "genreName": "Games",
        "currentRank": 12,
        "previousRank": 67,
        "rankChange": 55,
        "rating": 4.7,
        "reviewCount": 12500
      }
    ],
    "topLosers": [
      {
        "appId": "987654321",
        "appName": "Declining App",
        "developer": "Other Dev",
        "iconUrl": "https://...",
        "genreId": "6016",
        "genreName": "Entertainment",
        "currentRank": 89,
        "previousRank": 15,
        "rankChange": -74,
        "rating": 3.2,
        "reviewCount": 8000
      }
    ],
    "newEntries": [
      {
        "appId": "111222333",
        "appName": "Brand New App",
        "developer": "New Dev",
        "iconUrl": "https://...",
        "genreId": "6007",
        "genreName": "Productivity",
        "currentRank": 5,
        "previousRank": null,
        "rankChange": 96,
        "rating": 4.9,
        "reviewCount": 500
      }
    ],
    "droppedOut": [
      {
        "appId": "444555666",
        "appName": "Gone App",
        "developer": "Former Dev",
        "iconUrl": "https://...",
        "genreId": "6005",
        "genreName": "Social Networking",
        "currentRank": 0,
        "previousRank": 95,
        "rankChange": -6,
        "rating": 2.8,
        "reviewCount": 3000
      }
    ]
  }
}

Rank Change Interpretation

rankChangeMeaning
PositiveApp moved UP (e.g. +55 means went from rank 67 → 12)
NegativeApp moved DOWN (e.g. -74 means went from rank 15 → 89)
previousRank: nullNew entry to chart
currentRank: 0Dropped out of top 100

Credit Cost

3 credits per request.

How It Works

Chart snapshots are taken every 6 hours (00:00, 06:00, 12:00, 18:00 UTC). This endpoint compares the two most recent snapshots to calculate rank changes. Data availability depends on snapshot history — at least two snapshots on different dates are needed to show results.

Use Cases

  • Competitive monitoring: Track when competitors surge or fall in the charts
  • Breakout detection: Spot apps entering the top 100 for the first time
  • Category trends: Filter by genre to monitor specific verticals
  • Market research: Understand overall chart volatility and seasonality