> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Activity

> Live feed of App Store chart movements: new entries, rank changes, and exits

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

| Parameter | Type   | Default    | Description                                        |
| --------- | ------ | ---------- | -------------------------------------------------- |
| `country` | string | `us`       | ISO country code                                   |
| `chart`   | string | `top-free` | Chart type: `top-free`, `top-paid`, `top-grossing` |
| `genre`   | string | `all`      | Genre ID or `all`                                  |
| `limit`   | number | `25`       | Max activities (1-50)                              |

## Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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

| Type          | Description                                                                  |
| ------------- | ---------------------------------------------------------------------------- |
| `new_entry`   | App appeared in the top 100 for the first time (wasn't in previous snapshot) |
| `rank_up`     | App improved by 3+ positions                                                 |
| `rank_down`   | App dropped by 3+ positions                                                  |
| `dropped_out` | App 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