# App Store & Google Play Keyword Rank Tracker (ASO) (`steadyscrape/app-keyword-rank-tracker`) Actor

Track where your app ranks for each keyword on the App Store and Google Play, in 174 countries and in each store language. Get your apps' positions and the top apps with rating and developer. Schedule it daily for ASO rank history. No login or API key.

- **URL**: https://apify.com/steadyscrape/app-keyword-rank-tracker.md
- **Developed by:** [Steady Scrape](https://apify.com/steadyscrape) (community)
- **Categories:** Developer tools, SEO tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.00 / 1,000 keyword searches

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

### What does App Store & Google Play Keyword Rank Tracker do?

**App Store & Google Play Keyword Rank Tracker** tells you **where your app ranks for each keyword** in the **Apple App Store** and **Google Play**, in **174 countries** and in **any language each store offers** — no App Store Connect or Play Console account, no API key, no login. It also returns the **top apps for each keyword** with name, developer, rating and genre, so you can see who you are competing with.

Schedule it daily and it becomes an **ASO rank tracker**: every run appends the day's positions to a history dataset you can chart.

### Why use it?

- 📈 **Track your ASO** — see if a new title, subtitle or keyword field moved your rankings, day by day.
- 🌍 **Localize with data** — the same keyword ranks differently in the US in English and in Spanish; measure each market in the language its users see.
- 🔎 **Find keywords worth targeting** — check who ranks in the top 10 and how strong they are before you pick a keyword.
- 🕵️ **Watch competitors** — track competitors' apps next to yours.
- 🤖 **Feed dashboards and alerts** — JSON, CSV or Excel, or straight into Google Sheets, Looker Studio or Slack through Apify integrations.

### Features

- ✅ **Both stores in one run** — App Store (iPhone) and Google Play.
- ✅ **Deep App Store rankings** — up to the 250th position, the same list the App Store app shows.
- ✅ **Country and language** — 174 countries; rankings change with the store language, and the Actor asks the store in the language you choose, not just the country.
- ✅ **Your apps' positions** — add your App Store ids and Google Play packages; each result says where they rank, or that they are not in the list.
- ✅ **Top apps with details** — name, developer, rating, rating count and genre of the top apps.
- ✅ **Daily history** — "History dataset name" keeps every run's results together.
- ✅ **Fair billing** — you pay per measured search. A language a store doesn't offer in a country, or a search the store refused, is reported and **not charged**.

### How to track app keyword rankings

1. Click **Try for free**.
2. Add your **keywords**, pick **countries** and, optionally, a **language**.
3. Add **your apps** (optional) to get their positions.
4. Click **Start**. To track daily, add a [schedule](https://docs.apify.com/platform/schedules) and set a **History dataset name**.

### Input example

```json
{
    "keywords": ["habit tracker", "daily planner"],
    "countries": ["us", "gb", "mx"],
    "language": "",
    "stores": ["appStore", "googlePlay"],
    "apps": ["https://apps.apple.com/us/app/habit-tracker/id1438388363", "com.habitnow"],
    "topResults": 10,
    "historyDatasetName": "my-app-rankings"
}
```

### Output example

Each measured search is one item in the dataset:

```json
{
    "date": "2026-09-16",
    "measuredAt": "2026-09-16T19:02:11.204Z",
    "store": "appStore",
    "country": "us",
    "countryName": "United States",
    "language": "en-US",
    "languageName": "English (US)",
    "keyword": "habit tracker",
    "resultsCount": 250,
    "trackedApps": [
        { "appId": "1438388363", "position": 1 }
    ],
    "topApps": [
        {
            "position": 1,
            "appId": "1438388363",
            "name": "Habit Tracker",
            "developer": "InnerGrow",
            "rating": 4.79222,
            "ratingCount": 146830,
            "genre": "Productivity",
            "url": "https://apps.apple.com/us/app/habit-tracker/id1438388363"
        }
    ]
}
```

#### Output fields

| Field | Description |
|---|---|
| `date`, `measuredAt` | UTC day and exact time of the search |
| `store` | `appStore` or `googlePlay` |
| `country`, `countryName` | Store country |
| `language`, `languageName` | Language the store answered in |
| `keyword` | The search term |
| `resultsCount` | How many apps the store returned for the search |
| `trackedApps` | Your apps for that store and their `position` (1 = first); `null` means not within `resultsCount` |
| `topApps` | The top apps with `position`, `name`, `developer`, `rating`, `ratingCount` (`null` when the store doesn't show it), `genre` and `url` |

Searches that could not be measured are listed in the run's `SUMMARY` record with the reason.

### How much does it cost?

You pay per measured search (one keyword in one country and store) — see the pricing tab. For example, 20 keywords in 3 countries on both stores are 120 searches per run. Searches that are not measured are free.

### Limitations

- **Google Play shows fewer results than the App Store**: its search page lists between 5 and 50 apps depending on the keyword and language, so positions beyond that are reported as `null`.
- The **App Store only offers some languages in each country** (the table below). Google Play accepts any listed language anywhere.
- Rankings are what an anonymous user sees in that country and language; stores can personalize results for signed-in users.
- Search popularity (keyword volume) is not included.

### Countries and languages

#### App Store: languages by country

The first language is the one used when you leave **Language** empty.

| Country | Code | Default language | Other languages |
|---|---|---|---|
| Afghanistan | `af` | English (U.K.) (`en-GB`) | — |
| Albania | `al` | English (U.K.) (`en-GB`) | — |
| Algeria | `dz` | English (U.K.) (`en-GB`) | Arabic (`ar`), French (`fr-FR`) |
| Angola | `ao` | English (U.K.) (`en-GB`) | — |
| Anguilla | `ai` | English (U.K.) (`en-GB`) | — |
| Antigua & Barbuda | `ag` | English (U.K.) (`en-GB`) | — |
| Argentina | `ar` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Armenia | `am` | English (U.K.) (`en-GB`) | — |
| Australia | `au` | English (Australia) (`en-AU`) | English (U.K.) (`en-GB`) |
| Austria | `at` | German (`de-DE`) | English (U.K.) (`en-GB`) |
| Azerbaijan | `az` | English (U.K.) (`en-GB`) | — |
| Bahamas | `bs` | English (U.K.) (`en-GB`) | — |
| Bahrain | `bh` | English (U.K.) (`en-GB`) | Arabic (`ar`) |
| Barbados | `bb` | English (U.K.) (`en-GB`) | — |
| Belarus | `by` | English (U.K.) (`en-GB`) | — |
| Belgium | `be` | English (U.K.) (`en-GB`) | Dutch (`nl-NL`), French (`fr-FR`) |
| Belize | `bz` | English (U.K.) (`en-GB`) | Spanish (Mexico) (`es-MX`) |
| Benin | `bj` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Bermuda | `bm` | English (U.K.) (`en-GB`) | — |
| Bhutan | `bt` | English (U.K.) (`en-GB`) | — |
| Bolivia | `bo` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Bosnia & Herzegovina | `ba` | English (U.K.) (`en-GB`) | Croatian (`hr-HR`) |
| Botswana | `bw` | English (U.K.) (`en-GB`) | — |
| Brazil | `br` | Portuguese (Brazil) (`pt-BR`) | English (U.K.) (`en-GB`) |
| British Virgin Islands | `vg` | English (U.K.) (`en-GB`) | — |
| Brunei | `bn` | English (U.K.) (`en-GB`) | — |
| Bulgaria | `bg` | English (U.K.) (`en-GB`) | — |
| Burkina Faso | `bf` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Cambodia | `kh` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Cameroon | `cm` | French (`fr-FR`) | English (U.K.) (`en-GB`) |
| Canada | `ca` | English (Canada) (`en-CA`) | French (Canada) (`fr-CA`) |
| Cape Verde | `cv` | English (U.K.) (`en-GB`) | — |
| Cayman Islands | `ky` | English (U.K.) (`en-GB`) | — |
| Chad | `td` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Chile | `cl` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| China | `cn` | Chinese (Simplified) (`zh-Hans`) | English (U.K.) (`en-GB`) |
| Colombia | `co` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Congo - Brazzaville | `cg` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Congo - Kinshasa | `cd` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Costa Rica | `cr` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Côte d’Ivoire | `ci` | French (`fr-FR`) | English (U.K.) (`en-GB`) |
| Croatia | `hr` | English (U.K.) (`en-GB`) | Croatian (`hr-HR`) |
| Cyprus | `cy` | English (U.K.) (`en-GB`) | Greek (`el-GR`), Turkish (`tr-TR`) |
| Czechia | `cz` | English (U.K.) (`en-GB`) | Czech (`cs-CZ`) |
| Denmark | `dk` | English (U.K.) (`en-GB`) | Danish (`da-DK`) |
| Dominica | `dm` | English (U.K.) (`en-GB`) | — |
| Dominican Republic | `do` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Ecuador | `ec` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Egypt | `eg` | English (U.K.) (`en-GB`) | Arabic (`ar`), French (`fr-FR`) |
| El Salvador | `sv` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Estonia | `ee` | English (U.K.) (`en-GB`) | — |
| Eswatini | `sz` | English (U.K.) (`en-GB`) | — |
| Fiji | `fj` | English (U.K.) (`en-GB`) | — |
| Finland | `fi` | English (U.K.) (`en-GB`) | Finnish (`fi-FI`) |
| France | `fr` | French (`fr-FR`) | English (U.K.) (`en-GB`) |
| Gabon | `ga` | French (`fr-FR`) | English (U.K.) (`en-GB`) |
| Gambia | `gm` | English (U.K.) (`en-GB`) | — |
| Georgia | `ge` | English (U.K.) (`en-GB`) | — |
| Germany | `de` | German (`de-DE`) | English (U.K.) (`en-GB`) |
| Ghana | `gh` | English (U.K.) (`en-GB`) | — |
| Greece | `gr` | English (U.K.) (`en-GB`) | Greek (`el-GR`) |
| Grenada | `gd` | English (U.K.) (`en-GB`) | — |
| Guatemala | `gt` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Guinea-Bissau | `gw` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Guyana | `gy` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Honduras | `hn` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Hong Kong SAR China | `hk` | Chinese (Traditional) (`zh-Hant`) | English (U.K.) (`en-GB`) |
| Hungary | `hu` | English (U.K.) (`en-GB`) | Hungarian (`hu-HU`) |
| Iceland | `is` | English (U.K.) (`en-GB`) | — |
| India | `in` | English (U.K.) (`en-GB`) | Hindi (`hi-IN`), Tamil (`ta-IN`), Urdu (`ur-PK`) |
| Indonesia | `id` | English (U.K.) (`en-GB`) | Indonesian (`id-ID`) |
| Iraq | `iq` | English (U.K.) (`en-GB`) | Arabic (`ar`) |
| Ireland | `ie` | English (U.K.) (`en-GB`) | — |
| Israel | `il` | English (U.K.) (`en-GB`) | Hebrew (`he-IL`) |
| Italy | `it` | Italian (`it-IT`) | English (U.K.) (`en-GB`) |
| Jamaica | `jm` | English (U.K.) (`en-GB`) | — |
| Japan | `jp` | Japanese (`ja-JP`) | English (US) (`en-US`) |
| Jordan | `jo` | English (U.K.) (`en-GB`) | Arabic (`ar`) |
| Kazakhstan | `kz` | English (U.K.) (`en-GB`) | — |
| Kenya | `ke` | English (U.K.) (`en-GB`) | — |
| Kosovo | `xk` | English (U.K.) (`en-GB`) | — |
| Kuwait | `kw` | English (U.K.) (`en-GB`) | Arabic (`ar`) |
| Kyrgyzstan | `kg` | English (U.K.) (`en-GB`) | — |
| Laos | `la` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Latvia | `lv` | English (U.K.) (`en-GB`) | — |
| Lebanon | `lb` | English (U.K.) (`en-GB`) | Arabic (`ar`), French (`fr-FR`) |
| Liberia | `lr` | English (U.K.) (`en-GB`) | — |
| Libya | `ly` | English (U.K.) (`en-GB`) | Arabic (`ar`) |
| Lithuania | `lt` | English (U.K.) (`en-GB`) | — |
| Luxembourg | `lu` | English (U.K.) (`en-GB`) | French (`fr-FR`), German (`de-DE`) |
| Macao SAR China | `mo` | Chinese (Traditional) (`zh-Hant`) | English (U.K.) (`en-GB`) |
| Madagascar | `mg` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Malawi | `mw` | English (U.K.) (`en-GB`) | — |
| Malaysia | `my` | English (U.K.) (`en-GB`) | Malay (`ms-MY`) |
| Maldives | `mv` | English (U.K.) (`en-GB`) | — |
| Mali | `ml` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Malta | `mt` | English (U.K.) (`en-GB`) | — |
| Mauritania | `mr` | English (U.K.) (`en-GB`) | Arabic (`ar`), French (`fr-FR`) |
| Mauritius | `mu` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Mexico | `mx` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Micronesia | `fm` | English (U.K.) (`en-GB`) | — |
| Moldova | `md` | English (U.K.) (`en-GB`) | — |
| Mongolia | `mn` | English (U.K.) (`en-GB`) | — |
| Montenegro | `me` | English (U.K.) (`en-GB`) | Croatian (`hr-HR`) |
| Montserrat | `ms` | English (U.K.) (`en-GB`) | — |
| Morocco | `ma` | English (U.K.) (`en-GB`) | Arabic (`ar`), French (`fr-FR`) |
| Mozambique | `mz` | English (U.K.) (`en-GB`) | — |
| Myanmar (Burma) | `mm` | English (U.K.) (`en-GB`) | — |
| Namibia | `na` | English (U.K.) (`en-GB`) | — |
| Nauru | `nr` | English (U.K.) (`en-GB`) | — |
| Nepal | `np` | English (U.K.) (`en-GB`) | — |
| Netherlands | `nl` | Dutch (`nl-NL`) | English (U.K.) (`en-GB`) |
| New Zealand | `nz` | English (Australia) (`en-AU`) | English (U.K.) (`en-GB`) |
| Nicaragua | `ni` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Niger | `ne` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Nigeria | `ng` | English (U.K.) (`en-GB`) | — |
| North Macedonia | `mk` | English (U.K.) (`en-GB`) | — |
| Norway | `no` | English (U.K.) (`en-GB`) | Norwegian (`nb-NO`) |
| Oman | `om` | English (U.K.) (`en-GB`) | Arabic (`ar`) |
| Pakistan | `pk` | English (U.K.) (`en-GB`) | Urdu (`ur-PK`) |
| Palau | `pw` | English (U.K.) (`en-GB`) | — |
| Panama | `pa` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Papua New Guinea | `pg` | English (U.K.) (`en-GB`) | — |
| Paraguay | `py` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Peru | `pe` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Philippines | `ph` | English (U.K.) (`en-GB`) | — |
| Poland | `pl` | English (U.K.) (`en-GB`) | Polish (`pl-PL`) |
| Portugal | `pt` | Portuguese (Portugal) (`pt-PT`) | English (U.K.) (`en-GB`) |
| Qatar | `qa` | English (U.K.) (`en-GB`) | Arabic (`ar`) |
| Romania | `ro` | English (U.K.) (`en-GB`) | Romanian (`ro-RO`) |
| Russia | `ru` | Russian (`ru-RU`) | English (U.K.) (`en-GB`), Ukrainian (`uk-UA`) |
| Rwanda | `rw` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| São Tomé & Príncipe | `st` | English (U.K.) (`en-GB`) | — |
| Saudi Arabia | `sa` | English (U.K.) (`en-GB`) | Arabic (`ar`) |
| Senegal | `sn` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Serbia | `rs` | English (U.K.) (`en-GB`) | Croatian (`hr-HR`) |
| Seychelles | `sc` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Sierra Leone | `sl` | English (U.K.) (`en-GB`) | — |
| Singapore | `sg` | English (U.K.) (`en-GB`) | Chinese (Simplified) (`zh-Hans`) |
| Slovakia | `sk` | English (U.K.) (`en-GB`) | Slovak (`sk-SK`) |
| Slovenia | `si` | English (U.K.) (`en-GB`) | Slovenian (`sl-SI`) |
| Solomon Islands | `sb` | English (U.K.) (`en-GB`) | — |
| South Africa | `za` | English (U.K.) (`en-GB`) | — |
| South Korea | `kr` | Korean (`ko-KR`) | English (U.K.) (`en-GB`) |
| Spain | `es` | Spanish (Spain) (`es-ES`) | Catalan (`ca-ES`), English (U.K.) (`en-GB`) |
| Sri Lanka | `lk` | English (U.K.) (`en-GB`) | — |
| St. Kitts & Nevis | `kn` | English (U.K.) (`en-GB`) | — |
| St. Lucia | `lc` | English (U.K.) (`en-GB`) | — |
| St. Vincent & Grenadines | `vc` | English (U.K.) (`en-GB`) | — |
| Suriname | `sr` | English (U.K.) (`en-GB`) | Dutch (`nl-NL`) |
| Sweden | `se` | Swedish (`sv-SE`) | English (U.K.) (`en-GB`) |
| Switzerland | `ch` | German (`de-DE`) | English (U.K.) (`en-GB`), French (`fr-FR`), Italian (`it-IT`) |
| Taiwan | `tw` | Chinese (Traditional) (`zh-Hant`) | English (U.K.) (`en-GB`) |
| Tajikistan | `tj` | English (U.K.) (`en-GB`) | — |
| Tanzania | `tz` | English (U.K.) (`en-GB`) | — |
| Thailand | `th` | English (U.K.) (`en-GB`) | Thai (`th-TH`) |
| Tonga | `to` | English (U.K.) (`en-GB`) | — |
| Trinidad & Tobago | `tt` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Tunisia | `tn` | English (U.K.) (`en-GB`) | Arabic (`ar`), French (`fr-FR`) |
| Türkiye | `tr` | English (U.K.) (`en-GB`) | Turkish (`tr-TR`) |
| Turkmenistan | `tm` | English (U.K.) (`en-GB`) | — |
| Uganda | `ug` | English (U.K.) (`en-GB`) | — |
| Ukraine | `ua` | English (U.K.) (`en-GB`) | Russian (`ru-RU`), Ukrainian (`uk-UA`) |
| United Arab Emirates | `ae` | English (U.K.) (`en-GB`) | Arabic (`ar`) |
| United Kingdom | `gb` | English (U.K.) (`en-GB`) | — |
| United States | `us` | English (US) (`en-US`) | Arabic (`ar`), Chinese (Simplified) (`zh-Hans`), Chinese (Traditional) (`zh-Hant`), French (`fr-FR`), Korean (`ko-KR`), Portuguese (Brazil) (`pt-BR`), Russian (`ru-RU`), Spanish (Mexico) (`es-MX`), Vietnamese (`vi-VN`) |
| Uruguay | `uy` | English (U.K.) (`en-GB`) | Spanish (Mexico) (`es-MX`) |
| Uzbekistan | `uz` | English (U.K.) (`en-GB`) | — |
| Vanuatu | `vu` | English (U.K.) (`en-GB`) | French (`fr-FR`) |
| Venezuela | `ve` | Spanish (Mexico) (`es-MX`) | English (U.K.) (`en-GB`) |
| Vietnam | `vn` | English (U.K.) (`en-GB`) | Vietnamese (`vi-VN`) |
| Yemen | `ye` | English (U.K.) (`en-GB`) | Arabic (`ar`) |
| Zambia | `zm` | English (U.K.) (`en-GB`) | — |
| Zimbabwe | `zw` | English (U.K.) (`en-GB`) | — |

#### Google Play: languages

Google Play accepts any of these languages in any country:

Afrikaans (`af`) · Albanian (`sq`) · Amharic (`am`) · Arabic (`ar`) · Armenian (`hy`) · Azerbaijani (`az`) · Bangla (`bn`) · Basque (`eu`) · Belarusian (`be`) · Bulgarian (`bg`) · Burmese (`my`) · Catalan (`ca-ES`) · Chinese (Simplified) (`zh-Hans`) · Chinese (Traditional) (`zh-Hant`) · Croatian (`hr-HR`) · Czech (`cs-CZ`) · Danish (`da-DK`) · Dutch (`nl-NL`) · English (Australia) (`en-AU`) · English (Canada) (`en-CA`) · English (India) (`en-IN`) · English (U.K.) (`en-GB`) · English (US) (`en-US`) · Estonian (`et`) · Filipino (`fil`) · Finnish (`fi-FI`) · French (`fr-FR`) · French (Canada) (`fr-CA`) · Galician (`gl`) · Georgian (`ka`) · German (`de-DE`) · Greek (`el-GR`) · Gujarati (`gu`) · Hebrew (`he-IL`) · Hindi (`hi-IN`) · Hungarian (`hu-HU`) · Icelandic (`is`) · Indonesian (`id-ID`) · Italian (`it-IT`) · Japanese (`ja-JP`) · Kannada (`kn`) · Kazakh (`kk`) · Khmer (`km`) · Korean (`ko-KR`) · Kyrgyz (`ky`) · Lao (`lo`) · Latvian (`lv`) · Lithuanian (`lt`) · Macedonian (`mk`) · Malay (`ms-MY`) · Malayalam (`ml`) · Marathi (`mr`) · Mongolian (`mn`) · Nepali (`ne`) · Norwegian (`nb-NO`) · Persian (`fa`) · Polish (`pl-PL`) · Portuguese (Brazil) (`pt-BR`) · Portuguese (Portugal) (`pt-PT`) · Punjabi (`pa`) · Romanian (`ro-RO`) · Russian (`ru-RU`) · Serbian (`sr`) · Sinhala (`si`) · Slovak (`sk-SK`) · Slovenian (`sl-SI`) · Spanish (Mexico) (`es-MX`) · Spanish (Spain) (`es-ES`) · Spanish (US) (`es-US`) · Swahili (`sw`) · Swedish (`sv-SE`) · Tamil (`ta-IN`) · Telugu (`te`) · Thai (`th-TH`) · Turkish (`tr-TR`) · Ukrainian (`uk-UA`) · Urdu (`ur-PK`) · Uzbek (`uz`) · Vietnamese (`vi-VN`) · Zulu (`zu`)

### Is it legal?

This Actor only reads public search results that any store visitor can see, without logging in, at a gentle pace. Check the terms that apply to your use of the data, and consult a lawyer if unsure. Read more in Apify's blog post on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

### Feedback

Need a country, a language or a field that isn't here? Open an issue in the **Issues** tab — they are answered quickly.

# Actor input Schema

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

Search terms to check, exactly as a user would type them in the store.

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

Store countries to search in. Each keyword is searched once per country and store.

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

Store language to search in. Rankings change with the language. Leave the default to use each country's main language. The App Store only offers some languages per country (see the table in the README); a combination it does not offer is reported and not charged.

## `stores` (type: `array`):

Which stores to search.

## `apps` (type: `array`):

Apps whose position you want for each keyword: App Store ids or links (<code>570060128</code>, <code>https://apps.apple.com/us/app/duolingo-language-lessons/id570060128</code>) and Google Play package names or links (<code>com.duolingo</code>). Leave empty to only get the top apps.

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

How many of the top-ranked apps to include in each result, with name, developer and rating. 0 returns only the positions of your apps.

## `historyDatasetName` (type: `string`):

For daily tracking: every run also appends its results to this named dataset in your account, so all days stay together for charts. Letters, digits and dashes. Use a new name: Apify only lets the Actor write to a named dataset that it created itself.

## Actor input object example

```json
{
  "keywords": [
    "habit tracker",
    "meditation"
  ],
  "countries": [
    "us"
  ],
  "language": "",
  "stores": [
    "appStore",
    "googlePlay"
  ],
  "apps": [
    "https://apps.apple.com/us/app/habit-tracker/id1438388363",
    "com.habitnow"
  ],
  "topResults": 10
}
```

# Actor output Schema

## `rankings` (type: `string`):

No description

## `summary` (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",
        "meditation"
    ],
    "countries": [
        "us"
    ],
    "apps": [
        "https://apps.apple.com/us/app/habit-tracker/id1438388363",
        "com.habitnow"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("steadyscrape/app-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 = {
    "keywords": [
        "habit tracker",
        "meditation",
    ],
    "countries": ["us"],
    "apps": [
        "https://apps.apple.com/us/app/habit-tracker/id1438388363",
        "com.habitnow",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("steadyscrape/app-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 '{
  "keywords": [
    "habit tracker",
    "meditation"
  ],
  "countries": [
    "us"
  ],
  "apps": [
    "https://apps.apple.com/us/app/habit-tracker/id1438388363",
    "com.habitnow"
  ]
}' |
apify call steadyscrape/app-keyword-rank-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,steadyscrape/app-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/yHaO6srgbFxahKfTz/builds/hBNwC0yHZG8FTfC5O/openapi.json