ASO Keyword Rankings API - App Store Keyword Data

Everything app store optimization runs on, as rows: what a keyword is worth, how hard it is, who ranks for it today, and what the store actually returns when somebody types it.

What it does

• Keyword metrics that mean something. Search volume, maximum volume, difficulty, maximum reach, total results and whether the term is a brand, per country and per device.
• Live store search results. The organic App Store or Google Play result for a keyword, as one row per app in rank order, read at the moment you run it.
• Keyword rankings for your apps. Where each app ranks on the keywords it is tracked for, with the volume and difficulty of each keyword on the same row.
• Keyword suggestions. The keywords the provider recommends for an app, with volume and difficulty attached, so a shortlist is a filter rather than a brainstorm.
• Top charts. Top free, top paid or top grossing for any store category, up to 500 apps, as ranked rows.
• Full store listings. Title, subtitle, description, developer, categories, price, size, release date, current version, release notes, screenshots, rating, and the provider's app and game DNA classification.
• Reviews with ratings. Store reviews over a date range, with rating, title, body, author and app version.
• Never spends your credits behind your back. Downloads and revenues cost 500 provider credits per app against 10 for ratings and app power, so metrics are an explicit choice. Leave the field empty and a metrics run reads only the cheap ones.
• Reports what each run cost. The provider returns the credit cost of every request; the run totals it and puts it in the final status message.
• Batches to the provider's ceiling. Five app identifiers per request is the provider's limit, so longer lists are split for you and spend as few requests as possible.
• Keeps the misses. An app or keyword the provider has no data for still produces a row saying so, and it is not charged for.

Input

What is a keyword worth?

{
  "mode": "keywordMetrics",
  "keywords": ["meditation", "sleep sounds", "breathing exercises"],
  "country": "us",
  "device": "iphone"
}

Who ranks for a keyword right now?

{
  "mode": "keywordSearch",
  "keywords": ["meditation"],
  "country": "us",
  "device": "android",
  "maxResults": 100
}

Where do my apps rank?

{
  "mode": "keywordRankings",
  "apps": ["284882215", "com.calm.android"],
  "country": "us",
  "device": "iphone",
  "maxResults": 500
}

The top free chart for a category

{
  "mode": "topCharts",
  "category": "6005",
  "chartType": "free",
  "country": "us",
  "device": "iphone",
  "maxResults": 500
}

Downloads and revenue history, deliberately

{
  "mode": "metrics",
  "apps": ["284882215"],
  "metrics": ["downloads", "revenues"],
  "history": true,
  "startDate": "2026-08-01",
  "endDate": "2026-08-31"
}

Example output

A keyword row and a live search row.

{
  "recordType": "keyword",
  "keyword": "meditation",
  "country": "us",
  "device": "iphone",
  "date": "2026-09-02",
  "volume": 62,
  "maxVolume": 100,
  "difficulty": 48,
  "maxReach": 91,
  "totalResults": 1840,
  "isBrand": false,
  "found": true
}

{
  "recordType": "searchResult",
  "appId": "571800810",
  "keyword": "meditation",
  "country": "us",
  "device": "iphone",
  "rank": 1,
  "found": true
}

Bring your own key

This actor calls an app store optimization API with your own account's API token, copied from the API dashboard in your provider account. Paste it into the API key field, or set it as the DATA_API_KEY environment secret. It is never written to the dataset or the log.

Without a token the run ends cleanly and tells you what to add, rather than failing.

Pricing

Pay per result, platform usage included.

Event	Price
App listing returned	$0.01
Keyword or ranking row returned	$0.006
Review returned	$0.004

Rows for apps and keywords the provider has no data for, and requests it refused, are never charged.

FAQ

What is an ASO API?

An app store optimization API returns the data behind app store search: how much a keyword is searched, how hard it is to rank for, which apps currently rank for it, and how a given app's listing and rankings are changing. It is the App Store and Google Play equivalent of a keyword research tool for web SEO.

What keyword metrics does it return?

Search volume, maximum volume, difficulty, maximum reach, total results in the store for that term, and whether the term is a brand. All of them are per country and per device, because store search is per country.

Can I see the live App Store search results for a keyword?

Yes. Use mode: "keywordSearch" with one or more keywords. Each run reads the store's organic result at that moment and returns one row per app in rank order.

Does it work for Google Play as well as the App Store?

Yes. Set device to android for Google Play, or iphone or ipad for the App Store. Store categories differ between the two: the App Store uses numbers such as 6005, Google Play uses names such as GAME_ACTION.

How many countries are covered?

The provider covers over 100 countries and more than five million apps. Set the two-letter country code in the country field; the data returned is that country's store, not a filtered view of a global one.

Why are downloads and revenue not included by default?

Because they are expensive. On this provider's credit model, downloads and revenues cost 500 credits per app, while ratings, daily ratings and app power cost 10. Nothing costly is added to a request on your behalf, so a metrics run with the field left empty reads only the cheap metrics.

How do I get keyword suggestions for my app?

Use mode: "suggestions" with your app identifiers. Each suggested keyword comes back with its volume and difficulty, so you can sort a shortlist instead of guessing.

What app identifiers does it take?

An App Store numeric id, a Google Play package name, or a store listing URL containing either. URLs are parsed for you. Five apps go into each provider request, and longer lists are batched automatically.

Do I need my own API key?

Yes. This actor is bring-your-own-key: it calls the provider with your account's token, so you keep your own plan, credit balance and terms. There is no shared or bundled key.

How is the price calculated?

Per row stored. App listings are $0.01, keyword and ranking rows are $0.006 and reviews are $0.004. Rows saying something was not found cost nothing.

Keyword map

ASO API, app store optimization API, app keyword ranking API, keyword volume difficulty API, app store keyword research, google play keyword API, app store search results API, top charts API, keyword suggestions API, app store listing API, app reviews API, mobile app SEO, app store rank tracking, ASO keyword tool API