App RevsApp Revs

Documentation

App Revs exposes Apple's public App Store data two ways: a REST API, and an MCP server whose 28 tools call it. 15 of the tools and every stored-data endpoint work without an account.

Introduction

  • Keywords: popularity (Apple Ads, monthly, 90 stores), difficulty with its inputs, the top 10, 15 months of history, the 500 most searched per genre.
  • Apps: the terms an app ranks for, its competitors from shared terms, chart places in 20 stores, ratings by day, written reviews and their summary.
  • Publishers and the store: every app a publisher sells; apps rising by ratings; apps launched lately that already rank.
  • Your account (with a key): the apps you follow, their keyword lists per store, nightly positions, this week's movement.

Two ways in, same data: the MCP server at https://api.apprevs.com/mcp for Claude, Cursor, ChatGPT and any MCP client; the REST API at https://api.apprevs.com/api/v1 for everything else.

Authentication

Stored data needs no key. Live App Store lookups, keyword analysis on demand, and anything about your own apps take one. Sign in with Google, open Settings, generate a key; it is shown once.

REST
X-API-Key: ar_live_your_api_key
MCP
Authorization: Bearer ar_live_your_api_key

Quickstart

The public keyword endpoint, no key:

curl
curl "https://api.apprevs.com/api/v1/keywords/habit%20tracker?country=us"

Claude Code, with a key, then ask it anything on the site:

shell
claude mcp add --transport http apprevs https://api.apprevs.com/mcp --header "Authorization: Bearer ar_live_..."

A script analyzing three terms for an app in the German store:

curl
curl "https://api.apprevs.com/api/v1/keywords/analyze?q=habit%20tracker,streaks,routine&country=de&app_id=6443918070" -H "X-API-Key: ar_live_..."

Connect lines for Claude.ai, Cursor and ChatGPT are on the MCP page.

Endpoints

Every endpoint by whether it needs a key. Parameters, examples and response shapes are in the API reference; errors, rate limits and conventions are at the top of it.

Without a key

Stored data: what the nightly and weekly jobs read. Cached, no limits enforced; be reasonable.

  • GET/keywords/{term}?country, app_id

    Popularity, 15 months of demand, difficulty with its inputs, the top 10, related terms, the app's position.

  • GET/apps/{track_id}/keywords?country

    Every analyzed term the app ranks for, and its genre chart places.

  • GET/apps/{track_id}/competitors?country

    Apps in the top 10 of the terms it ranks for, by how many they share.

  • GET/apps/{track_id}/charts

    Genre chart places across 20 stores with the week's movement.

  • GET/apps/{track_id}/positions

    Top-10 terms per store where the app was checked.

  • GET/apps/{track_id}/storefronts

    Ratings, price and release per storefront.

  • GET/apps/{track_id}/rating-history?country, days

    Rating and count by day, releases, reviews per day.

  • GET/apps/{track_id}/reviews/summary?country

    Star split of the stored written reviews.

  • GET/developers/{artist_id}?country

    A publisher and every app they sell, with ratings and chart places.

  • GET/apps/new?country, days, genre

    Recently released apps already in a top 200 or on a chart.

  • GET/apps/rising?country, days, genre, exclude_genre, launched, min_gain

    Apps gaining ratings fastest, with the gain and percent.

  • GET/most-searched?country, month, genre, q, min_popularity

    Apple Ads' top 500 terms per genre and month. 100 rows without a key.

  • GET/storefronts

    What is read per storefront: popularity month, charts, ratings scan, metadata language.

  • GET/localizations

    Default and additional metadata languages for all 175 storefronts.

  • GET/benchmarks

    The full app-economics benchmark dataset: categories, countries, regions and every reference table.

  • GET/benchmarks/categories

    One row per app category with all metrics: cost, conversion, LTV, store CVR, retention.

  • GET/benchmarks/countries

    Apple Search Ads cost by country: CPT, CPI, CPA, TTR, conversion, CPM.

  • GET/benchmarks/regions

    Subscription funnel by region: RPI, conversion, LTV per payer, plan mix, refunds.

With a key

Live App Store calls and your own apps, lists and week. Keys are made in Settings and shown once.

  • GET/apps/search?q, country, limit

    Live App Store search.

  • GET/apps/lookup/{track_id}?country

    The full App Store record, cached 12 hours.

  • GET/keywords/analyze?q (up to 25, comma-separated), country, app_id

    Analyze keywords now: popularity, difficulty, top 10, position.

  • GET/keywords/{term}/history?country

    Monthly popularity per genre.

  • POST/apps/{track_id}/keywords/scan?country

    Find and analyze candidate keywords for an app.

  • GET/apps/{track_id}/overview?country

    The app's keywords, the app it loses to, next steps.

  • GET/apps/{track_id}/reviews?country, limit

    Written reviews with the rating distribution.

  • GET/projects

    The apps and ideas you follow.

  • POST/projects?track_id or name, country, role

    Follow an app, or start an idea.

  • GET/projects/{id}/keywords/{term}

    One keyword across every store on the project.

  • GET/keywords/tracked?project_id, country

    A project's keyword list with positions and visibility.

  • POST/keywords/tracked?project_id, country, terms

    Add keywords to a list; they are checked nightly.

  • DELETE/keywords/tracked/{id}

    Remove one.

  • GET/me/week?country

    This week for every app you follow: visibility, ratings, charts, keyword moves.

  • POST/developers/{artist_id}/claim?country

    Claim a publisher; every app comes in as yours.

All documentation