# App Store Keyword Rank Tracker (ASO, New App Flags) (`scrapebench/app-store-keyword-rank-tracker`) Actor

See which apps rank for a keyword in App Store search, up to about 240 deep, with rating, ratings count, price, genre and developer. Track your own apps' ranks and flag apps released in the last 30 days.

- **URL**: https://apify.com/scrapebench/app-store-keyword-rank-tracker.md
- **Developed by:** [ScrapeBench](https://apify.com/scrapebench) (community)
- **Categories:** SEO tools
- **Features:** Limited permissions
- **Stats:** 4 total users, 3 monthly users, 33.3% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.0015 / ranked app

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## App Store Keyword Rank Tracker (ASO, New App Flags)

### Pain points

- A keyword's ranking list is only visible one search at a time on a device, so tracking ten keywords across a week means a lot of manual searching.
- Knowing your own rank is half the picture: to act on it you need to see who ranks around you, with their ratings, price and genre.
- New apps that break into a keyword's results are the competitors worth watching, and nothing in the store marks them.

### What we solve

- One run returns every ranked app for each keyword you list, in the order the App Store shows them, down to the depth you choose (up to about 240).
- Each row has the rank, app name and id, developer, rating, ratings count, price, genres, release date and the app's store link, plus everything else the store lists for the app.
- Add your own app ids or store links and get one summary row per keyword with the app's rank, or an empty rank when it is not listed.
- Switch on the new app flag to mark apps first released in the last 30 days, with the developer's website and e-mail where known.

### Summary

Check where any app ranks for a keyword in App Store search. List your keywords, pick a country (United States, United Kingdom, Germany or Japan) and a depth, and get one row per ranked app in the store's own order: rank, app name and id, developer, rating, ratings count, price, genres, release date, version, content rating, developer website and store link, with the description, release notes, screenshots, supported devices and every other field the store lists kept in the row. Add your own apps' ids or links to get a rank, or an empty rank, for each of them under every keyword. Turn on Flag new apps to mark the ranked apps released in the last 30 days, with the developer's website and e-mail where known: the new competitors entering your keywords. Pay per keyword checked and per ranked app returned; tracked-app summary rows and notices are free.

### Who it's for

- App developers and indie makers tracking where their app ranks for the keywords they target
- ASO agencies and growth teams monitoring keyword rankings for clients
- Product and competitor analysts watching who ranks in a category
- Marketing and sales teams finding newly launched apps in a niche, with the developer's website

### How to use

Set the input, run the actor, and collect results from the run's dataset (export to JSON/CSV/Excel, or pull via the Apify API). Example input:

```json
{
  "keywords": [
    "habit tracker",
    "mood journal"
  ],
  "country": "us",
  "depth": 50,
  "flagNewApps": true
}
```

See **Inputs** below for every available field.

### What you get

One row per record:

| Field | Description |
|---|---|
| `keyword` | The search term checked |
| `country` | The App Store country |
| `rank` | Position in the store's results for the keyword (1 = first) |
| `app_id` | The App Store id of the app |
| `app_name` | The app's name |
| `source_url` | The app's App Store page |
| `developer_name` | The developer name |
| `developer_id` | The developer's App Store id |
| `bundle_id` | The app's bundle id |
| `category` | The app's primary genre |
| `genres` | Every genre the app is listed under |
| `price` | List price; 0 = free |
| `currency` | Currency of the price |
| `rating` | Average star rating |
| `ratings_count` | Number of ratings |
| `version` | Current version |
| `release_date` | Day the app was first released (UTC) |
| `website` | The developer's website as the store lists it |
| `new_app` | With 'Flag new apps': true when first released in the last 30 days |
| `email` | With 'Flag new apps': the developer's e-mail for a new app, where known |
| `row_type` | ranked, or tracked for the free summary of an app you track |
| `extras` | Everything else the store lists: description, release notes, screenshots, languages, devices, size |

Sample:

```json
{
  "row_type": "ranked",
  "keyword": "habit tracker",
  "country": "us",
  "rank": 1,
  "positions_read": 250,
  "app_id": "1438388363",
  "source_url": "https://apps.apple.com/us/app/habit-tracker/id1438388363",
  "app_name": "Habit Tracker",
  "bundle_id": "com.davetech.habit",
  "developer_name": "InnerGrow",
  "developer_id": "1828382777",
  "developer_url": "https://apps.apple.com/us/developer/innergrow/id1828382777",
  "seller_name": "Inner Grow Limited",
  "category": "Productivity",
  "genres": [
    "Productivity",
    "Health & Fitness"
  ],
  "price": 0.0,
  "formatted_price": "Free",
  "currency": "USD",
  "rating": 4.79,
  "ratings_count": 149076,
  "version": "2.15.14",
  "release_date": "2019-01-31",
  "current_version_date": "2026-11-18",
  "content_rating": "4+",
  "website": null,
  "new_app": false,
  "email": null
}
```

### Inputs

| Field | Required | Type | Default | Description |
|---|---|---|---|---|
| `keywords` | no | array | `["habit tracker"]` | Search terms to check, one per entry, e.g. habit tracker. Each keyword returns its own ranked list. |
| `keyword` | no | string | — | One search term, for saved tasks. Added to 'Keywords' when both are set. |
| `country` | no | string | `"us"` | The App Store country whose search results are read. Rankings differ by country. |
| `depth` | no | integer | `100` | How many ranks to return per keyword, from rank 1. The store lists about 240 apps per keyword; more than it lists returns what it has. Each ranked app is one billed row. |
| `trackApps` | no | array | `[]` | App ids or App Store links (apps.apple.com/.../id123456789). Each gets one summary row per keyword with its rank anywhere in the store's list, or an empty rank when it is not listed. Summary rows are free. |
| `flagNewApps` | no | boolean | `false` | Mark ranked apps first released in the last 30 days (new_app true) and add the developer's website and e-mail where known. A new app with a website or e-mail is charged one 'New app contact' event. |

### Pricing (Pay Per Event)

You pay per result (`ranked-app`) — **no charge for empty runs**. Example: **1000 ranked apps** at *$0.0015/result* ≈ **$1.50**.

Three events. 'Keyword checked' ($0.004) once per keyword read; 'Ranked app' ($0.0015) per ranked app returned, so one keyword at depth 100 costs about $0.154; 'New app contact' ($0.01) only for a ranked new app that carries a website or e-mail, when 'Flag new apps' is on. Rows that track your own apps and notices are free.

### Use cases

- A weekly rank check of your own app across 20 keywords, scheduled every Monday.
- The top 100 apps for a keyword with their ratings counts, to see how hard it is to break in.
- New apps that entered a keyword's results this month, with the developer's website, for competitor watching or outreach.
- Comparing the same keyword's results across the United States, United Kingdom, Germany and Japan.

### Why this actor

- The store's own order: ranks are the positions the App Store itself lists, down to about 240 per keyword.
- Rank, rating, ratings count, price, genre and developer on every row, and every other field the store lists kept in the row.
- Track your own apps and get a rank, or an empty rank, for each keyword.
- Flag apps released in the last 30 days, with the developer's website and e-mail where known.
- Pay per keyword and per ranked app; summary rows and notices are free.

### Limitations & updates

Covers the App Store (iPhone) in the United States, United Kingdom, Germany and Japan; Google Play and other countries are not included. It returns the ranked apps and their store facts, with no keyword popularity or difficulty scores. Ranks are the order returned when the run happens and can differ slightly between devices and move during the day. The store lists about 240 apps per keyword. New app e-mails exist only where the developer publishes one; many new apps list a website only.

### FAQ

**How deep can I go?**

The App Store lists around 240 apps for a keyword, and Depth goes up to 250. Ask for more than the store lists and you get what it lists.

**Which countries are covered?**

The United States, United Kingdom, Germany and Japan. Rankings differ by country, so a keyword is checked in the one you pick.

**Will the rank match what I see on my phone?**

It is the order the App Store returns for that keyword and country when the run happens. Results can differ a little from one device or account to the next and move during the day.

**What does a tracked app row look like?**

One row per keyword and tracked app with its rank anywhere in the store's list for that keyword, or an empty rank when it is not listed, and the number of apps the store listed. These rows are free.

**What counts as a new app?**

An app first released in the last 30 days (UTC). With Flag new apps on, every row says new_app true or false, and a new app also carries the developer's website and e-mail where known. Only new apps with a website or e-mail are charged 'New app contact'.

**Does it give search popularity or difficulty scores?**

No. It returns the ranked apps themselves and their store facts, not keyword volume or difficulty numbers.

**Why is a rank missing from the list?**

The store sometimes lists app bundles in a keyword's results. They hold a rank but are not apps, so they get no row; the ranks of the apps around them stay the store's own.

### Guides & use cases

Written up on **[scrapebench.dev](https://scrapebench.dev)** — the bench that runs and verifies this actor against the live source every night:

- **How-to:** [How to run App Store Keyword Rank Tracker (ASO, New App Flags)](https://scrapebench.dev/guides/how-to-app-store-keyword-rank-tracker/)
- **Use case:** [New competitor apps entering your App Store keywords](https://scrapebench.dev/use-cases/new-competitor-apps-in-app-store-keywords/)

More actors, coverage and nightly verification results: **[scrapebench.dev](https://scrapebench.dev)**

### Works with AI assistants (MCP)

Callable as an MCP tool, so Claude, Cursor, VS Code Copilot and other MCP clients can run it directly. Grab the config from the [MCP tab](https://apify.com/scrapebench/app-store-keyword-rank-tracker/api/mcp) on this page — Apify hosts the server and keeps that snippet current, and OAuth signs you in on first connect, so no API token goes in your config file.

Then just ask:

> "Where does my app rank in the US App Store for 'habit tracker' and 'mood journal', and which apps in the top 50 were released in the last 30 days?"

That is keywords \['habit tracker', 'mood journal'], depth 50, flagNewApps true; add your app's id to trackApps to get its rank. Keep depth small on a first call. Runs started this way bill exactly like any other run.

### Data & lawful use

This actor collects publicly available information that Apple Inc. (the App Store) publishes for public
lookup — licence records, business listings and the contact details professionals list there.
Some of it identifies individuals (sole proprietors, licence holders, agents), so treat any
names, phone numbers and emails in your results as personal data.

When you run this actor, you decide what is collected and what it is used for, so you are the
controller of that data and we act only as your processor (Apify Standard Actor Contract).
You need a lawful basis for your use, must honour opt-out and deletion requests, and must
follow the marketing rules that apply to you (CAN-SPAM, TCPA, GDPR, CCPA and similar).
Don't use the output for unsolicited bulk messaging, for screening covered by the FCRA, or
for anything the source's own terms forbid.

Your results are stored in your own Apify account. We don't keep a copy of your results and
don't sell or share them.

### Disclaimer

This is an independent tool. It is not affiliated with, endorsed by or sponsored by
Apple Inc. (the App Store). Names and marks are used only to describe the data source. Records are
provided as published by the source and may be out of date or incomplete. For anything
consequential (hiring, a permit, a legal decision), confirm the record with the issuing
agency. You are responsible for making sure your use complies with applicable law and the
source's terms.

### Need help?

Open an issue on this actor's **Issues** tab and we'll respond there. Bug reports, missing
fields and feature requests are all welcome. Guides and examples: [scrapebench.dev](https://scrapebench.dev).

If you are a person named in this data and want your record removed from our copy, email
apify-help@scrapebench.dev; the source agency remains the official record.

Your run may be used to improve our services. If something looks off, or you want this actor to fit your use better, please share your run data with us: [Apify Console → Settings → Security → Share run data with developers](https://console.apify.com/settings/security). It lets us see exactly what went wrong and keep improving the actor.

If this actor saved you time, a short review on its Store page helps other buyers find it.

# Actor input Schema

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

Search terms to check, one per entry, e.g. habit tracker. Each keyword returns its own ranked list.

## `keyword` (type: `string`):

One search term, for saved tasks. Added to 'Keywords' when both are set.

## `country` (type: `string`):

The App Store country whose search results are read. Rankings differ by country.

## `depth` (type: `integer`):

How many ranks to return per keyword, from rank 1. The store lists about 240 apps per keyword; more than it lists returns what it has. Each ranked app is one billed row.

## `trackApps` (type: `array`):

App ids or App Store links (apps.apple.com/.../id123456789). Each gets one summary row per keyword with its rank anywhere in the store's list, or an empty rank when it is not listed. Summary rows are free.

## `flagNewApps` (type: `boolean`):

Mark ranked apps first released in the last 30 days (new_app true) and add the developer's website and e-mail where known. A new app with a website or e-mail is charged one 'New app contact' event.

## Actor input object example

```json
{
  "keywords": [
    "habit tracker"
  ],
  "country": "us",
  "depth": 100,
  "trackApps": [],
  "flagNewApps": false
}
```

# Actor output Schema

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

One row per ranked app; summary and notice rows are free.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapebench/app-store-keyword-rank-tracker").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("scrapebench/app-store-keyword-rank-tracker").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 '{}' |
apify call scrapebench/app-store-keyword-rank-tracker --silent --output-dataset

```

## MCP server setup

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

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/GMFt7Vadtpoye5vaM/builds/zKLkBjNB7pZqjX9tj/openapi.json
