Let your AI generate
App Store screenshots

# App Store Screenshot Generator — AI Tool
# Paste this into your AI assistant (Claude, ChatGPT, Cursor, etc.)
# API Docs: https://appstorescreenshot.app/for-ai

You have access to the App Store Screenshot Generator API at https://appstorescreenshot.app/api/v1.
Use it to generate professional App Store screenshots and upload them to App Store Connect.

## Authentication
All /generate requests require: Authorization: Bearer <API_KEY>
The user must provide their API key. They can get one at https://appstorescreenshot.app/for-ai

## Available Endpoints

### 1. Search for a reference app
GET https://appstorescreenshot.app/api/v1/search?q=<app_name>
Returns: { results: [{ trackId, trackName, artworkUrl512, screenshotUrls, primaryGenreName }] }
No auth required.

### 2. Generate a screenshot
POST https://appstorescreenshot.app/api/v1/generate
Headers: Authorization: Bearer <API_KEY>, Content-Type: application/json
Body: {
  "referenceAppId": 123456789,       // iTunes trackId from search (optional)
  "referenceScreenshotUrl": "https://...", // OR a direct screenshot URL (optional)
  "userScreenshot": "<base64_png>",  // required: base64-encoded screenshot
  "headline": "Your Amazing App",    // required: marketing headline
  "subtitle": "Built for everyone",  // optional: subtitle text
  "gradientStart": "#5c6bc0",       // optional: hex color (auto-extracted if reference provided)
  "gradientEnd": "#1a1a2e"          // optional: hex color (auto-extracted if reference provided)
}
Returns: { image: "<base64_png>", width: 1290, height: 2796 }
Requires Pro plan.

## Recommended Workflow

1. Ask the user which app's style they want to match (or let them pick)
2. Search for that app: GET /api/v1/search?q=<name>
3. Get the user's app screenshots (they provide file paths or you take them)
4. For each screenshot, call POST /api/v1/generate with:
   - The reference app's trackId
   - The user's screenshot as base64
   - A compelling marketing headline
5. Save each generated image as a PNG file
6. Optionally upload to App Store Connect (see below)

## Uploading to App Store Connect

After generating screenshots, you can upload them to App Store Connect using Apple's API:

1. The user needs to provide their App Store Connect API key:
   - Issuer ID
   - Key ID
   - Private key (.p8 file path)

2. Create a JWT for authentication:
   Header: { "alg": "ES256", "kid": "<KEY_ID>", "typ": "JWT" }
   Payload: { "iss": "<ISSUER_ID>", "iat": <now>, "exp": <now+1200>, "aud": "appstoreconnect-v1" }
   Sign with the .p8 private key.

3. Find the app's App Store version:
   GET https://api.appstoreconnect.apple.com/v1/apps/<BUNDLE_ID_OR_APP_ID>/appStoreVersions?filter[appStoreState]=PREPARE_FOR_SUBMISSION

4. Get the version's localizations:
   GET https://api.appstoreconnect.apple.com/v1/appStoreVersions/<VERSION_ID>/appStoreVersionLocalizations

5. Get existing screenshot sets (or create new ones):
   GET https://api.appstoreconnect.apple.com/v1/appStoreVersionLocalizations/<LOCALIZATION_ID>/appScreenshotSets

   To create a new set:
   POST https://api.appstoreconnect.apple.com/v1/appScreenshotSets
   Body: { "data": { "type": "appScreenshotSets", "attributes": { "screenshotDisplayType": "APP_IPHONE_67" }, "relationships": { "appStoreVersionLocalization": { "data": { "type": "appStoreVersionLocalizations", "id": "<LOCALIZATION_ID>" }}}}}

6. Reserve a screenshot upload:
   POST https://api.appstoreconnect.apple.com/v1/appScreenshots
   Body: { "data": { "type": "appScreenshots", "attributes": { "fileName": "screenshot_1.png", "fileSize": <size_bytes> }, "relationships": { "appScreenshotSet": { "data": { "type": "appScreenshotSets", "id": "<SET_ID>" }}}}}

7. Upload the screenshot using the upload operations returned in step 6:
   The response includes uploadOperations with URLs, methods, headers, and byte ranges.
   PUT each chunk to the provided URL with the specified headers.

8. Commit the upload:
   PATCH https://api.appstoreconnect.apple.com/v1/appScreenshots/<SCREENSHOT_ID>
   Body: { "data": { "type": "appScreenshots", "id": "<SCREENSHOT_ID>", "attributes": { "uploaded": true, "sourceFileChecksum": "<MD5_OF_FILE>" }}}

All App Store Connect API requests need: Authorization: Bearer <JWT_TOKEN>

## Tips
- Generate 4-6 screenshots per app for best results
- Write headlines that highlight key features, not describe them
- Use the reference app search to match successful apps in your category
- The "APP_IPHONE_67" display type is for iPhone 15 Pro Max (6.7")