Skip to main content

​
Market Activity

A real-time feed of all significant App Store chart movements. Shows new entries, rank ups/downs (3+ positions), and apps that dropped out of the top 100. Sorted by magnitude of change. 
GET /v1/market/activity?country=us&chart=top-free&genre=all&limit=25

​
Query Parameters

ParameterTypeDefaultDescription
countrystringusISO country code
chartstringtop-freeChart type: top-free, top-paid, top-grossing
genrestringallGenre ID or all
limitnumber25Max activities (1-50)

​
Response

{
  "ok": true,
  "data": {
    "country": "us",
    "genreId": "all",
    "chartType": "top-free",
    "activities": [
      {
        "type": "new_entry",
        "appId": "111222333",
        "appName": "Breakout App",
        "developer": "Hot Dev",
        "iconUrl": "https://...",
        "genreName": "Games",
        "chartType": "top-free",
        "currentRank": 3,
        "previousRank": null,
        "rankChange": 98,
        "timestamp": "2026-02-24"
      },
      {
        "type": "rank_up",
        "appId": "123456789",
        "appName": "Climbing App",
        "developer": "Dev Co",
        "iconUrl": "https://...",
        "genreName": "Productivity",
        "chartType": "top-free",
        "currentRank": 8,
        "previousRank": 42,
        "rankChange": 34,
        "timestamp": "2026-02-24"
      },
      {
        "type": "rank_down",
        "appId": "987654321",
        "appName": "Sliding App",
        "developer": "Other Dev",
        "iconUrl": "https://...",
        "genreName": "Entertainment",
        "chartType": "top-free",
        "currentRank": 78,
        "previousRank": 12,
        "rankChange": -66,
        "timestamp": "2026-02-24"
      },
      {
        "type": "dropped_out",
        "appId": "444555666",
        "appName": "Gone App",
        "developer": "Former Dev",
        "iconUrl": "https://...",
        "genreName": "Social Networking",
        "chartType": "top-free",
        "currentRank": null,
        "previousRank": 95,
        "rankChange": -6,
        "timestamp": "2026-02-24"
      }
    ],
    "totalCount": 47
  }
}

​
Activity Types

TypeDescription
new_entryApp appeared in the top 100 for the first time (wasn’t in previous snapshot)
rank_upApp improved by 3+ positions
rank_downApp dropped by 3+ positions
dropped_outApp was in previous top 100 but is no longer

​
Credit Cost

2 credits per request.

​
Use Cases

  • Daily briefing: Get a quick overview of what changed in the charts overnight
  • Alert pipeline: Feed activity data into Slack/Discord bots for real-time competitive alerts
  • Trend analysis: Identify patterns in chart volatility across categories
  • Breakout spotting: Catch new apps entering the top 100 before they go mainstream