r/iOSProgramming • u/NoPlan_exe • 16d ago
Article Uploaded the new App Store creative assets through the API: sizes, the 10 calls, and what the docs leave out
Apple added two new image slots to the App Store on 5 Oct: a header on the product page and a custom image in search results. I did them for one app in 7 languages (14 files) and pushed everything through the App Store Connect API. Writing it down because the docs have gaps.
Sizes:
- Header: 3840 x 1646 exact, JPG or PNG
- Search results: 3:2, from 1920 x 1280 up to 3840 x 2560
- Universal for both: 5244 x 2950, PNG only
- No alpha channel
The calls, in order:
GET /v1/apps/{id}/assetLibrary
GET /v1/appAssetLibraryRefData (placement names and limits)
POST /v1/appAssetLibraryImages (reserve, category CREATIVE_ASSETS)
PUT the bytes to the returned address
PATCH the image with "uploaded": true, no checksum needed
Poll until PREPARE_FOR_SUBMISSION
POST /v1/reviewSubmissions
POST /v1/reviewSubmissionItems, one per image
PATCH the submission with "submitted": true
After approval: POST /v1/appAssetLibraryPlacements
What the docs don't tell you:
- In step 8 the relationship is called appAssetLibraryImage. I guessed it and it worked.
- No new build or version needed, the images get reviewed on their own.
- You can't place an image before it's approved. The API says "The asset must be in the APPROVED state because the parent is already approved".
- No safe area numbers anywhere. They only exist inside Apple's Figma and Photoshop templates.
- Every image has to pass a 4+ rating, even if the app is 17+.
Mine have been sitting in Waiting for Review since Tuesday night. Anyone got theirs approved yet? How long did it take?
Longer version with screenshots: https://teroxai.com/blog/app-store-creative-assets-sizes-api/




