API reference · Apps

An app’s ads, as held

The app’s own ads Appleak already holds, longest-running first: the hook, format, offer and call to action, days live with its 30, 60 or 90 day rung, variants, and whether it was found again on the latest read. Free; to read the ads fresh, run an ad search.

GET/api/v1/apps/{store}/{appId}/ads

Costs: Free
MCP tool: browse_ads
Answers: At once (200)

curl "https://appleak.app/api/v1/apps/apple/1234567890/ads?minDays=30" \
  -H "Authorization: Bearer $APPLEAK_KEY"

Response200 OK

{
  "app": {
    "store": "apple",
    "appId": "1234567890",
    "title": "Example Meditation"
  },
  "readAt": "2026-10-27T06:00:00.000Z",
  "ads": [
    {
      "network": "meta",
      "hook": "I tried every sleep app. This is the one that worked.",
      "format": "ugc",
      "offer": "7-day free trial",
      "cta": "Install now",
      "daysLive": 96,
      "rung": "90+",
      "variants": 4,
      "status": "running",
      "firstSeen": "2026-07-24"
    }
  ]
}

#Parameters

Path parameters

store"apple" | "play"required
apple (App Store) or play (Google Play).
appIdstringrequired
The store id: digits for the App Store (e.g. 1234567890), the bundle id for Google Play (e.g. com.example.app). 1–200 characters

Query parameters

minDaysintegeroptionaldefault 0
Only ads running at least this many days, e.g. 30, 60 or 90. 0–365
limitintegeroptionaldefault 30
1–60

#Returns

The answer as JSON, beside. Free, and does not count against your credits.

MCP: browse_ads · Read the ads Appleak holds for one app (Meta and TikTok), longest-running first: hook, format, offer, call to action, days live with the 30/60/90 rung, variants, and running or no longer found. Free; nothing is read fresh.