Before you start
Account Holder or Admin access to your Apple Developer team, to create a Team API key with Admin access. One key covers every app on the account.
App Manager is enough to read reviews and edit metadata. Review replies and analytics reports need Admin.
Set it up
- Open App Store Connect → Users and Access → Integrations → App Store Connect API → Team Keys.
- Click Generate API Key, or + beside Active.
- Name it
Sprid, choose Admin, then Generate. - Click Download API Key and keep the
.p8file. Apple offers the download once; if you lose it, revoke the key and make another. - Copy the Key ID from its row and the Issuer ID above the table.
Find the app's numeric id
Apps → your app → General → App Information → General Information → Apple ID. If your Sprid app profile lacks it, run sprid init.
Connect to Sprid
sprid connect asc --key ~/Downloads/AuthKey_XXXXXXXXXX.p8 --key-id XXXXXXXXXX --issuer YYYYYYYY-YYYY-YYYY-YYYY-YYYYYYYYYYYYUse your own file path and ids. Keep the key file out of chat.
Check the connection
Run sprid status, then ask your agent: “Check that Sprid can read this app’s App Store reviews and analytics. Tell me if any reports are still missing.” A saved key alone does not confirm access. The daily review email only arrives when there are new reviews.
If something goes wrong
- Key not accepted: check the Key ID matches the downloaded file and the Issuer ID came from above the keys table. A Team ID will not work.
- Permission denied: create a replacement key with Admin access. A key’s role cannot be changed.
- Older analytics are missing: Apple starts preparing reports after setup. Missing history does not mean downloads fell to zero.
Investigate with this connection
Reads reviews, versions, reports and report_rows for the pinned app. Read-only: no report request is created.
sprid marketing-review capabilities --app <slug> --source asc --jsonSee connected queries.
Sources and verification
Prefer your terminal? sprid docs app-store-connect reads this same guide.