# ASO Keyword Rank Tracker: iOS & Android App Positions (`tenfoldfleet/aso-keyword-rank-tracker-app-store-google-play`) Actor

Check where an app ranks for a keyword in App Store and Google Play search, by country: rank, change since the last run, movement and the top apps for each keyword. ASO keyword rank tracker for iOS and Android apps, $2 per 1,000 checks; failed checks are free. Free plan: 5 checks per run.

- **URL**: https://apify.com/tenfoldfleet/aso-keyword-rank-tracker-app-store-google-play.md
- **Developed by:** [Tenfold Fleet](https://apify.com/tenfoldfleet) (community)
- **Categories:** SEO tools, Marketing, Agents
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 keyword checks

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does ASO Keyword Rank Tracker do?

**ASO Keyword Rank Tracker** tells you **where an iOS or Android app shows up in App Store and Google Play search** for each keyword you care about. Give it a list of keywords, your apps (and your competitors' apps) and one or more countries. It returns one row per keyword, app and country with the **rank**, the **change since your last run**, the **movement** (up, down, same, new, lost) and the **top apps** that hold the first positions.

App Store is a trademark of Apple Inc. and Google Play is a trademark of Google LLC. Not affiliated with Apple or Google.

It works like an **app keyword ranking API** for **App Store Optimization (ASO)**: no API key, no developer account, no login. One input covers **both stores**, so an app with an iPhone and an Android version is tracked in a single run. Schedule it daily or weekly and it becomes an **app store keyword rank tracker** that keeps its own history and reports which keywords moved.

### Why use an ASO keyword rank tracker?

- 📈 **Measure ASO work**: see if a new title, subtitle or keyword field moved your app up for the keywords you target.
- 🥊 **Watch competitors**: add rival apps next to yours and compare positions keyword by keyword. `topApps` shows who holds the first places.
- 🌍 **Compare countries**: run the same keywords in the US, GB, DE, JP or BR stores and see where the app ranks well.
- 🔔 **Alerts on movement**: turn on **Only return positions that changed** and a scheduled run returns only the keywords that moved, entered or dropped out.
- 🏢 **Agency reporting**: keep one history store per client and export a weekly table of rank changes.
- 🤖 **AI agents and automations**: one call answers "what position is this app for this keyword?" as clean JSON, ready for Make, Zapier, n8n, Google Sheets or the [Apify MCP server](https://mcp.apify.com).

### What data can it extract?

![Sample output of ASO Keyword Rank Tracker: iOS & Android App Positions, rows from a real run: Keyword, Store, Country, App, App ID, Rank](https://api.apify.com/v2/key-value-stores/4TBgG7fopkYMNWnX2/records/aso-keyword-rank-tracker-app-store-google-play-output.png)

| Field | What it holds |
|---|---|
| `keyword`, `store`, `country` | the search phrase, `app-store` or `google-play`, and the two-letter country of the store |
| `app`, `appId` | the app as you gave it, and its App Store ID or Google Play package name |
| `appName`, `developer`, `appUrl` | the app's name, developer and store page (on Google Play the developer is filled when the app is in the results) |
| `rank`, `isRanked` | the position of the app in the search results, or `null` when it is not in the results that were read |
| `previousRank`, `rankChange`, `movement`, `previousCheckedAt` | comparison with the previous run: `up`, `down`, `same`, `new`, `lost`, `not-ranked` or `first-check`. `rankChange` is positive when the app moved up |
| `totalResultsScanned` | how many apps the store returned for the keyword (see "How positions are counted") |
| `topApps` | the first apps of the search: rank, app ID, name, developer, rating and URL |
| `suggestions` | optional: the App Store's autocomplete suggestions for the keyword |
| `language` | the Google Play language (hl); `null` on App Store rows |
| `source`, `checkedAt` | where the ranking was read from, and when |

### How to track app keyword rankings

1. Open the actor and click **Try for free**.
2. Paste your **keywords**, one per line (up to 500 per run).
3. Add your **App Store apps**: the numeric ID from the app's URL (`id324684580`), the URL itself or the bundle ID.
4. Add your **Google Play apps**: the package name (`com.spotify.music`) or the app's URL. You can fill one store or both.
5. Set the **countries** (US by default) and, for Google Play, the **language**.
6. Leave **Compare with the previous run** on and pick a **history store name** for this project.
7. Click **Start**, then download the table as JSON, CSV or Excel, or schedule the actor to run every day or week.

### How much does it cost to track app keyword rankings?

You pay per **keyword check**: one keyword checked for one app in one country, at **$2 per 1,000 checks** ($0.002 each), plus a tiny start fee of $0.00005 per run. 10 keywords x 3 apps x 2 countries = 60 checks = $0.12.

An app that is not in the results is a real answer ("not ranked") and is charged. These are **free**: searches a store did not answer, keywords with no results, apps that do not exist in the store (they are looked up before the run), invalid apps, countries and languages, and, with **Only return positions that changed** on, every position that did not move. The same keyword typed twice with different capitals is checked once, and so is the same app given as both an App Store ID and a bundle ID. Set a **maximum cost per run** in the run options and the actor stops cleanly when it is reached.

**Free Apify plan:** a run makes the first **5 checks** of its list and skips the rest with a free notice row. Any paid Apify plan removes that limit.

### Input

```json
{
    "keywords": ["habit tracker", "music streaming"],
    "iosApps": ["324684580", "com.davetech.habit"],
    "androidApps": ["com.spotify.music"],
    "countries": ["US", "DE"],
    "language": "en",
    "topResults": 10,
    "compareWithPreviousRun": true,
    "onlyChanges": false,
    "historyStoreName": "aso-rank-history",
    "includeSuggestions": false
}
```

### Output

One row per keyword, app and country. Download as JSON, CSV, Excel or HTML, or read it from the API.

```json
{
    "keyword": "music streaming",
    "store": "app-store",
    "country": "US",
    "language": null,
    "app": "324684580",
    "appId": "324684580",
    "appName": "Spotify: Music and Podcasts",
    "developer": "Spotify",
    "rank": 1,
    "isRanked": true,
    "previousRank": 2,
    "previousCheckedAt": "2026-11-09T06:00:12.412Z",
    "rankChange": 1,
    "movement": "up",
    "totalResultsScanned": 245,
    "topApps": [
        { "rank": 1, "appId": "324684580", "name": "Spotify: Music and Podcasts", "developer": "Spotify", "rating": 5 },
        { "rank": 2, "appId": "913943275", "name": "TIDAL Music: HiFi Sound", "developer": "TIDAL Music AS", "rating": 4.5 }
    ],
    "suggestions": null,
    "source": "app-store-search",
    "checkedAt": "2026-11-10T06:00:09.127Z"
}
```

Every row also has `appUrl`, and every entry of `topApps` a `url`: the app's page in the store (left out of the example above).

Rows that could not be checked carry an `error` and a `reason` (`search-failed`, `store-unavailable`, `no-results`, `app-not-found`, `app-lookup-failed`, `invalid-app`, `invalid-keyword`, `invalid-input`, `no-input`, `input-limit`, `free-plan-limit`, `error`) and are never charged.

### How positions are counted

- **App Store**: the iPhone search results of the country's store, in the store's order, usually **200 to 250 apps deep**. If that source does not answer, the actor reads the public iTunes Search API (up to 200 apps) and says so in `source`. The two sources can order apps a little differently, so compare rows with the same `source`.
- **Google Play**: the first results page of Play search for the country and language, usually **20 to 30 apps deep** (a few keywords return as few as 12, some up to 50). When the keyword is an app's name, Google shows that app in a large card first; it counts as rank 1. An app that is not on the first page comes back with `rank: null`.
- Ads and editorial stories are not counted. Both stores personalise results a little by device and account, and Google Play can vary by request, so a position can differ by a place or two from what you see on your phone.
- `rating` in `topApps` is the star value the store shows in its results list, which the App Store rounds to half stars.

### Tips

- **Track iPhone and Android together**: put the App Store ID in `iosApps` and the package name in `androidApps`. Each store's keywords are searched once, however many apps you add, so competitors cost only the extra checks.
- **Daily tracking for less**: schedule the actor with `onlyChanges` on. The first run saves every position; later runs return and charge only what moved.
- **Separate projects**: use a different `historyStoreName` per app or client. The history lives in a named key-value store in your own account and is kept until you delete it.
- **Find new keywords**: turn on `includeSuggestions` to get the App Store's autocomplete phrases for each keyword, then add the good ones to your list.
- **Localised keywords**: type keywords in the language of the store you check, for example German phrases for `DE`.

### FAQ

#### Do Apple or Google have an API for app keyword rankings?

No, neither store has one. Apple's and Google's developer consoles show installs and impressions, not the position of an app for a keyword, and nothing at all for competitors' apps. This actor reads the public search results that every user sees.

#### Does it need my developer account or a login?

No. It needs no Apple ID, no Google account, no API key and no cookies. It only reads public search results.

#### Why is my app "not ranked" on Google Play when I can find it by scrolling?

Google Play's search page lists about 20 to 30 apps for a keyword, and that is how deep this actor looks. `totalResultsScanned` tells you how many apps were read for each row.

#### Can I use a bundle ID instead of the App Store ID?

Yes. A bundle ID such as `com.spotify.client` is looked up in each country's store and turned into the App Store ID. If the lookup fails, use the numeric ID from the app's App Store URL.

#### Which countries are supported?

Every country that has an App Store or Google Play storefront: about 175 App Store countries. Use two-letter codes such as `US`, `GB`, `DE`, `FR`, `JP`, `KR`, `BR`, `IN` or `AU`. An app that is not sold in a country's App Store comes back as a free `app-not-found` row for that country.

#### How do I get the rank history as a table?

Each run's dataset holds that day's positions with `previousRank` and `rankChange`. Schedule the actor and send each run to Google Sheets, or read the datasets from the API, to build a history table. The last position of every keyword is also kept in your history store under the key `RANKS`.

#### How many keywords can I check?

Up to 500 keywords, 25 apps per store and 25 countries per run, and at most 5,000 store searches (keywords x countries x stores) in one run. Anything over a limit is skipped with a free notice row. Split bigger lists into several runs or schedules.

### Disclaimer

This actor reads only public search results of the App Store and Google Play. It collects no personal data. Positions are a snapshot at the time of the run and are not guaranteed to match every device. You are responsible for how you use the data and for following the terms of the stores you check.

### More tools from Tenfold Fleet

| Actor | Output |
|---|---|
| [Google Keyword Planner Alternative - Ideas, Bids & Volume](https://apify.com/tenfoldfleet/google-keyword-planner) | keyword idea |
| [Google Maps Rank Tracker - Geo-Grid Rank Changes & Competitors](https://apify.com/tenfoldfleet/google-maps-rank-tracker) | grid point checked |
| [Google AI Overviews Checker - Citations & Domain Tracker](https://apify.com/tenfoldfleet/google-ai-overviews-checker) | keyword checked |
| [Google Images API - Image Search Results in 90+ Countries](https://apify.com/tenfoldfleet/google-images-api) | image result |
| [Google Trends Scraper - Search Interest by Region and Over Time](https://apify.com/tenfoldfleet/google-trends-scraper) | keyword |
| [Keyword Ideas & Related Keywords - Difficulty, Volume & CPC](https://apify.com/tenfoldfleet/keyword-ideas) | keyword idea |
| [Keyword Search Volume Checker - Bulk CPC & Keyword Difficulty](https://apify.com/tenfoldfleet/keyword-search-volume) | keyword with data |
| [SEO Competitor Keywords - Domain Ranked Keywords & Keyword Gap](https://apify.com/tenfoldfleet/seo-competitor-keywords) | keyword |
| [Google Ads Transparency Center Scraper - Competitor Ads by Site](https://apify.com/tenfoldfleet/google-ads-transparency-scraper) | ad |
| [Google Flights API & Scraper - Fares by Route and Date](https://apify.com/tenfoldfleet/google-flights-scraper) | route search |
| [Google Hotels Scraper - Nightly Prices, Stars & Booking Sites](https://apify.com/tenfoldfleet/google-hotels-scraper) | hotel |
| [Google for Jobs Scraper - Openings by City, Pay & Job Board](https://apify.com/tenfoldfleet/google-jobs-scraper) | job listing |

All 122 tools: [apify.com/tenfoldfleet](https://apify.com/tenfoldfleet). If this Actor saves you time, save it (the bookmark on its Store page) and leave a review: both help other people find it. Found a bug or need another field? Tell us on the Issues tab of this page.

# Changelog

This Actor's version history is a separate document: https://apify.com/tenfoldfleet/aso-keyword-rank-tracker-app-store-google-play/changelog.md

# Actor input Schema

## `keywords` (type: `array`):

Search phrases to check, one per line, exactly as a user would type them into App Store or Google Play search. Up to 500 keywords per run. One check = one keyword for one app in one country. Free Apify plan: the first 5 checks of a run are made; any paid plan removes the limit.

## `iosApps` (type: `array`):

Apps to find in App Store search: the numeric App Store ID (324684580 or id324684580), an apps.apple.com URL, or a bundle ID (com.spotify.client). Up to 25 apps. An app that is not in a country's App Store is a free error item, not a charged row. Leave empty to check Google Play only.

## `androidApps` (type: `array`):

Apps to find in Google Play search: the package name (com.spotify.music) or a play.google.com app URL. Up to 25 apps. A package that does not exist is a free error item, not a charged row. Leave empty to check the App Store only.

## `countries` (type: `array`):

Two-letter country codes of the stores to check, e.g. US, GB, DE, JP, BR. Rankings differ by country. Every keyword is checked for every app in every country: 10 keywords x 2 apps x 3 countries = 60 checks. Up to 25 countries.

## `language` (type: `string`):

Language of the Google Play results, e.g. en, de, es, pt-BR, ja. The App Store always answers in the language of the country's store.

## `topResults` (type: `integer`):

How many of the first apps of each search to return in topApps (rank, ID, name, developer, rating), from 0 to 50. It does not change the price.

## `includeSuggestions` (type: `boolean`):

Add the App Store's autocomplete suggestions for each keyword to its App Store rows (related keywords to track next). Free. Not available for Google Play; null when the App Store gives none.

## `compareWithPreviousRun` (type: `boolean`):

Save every rank in a named key-value store in your account and report previousRank, rankChange and movement (up, down, same, new, lost) on the next run. Schedule the actor daily or weekly to track positions over time.

## `onlyChanges` (type: `boolean`):

Return and charge only the checks whose rank moved since the last run (up, down, newly ranked, lost) plus checks made for the first time. Positions that did not move are not saved and are free. Needs the rank history, so it turns the comparison on.

## `historyStoreName` (type: `string`):

Name of the key-value store in your account that keeps the rank history. Use a different name for each project or client so their histories stay separate.

## `proxyConfiguration` (type: `object`):

The Apify datacenter proxy is used by default and is enough for both stores. A residential group is replaced by datacenter.

## Actor input object example

```json
{
  "keywords": [
    "habit tracker",
    "music streaming"
  ],
  "iosApps": [
    "324684580"
  ],
  "androidApps": [
    "com.spotify.music"
  ],
  "countries": [
    "US"
  ],
  "language": "en",
  "topResults": 10,
  "includeSuggestions": false,
  "compareWithPreviousRun": true,
  "onlyChanges": false,
  "historyStoreName": "aso-rank-history",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "habit tracker",
        "music streaming"
    ],
    "iosApps": [
        "324684580"
    ],
    "androidApps": [
        "com.spotify.music"
    ],
    "countries": [
        "US"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("tenfoldfleet/aso-keyword-rank-tracker-app-store-google-play").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": [
        "habit tracker",
        "music streaming",
    ],
    "iosApps": ["324684580"],
    "androidApps": ["com.spotify.music"],
    "countries": ["US"],
}

# Run the Actor and wait for it to finish
run = client.actor("tenfoldfleet/aso-keyword-rank-tracker-app-store-google-play").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "habit tracker",
    "music streaming"
  ],
  "iosApps": [
    "324684580"
  ],
  "androidApps": [
    "com.spotify.music"
  ],
  "countries": [
    "US"
  ]
}' |
apify call tenfoldfleet/aso-keyword-rank-tracker-app-store-google-play --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tenfoldfleet/aso-keyword-rank-tracker-app-store-google-play"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/nwdNBszIvn7wdWdpl/builds/WtEVLzOYBVcK1FecZ/openapi.json
