asopilot API

Create a free App Store audit for any app and get back the score, the first findings and a tracked report link. Use it from ad landing pages, Zapier, a CRM or a partner's site.

Authentication

Send your key as Authorization: Bearer aso_live_…. Ask us for a key. Every audit created with a key is credited to that key's ref unless you pass your own.

POST /api/v1/audits

Body fields: url (App Store link) or app_id, plus optional country, ref, utm_source, utm_campaign, fbclid. GET with the same query parameters also works.

curl -X POST https://asopilot.vercel.app/api/v1/audits \
  -H "Authorization: Bearer aso_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://apps.apple.com/us/app/id632064380",
       "ref": "meta", "utm_campaign": "q4-ios-founders"}'

{
  "app": { "id": "632064380", "name": "Vinted", "developer": "Vinted", "rating": 4.7, "rating_count": 391204 },
  "country": "us",
  "score": 78,
  "findings_total": 4,
  "findings": [ { "severity": "high", "area": "Localization", "title": "...", "detail": "..." } ],
  "localized_markets": 7, "checked_markets": 12,
  "report_url": "https://asopilot.vercel.app/audit/632064380?country=us&ref=meta&utm_campaign=q4-ios-founders",
  "ran_at": "2026-10-17T18:00:00.000Z"
}

Tracking and Meta ads

• Report links carry ref, utm_source, utm_campaign and fbclid. Views, unlock clicks and signups are recorded against them.
• With the Meta pixel connected, asopilot sends ViewContent when a report opens, Lead when someone clicks to unlock it, and CompleteRegistration on signup, both from the browser and the server (Conversions API), so Meta can optimize campaigns for real signups.
• For ads, point the ad at /audit?utm_source=meta. Meta adds fbclid on its own.

Limits

Reports are cached for 24 hours per app and country. Please keep to 60 requests a minute.