Getting started

Quickstart

Create a key, onboard an app from its store URL, and generate your first screenshot set — about a minute end to end.

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.

Keep it secret

Treat the key like a password. Use it only from a server or your terminal — never ship it in a web page, mobile app, or public repo.

Export it so the snippets below can pick it up:

shell

export APP_LISTING_LAB_API_KEY="mm_live_…"

2. Onboard an app

Send a store URL. The API reads the listing and returns an appId you'll generate against. You can pass iosUrl, androidUrl, or both.

cURL

curl -s https://api.applistinglab.com/api/v1/public/v1/apps \
  -H "Authorization: Bearer $APP_LISTING_LAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"iosUrl":"https://apps.apple.com/app/id1234567890"}'

The response gives you the id to generate against:

response

{
  "appId": "665f0a2b9c1e4d0012ab34cd",
  "name": "Your App",
  "category": "Productivity",
  "artworkUrl": "https://…/icon.png"
}

3. Generate a screenshot set

Ask for a set by appId, device, and count. Generation runs as a background job, so this returns a jobId immediately along with your credit usage.

cURL

curl -s https://api.applistinglab.com/api/v1/public/v1/screenshots \
  -H "Authorization: Bearer $APP_LISTING_LAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"appId":"665f0a2b9c1e4d0012ab34cd","device":"iphone-67","count":5}'

4. Poll the job

Poll /public/v1/jobs/{id} every couple of seconds until status is succeeded (or failed). The finished set arrives in result.

cURL

curl -s https://api.applistinglab.com/api/v1/public/v1/jobs/77a1b2c3 \
  -H "Authorization: Bearer $APP_LISTING_LAB_API_KEY"

That's the whole API

Three endpoints — onboard, generate, poll. Read the screenshots guide for narratives and caption styles, or the API reference for every field.