IAP Media Tools

Upload review screenshots and promotional images for in-app purchases and subscriptions using AI assistants like Claude.

Overview

These tools allow you to manage media assets for your in-app purchases and subscriptions:

ToolDescription
get_iap_screenshotGet the current review screenshot for an IAP
upload_iap_screenshotUpload a review screenshot for an IAP
delete_iap_screenshotDelete the review screenshot for an IAP
get_iap_promotional_imageGet the current promotional image for an IAP
upload_iap_promotional_imageUpload a promotional image for an IAP
delete_iap_promotional_imageDelete the promotional image for an IAP
get_subscription_screenshotGet the current review screenshot for a subscription
upload_subscription_screenshotUpload a review screenshot for a subscription
delete_subscription_screenshotDelete the review screenshot for a subscription
get_subscription_promotional_imageGet the current promotional image for a subscription
upload_subscription_promotional_imageUpload a promotional image for a subscription
delete_subscription_promotional_imageDelete the promotional image for a subscription

upload_iap_screenshot / upload_subscription_screenshot

Upload a review screenshot for an in-app purchase or subscription. The screenshot is displayed to App Store reviewers during the review process.

Parameters

ParameterTypeRequiredDescription
projectIdstringYesThe project ID
iapId / subscriptionIdstringYesThe IAP or subscription ID
fileNamestringYesFile name (e.g., "screenshot.png")
imageDatastringYesBase64 encoded image data (without data URL prefix)
mimeTypestringNoImage MIME type (default: image/png)

Response

{
"success": true,
"screenshot": {
"fileName": "screenshot.png",
"mimeType": "image/png",
"fileSize": 245678,
"r2Url": "https://cdn.appstorecopilot.com/iap-media/..."
}
}

upload_iap_promotional_image / upload_subscription_promotional_image

Upload a promotional image for an in-app purchase or subscription. Promotional images are used in App Store promotional campaigns and featured placements.

Parameters

Same parameters as screenshot upload tools.

Response

{
"success": true,
"image": {
"fileName": "promo.png",
"mimeType": "image/png",
"fileSize": 512000,
"r2Url": "https://cdn.appstorecopilot.com/iap-media/..."
}
}

Image Specifications

TypeSizeFormatPurpose
Review Screenshot640 x 920 pxPNG, JPEGShown to App Store reviewers
Promotional Image1024 x 1024 pxPNG, JPEGFeatured in App Store promotions

Example Usage

Ask Claude to upload media for your IAP or subscription:

Natural Language Promptstext
"Upload a review screenshot for my premium subscription"
"Add a promotional image to the 100 coins IAP"
"Get the current screenshot for subscription sub_abc123"
"Delete the promotional image from the pro_monthly subscription"

Get & Delete Tools

The get and delete tools take only projectId and iapId or subscriptionId parameters.

Get Response

{
"success": true,
"screenshot": {
"fileName": "screenshot.png",
"mimeType": "image/png",
"fileSize": 245678,
"r2Url": "https://cdn.appstorecopilot.com/iap-media/...",
"uploadedAt": "2024-01-15T10:30:00Z"
}
}
// If no screenshot exists:
{
"success": true,
"screenshot": null
}

Delete Response

{
"success": true
}