App Store Keyword Ranking Scraper

---

🎯 What this scrapes

Apple's public itunes.apple.com/search endpoint returns app metadata for any query, but it never tells you where an app actually ranks. This Actor takes your ASO keywords, fans them across every App Store storefront and device type you care about, and writes one row per app with its exact rank position, rating, price, and metadata. No reviews, no review-scraping duplication of the crowded cluster ahead of us — just accurate keyword-rank snapshots for competitive ASO intel.

🔥 What we handle for you

• 🛡️ Browser fingerprint rotation — curl-cffi impersonates real Chrome / Firefox / Safari TLS handshakes so the target sees a browser, not Python.
• 🌐 Apify Proxy + session rotation — one impersonation session per browser profile, round-robined, so consecutive requests don't share a fingerprint. Apple's endpoint is public, so this is about pacing and resilience, not evading a wall.
• 🔁 Retries with exponential backoff on 403 / 408 / 429 / 503 and network errors — up to 5 attempts, and we honour Retry-After when Apple sends one.
• 🧱 Rate-limit-aware pacing — when the target pushes back, we slow down instead of getting banned.
• 🧊 Clean, typed dataset rows — Pydantic-validated, ISO-8601 timestamps, stable IDs, JSON / CSV / Excel export straight from the Apify Console.
• 💰 Pay-Per-Event pricing — you only pay for results that hit your dataset. No data, no charge.

💡 Use cases

• ASO rank tracking — snapshot where your app ranks for the keywords that actually drive installs.
• Competitive intel — watch a rival's rank across the exact same keyword set, run over run.
• Storefront comparison — the same keyword often ranks differently in the US vs. Germany vs. Japan; find the gap.
• Keyword research — pull full metadata (price, rating, genre) for every top-ranked app on a candidate keyword before committing ASO budget.

⚙️ How to use it

1. Click Try for free at the top of the page.
2. Fill in the input form — most fields have sensible defaults.
3. Click Start. Output streams into the run's dataset.
4. Export from Storage → Dataset as JSON, CSV, or Excel — or fetch via the API.

📥 Input

Field	Type	Required	Default	Notes
keywords	array	yes	['crm']	ASO search terms to rank-track. The Actor fans each keyword across every country in countries.
countries	array	no	['us']	2-letter lowercase App Store storefronts to check per keyword (e.g. us, gb, de).
entity	string	no	'software'	Apple App Store entity type to search within.
limit	integer	no	50	Apps fetched per keyword x country pair. Apple caps effective results at 200.
lang	string	no	''	Optional Apple locale hint, e.g. en_us. Leave blank to use Apple's default per storefront.
maxRankToKeep	integer	no	50	Only emit rows for apps ranked at or above this position. Keeps the dataset lean for deep lookups.
proxyConfiguration	object	no	{'useApifyProxy': True}	Apify Proxy configuration (fleet standard). The iTunes Search API is public and keyless; proxy is wired for consistency…

Example input

{
  "keywords": [
    "crm"
  ],
  "countries": [
    "us"
  ],
  "entity": "software",
  "limit": 5,
  "maxRankToKeep": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

📤 Output

Every row is one dataset item.

Field	Type	Notes
keyword	string	Input search term (term) that produced this row.
country	string	Input App Store storefront (2-letter lowercase) that produced this row.
entity	string	Input Apple entity type searched (software / iPadSoftware / macSoftware).
rank	integer	1-based rank position of this app within the search results for its (keyword, country, entity) triple.
trackId	integer	Apple's numeric app identifier.
trackName	string	App display name.
bundleId	string	App bundle identifier (e.g. com.hubspot.crmapp).
sellerName	string	Publisher / developer legal name.
primaryGenreName	string	Primary App Store category.
genres	array	All App Store categories/genres for this app.
price	number	Numeric price in the storefront's local currency.
formattedPrice	string	Human-formatted price string (e.g. 'Free', '$4.99').
averageUserRating	number	Average App Store user rating (0-5).
userRatingCount	integer	Total number of ratings behind averageUserRating.
currentVersionReleaseDate	string	ISO-8601 release date of the current version.
version	string	Current app version string.
contentAdvisoryRating	string	Age/content rating (e.g. '4+').
artworkUrl512	string	512px app icon artwork URL.
trackViewUrl	string	Public App Store listing URL for this app.
description	string	App Store listing description text.
releaseNotes	string	'What's new' text for the current version.
scrapedAt	string	ISO-8601 UTC timestamp of the request that produced this row.

Example output

{
  "keyword": "crm",
  "country": "us",
  "entity": "software",
  "rank": 1,
  "trackId": 883898067,
  "trackName": "HubSpot: CRM & Sales, Marketing",
  "bundleId": "com.hubspot.crmapp",
  "sellerName": "HubSpot, Inc.",
  "primaryGenreName": "Business",
  "genres": [
    "Business",
    "Productivity"
  ],
  "price": 0.0,
  "formattedPrice": "Free",
  "averageUserRating": 4.7,
  "userRatingCount": 12345,
  "currentVersionReleaseDate": "2026-08-15T00:00:00Z",
  "version": "12.3.0",
  "contentAdvisoryRating": "4+",
  "artworkUrl512": "https://is1-ssl.mzstatic.com/image/thumb/example.png",
  "trackViewUrl": "https://apps.apple.com/us/app/hubspot/id883898067",
  "description": "HubSpot CRM keeps all your...",
  "releaseNotes": "Bug fixes and performance improvements.",
  "scrapedAt": "2026-09-01T12:00:00Z"
}

💰 Pricing

Pay-Per-Event — you pay only when these events fire:

Event	USD	What it is
actor-start	$0.05	One-off warm-up charge per run
app-ranked	$0.003	PPE event

Example: 1 000 results at the rates above ≈ $3.05. No subscription, no minimum, no card to start — Apify gives every new account $5 of free credit.

🚧 Limitations

This Actor reports Apple's iTunes Search API result order as rank — it does not reverse-engineer Apple's live ranking algorithm or explain why a rank changed. It is a single-run snapshot: schedule repeat runs yourself for historical trend tracking. Apple App Store only — no Google Play. No review content.

❓ FAQ

Does this scrape App Store reviews?

No. This Actor is rank-only — trackName, rank, price, rating metadata. Review text and review-level data are explicitly out of scope; see the review-scraper cluster on the Store for that.

Does rank match what I see in the App Store app?

It reflects Apple's own iTunes Search API result order, which is the same ordering signal every established ASO tool relies on. It is not guaranteed to be pixel-identical to the on-device App Store app's personalized results.

Do I need my own Apple Developer account or API key?

No. The iTunes Search API is public and keyless.

What happens when a keyword has zero matches?

The run still succeeds — you just get zero rows for that keyword/country pair, with the status message reporting it as an empty (not failed) pair.

💬 Your feedback

Spotted a bug, hit a weird edge case, or need a new field? Open an issue on the Actor's Issues tab on Apify Console — we ship fixes weekly and we read every report.

---