Quickstart
Connect your account, create an App profile and generate your first store assets. The examples below show how to authenticate and choose a screenshot size and design.
Using an AI coding assistant? Copy a ready-to-use task prompt and provide your store URL, source folder and desired outputs. The agent can use the same API workflow below.
1. Get an API key
Sign in to the Studio and open API keys. Create a key and copy the secret. It starts with mm_live_ and is shown only once.
export APP_LISTING_LAB_API_KEY="mm_live_…"2. Create an App profile
Reuse an existing appId when continuing a project — GET /developer/apps lists your App profiles, and every create makes another one. For a new project, send your app’s name and description. Your app does not need to be published. For an app already in a store you can add iosUrl or androidUrl to pull in its listing; what you send always takes priority. Save the returned appId for later requests.
curl -s https://api.applistinglab.com/api/v1/developer/apps \
-H "Authorization: Bearer $APP_LISTING_LAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Your App","description":"What your app does and who it is for.","category":"Productivity"}'3. Discover devices and designs
Read actual IDs, dimensions and current design revisions before composing a render. Let the server recommend a compatible design, or pin the designId/designVersion returned by discovery.
curl -s "https://api.applistinglab.com/api/v1/developer/screenshots/devices" \
-H "Authorization: Bearer $APP_LISTING_LAB_API_KEY"
curl -s "https://api.applistinglab.com/api/v1/developer/screenshots/designs" \
-H "Authorization: Bearer $APP_LISTING_LAB_API_KEY"4. Render and verify
Follow Screenshot generation for caption input, optional compatibility preparation, a persisted idempotency key, asynchronous job polling and authenticated PNG downloads. Check the sources and exact frame order with the source guide. A complete API task returns the files, their actual dimensions and the original request/job IDs.