Rank Sonar
All docs

Integrations

Integration: App Store Connect

Connect your Apple developer account to unlock own-app downloads, revenue, and conversion data.

Connecting App Store Connect lets Rank Sonar read your private analytics for apps you own — downloads, revenue, conversion rate, install retention. This is data we cannot scrape; it's only available via Apple's official API.

What you'll get after connecting

  • Daily downloads widget on the app overview
  • Daily revenue with currency breakdown
  • Conversion rate from impression to install
  • Crash rate trend
  • Source-of-install breakdown (App Store search, browse, web referral, app referral)

These supplement the public data we scrape (rank, ratings, reviews, metadata) and are limited to your owned apps.

Prerequisites

You need:

  1. An App Store Connect account with Admin or Account Holder role
  2. Permission to create API keys (typically the Account Holder)

Step-by-step

1. Generate an API key in App Store Connect

  1. Sign in to App Store Connect
  2. Go to Users and Access → Integrations → App Store Connect API
  3. Click Generate API Key
  4. Give it a name like "Rank Sonar"
  5. Set access to App Manager (read-only is sufficient)
  6. Click Generate
  7. Download the .p8 private key file (you can only download once)
  8. Note the Issuer ID (top of the page) and Key ID (next to the new key)

2. Upload to Rank Sonar

  1. In Rank Sonar, go to Integrations → App Store Connect
  2. Paste the Issuer ID and Key ID
  3. Upload the .p8 file
  4. Click Connect

We encrypt the key at rest using AES-256-GCM. The issuer ID and key ID are stored alongside the encrypted key.

3. Map apps

After connecting, we'll list all apps available in your App Store Connect account. Select which Rank Sonar apps to map to which App Store Connect apps. Multiple Rank Sonar apps can map to the same App Store Connect app (useful if you track variants).

4. Wait for the first sync

Within ~2 hours, App Store Connect data appears in your app overview widgets. Daily syncs run at 09:00 UTC (after Apple's reporting window closes for the previous day).

What we read

  • /v1/apps — list of apps in your account
  • /v1/salesReports — daily downloads + revenue per app per country
  • /v1/financeReports — monthly revenue summaries
  • /v1/apps/{id}/appAnalytics — conversion rate, source attribution, crash data

We do not modify your App Store Connect data. We do not submit metadata changes on your behalf.

Disconnecting

Visit Integrations → App Store Connect → Disconnect. We delete the encrypted key immediately. Historical data already synced remains in your workspace; future syncs stop.

Troubleshooting

"Invalid signature" errors — Usually means the .p8 file was corrupted in transit. Re-download from App Store Connect and re-upload.

"App not found in account" — Check that the API key has access to the relevant apps. App Manager role applies to all apps; finer-grained roles may exclude some.

"Reports show no data" — Apple takes 24-48 hours to publish sales reports for a given day. New apps with under 5 daily downloads may not appear in reports at all (Apple suppresses small numbers for privacy).

See also