📑 ASO Audit Report — App Store Listing Health & Keyword Coverage

Mobile growth / ASO agencies auditing a client app's store listing before a keyword or creative push, and PMs benchmarking their listing against category peers.

## Source
    Apple iTunes Search & Lookup APIs (public, logged-out)
    - https://itunes.apple.com/lookup

• https://itunes.apple.com/search

  Public, logged-out only — no API key, login, cookie or CAPTCHA.
  
    ## Pricing
    | Event | Price (FREE tier) |
    |---|---|
    | Actor start (`apify-actor-start`) | $0.05 one-time |
    | Report delivered (`aso-audit-report`) — **primary** | $25.00 |
  
    Four-tier ladder, GOLD-floored: **$25.00 FREE / $22.50 Bronze / $20.00 Silver / $16.75 Gold and above.**
    Charge-on-delivery only: a blocked source, an invalid input or an empty
    window builds no report and charges nothing beyond the start event.
  
    ## Terminal states
    `NORMAL` · `SUCCEEDED-0: GENUINE_EMPTY` · `PARTIAL` · `BLOCKED`.
    A zero with no evidence FAILS loud rather than exiting 0 quietly.
  
    ## Honest limits
    See the `limits` block emitted with every report; scope is stated in-record.
    Deterministic aggregation (`ngd-deterministic-aggregate-v1`) — no LLM, no
    randomness, so identical inputs produce an identical `report_id`.
  

Output is one report row per result; billing is pay-per-event, the value event being one aso audit report (a $0.05 start fee per run, then $25.00 per aso audit report). Source: itunes.apple.com.

📊 Sample Output

Real rows from run U09ERK17hTN6U4WHN on build 0.1.21 (2026-09-17), the same input as the Quick start below — every value is as the source published it (emails masked, long text shortened):

report_id	report_title	scope	sources	method	generated_at
6027c26d95091701222a	ASO Audit — Insight Timer: Meditate, Sleep (US)	app 337472899 on the US storefront; 2 keyword(s) audited	["Apple iTunes Lookup API", "Apple iTunes Search API"]	ngd-deterministic-aggregate-v1	2026-09-17T17:02:31.373037+00:00

The run finished with the status message: NORMAL: emitted 1 item(s)

✅ What you get

Each row is flat JSON with these fields (from the dataset schema and the sample run; a field the source does not publish for a given row is null):

• record_type (string) — e.g. report
• report_id (string) — e.g. 6027c26d95091701222a
• report_title (string/null) — e.g. ASO Audit — Insight Timer: Meditate, Sleep (US)
• scope — e.g. app 337472899 on the US storefront; 2 keyword(s) audited
• sources (array) — e.g. ["Apple iTunes Lookup API", "Apple iTunes Search API"]
• records_analysed (integer) — e.g. 3
• facets (object) — e.g. {"row_type": [{"value": "keyword_coverage", "count": 2}, {"value": "subject_app"
• numbers (object) — e.g. {"rating": {"count": 1, "sum": 4.9, "min": 4.89512, "max": 4.89512, "mean": 4.89
• method (string) — e.g. ngd-deterministic-aggregate-v1
• partial (boolean) — e.g. False
• report_markdown (string) — e.g. # ASO Audit — Insight Timer: Meditate, Sleep (US) - Records analysed: **3** - Wi
• generated_at (string) — e.g. 2026-09-17T17:02:31.373037+00:00
• report_kv_key — e.g. REPORT_6027c26d95091701222a

⚙️ Sample inputs

1. Quick start — the Store example (this is what the sample above came from)

{
  "app_id": "337472899",
  "country": "us",
  "keywords": [
    "meditation",
    "sleep"
  ],
  "max_keywords": 5
}

The sample run charged exactly: 1 × $0.05 apify-actor-start + 1 × $25.00 aso-audit-report = $25.05 on the Free tier — every delivered row was billed.

2. A smaller, narrowed run

{
  "app_id": "337472899",
  "country": "us",
  "keywords": [
    "meditation",
    "sleep"
  ],
  "max_keywords": 5
}

A bounded run for checking the field shape before scheduling. app_id narrows what the source is asked for.

3. A full-size run

{
  "app_id": "337472899",
  "country": "us",
  "keywords": [
    "meditation",
    "sleep"
  ],
  "max_keywords": 5
}

The same input run on a schedule; each run is billed only for what it delivers.

🧾 JSON sample record

One real record from run U09ERK17hTN6U4WHN, exactly as it lands in the dataset (emails masked, long text shortened):

{
  "record_type": "report",
  "schema_version": "1.0",
  "report_id": "6027c26d95091701222a",
  "report_title": "ASO Audit — Insight Timer: Meditate, Sleep (US)",
  "scope": "app 337472899 on the US storefront; 2 keyword(s) audited",
  "sources": [
    "Apple iTunes Lookup API",
    "Apple iTunes Search API"
  ],
  "records_analysed": 3,
  "facets": {
    "row_type": [
      {
        "value": "keyword_coverage",
        "count": 2
      },
      {
        "value": "subject_app",
        "count": 1
      }
    ],
    "primary_genre": [
      {
        "value": "unknown",
        "count": 2
      },
      {
        "value": "Health & Fitness",
        "count": 1
      }
    ],
    "ranked": [
      {
        "value": "True",
        "count": 2
      },
      {
        "value": "unknown",
        "count": 1
      }
    ]
  },
  "numbers": {
    "rating": {
      "count": 1,
      "sum": 4.9,
      "min": 4.89512,
      "max": 4.89512,
      "mean": 4.8951,
      "median": 4.89512
    },
    "rating_count": {
      "count": 1,
      "sum": 446428,
      "min": 446428,
      "max": 446428,
      "mean": 446428,
      "median": 446428
    },
    "subject_rank": {
      "count": 2,
      "sum": 12,
      "min": 1,
      "max": 11,
      "mean": 6,
      "median": 6
    },
    "result_count": {
      "count": 2,
      "sum": 91,
      "min": 43,
      "max": 48,
      "mean": 45.5,
      "median": 45.5
    },
    "title_length": {
      "count": 1,
      "sum": 30,
      "min": 30,
      "max": 30,
      "mean": 30,
      "median": 30
    },
    "screenshot_count": {
      "count": 1,
      "sum": 9,
      "min": 9,
      "max": 9,
      "mean": 9,
      "median": 9
    },
    "description_length": {
      "count": 1,
      "sum": 3919,
      "min": 3919,
      "max": 3919,
      "mean": 3919,
      "median": 3919
    }
  },
  "method": "ngd-deterministic-aggregate-v1",
  "partial": false,
  "report_markdown": "# ASO Audit — Insight Timer: Meditate, Sleep (US) - Records analysed: **3** - Window / scope: app 337472899 on the US storefront; 2 keyword(s) audited - Sources: Apple iTunes Lookup API, Apple iTunes Search API - Report id: `6027c26d9509170",
  "generated_at": "2026-09-17T17:02:31.373037+00:00",
  "report_kv_key": "REPORT_6027c26d95091701222a"
}

🔧 How it works

Source. The actor reads itunes.apple.com — endpoints: https://itunes.apple.com/lookup, https://itunes.apple.com/search. Public pages and feeds only; nothing behind a login.

Transport. Plain HTTPS from the Apify platform, no proxy. Every request carries an identified contact User-Agent.

Terminal states. A run ends NORMAL, CAPPED (your cap was reached), PARTIAL (something was withheld and the message says what), GENUINE_EMPTY (the source was read and truly had nothing in scope) or BLOCKED (the source refused or changed shape — the run FAILS loud and bills nothing). A zero-row run is never reported as a silent success.

Charging. Each aso audit report is charged at the moment it is pushed (aso-audit-report); a row that fails to charge is not delivered, so the dataset count always equals the charged count.

What is not done. No login, no cookie or CAPTCHA bypass, no private or personal-account data, no browser automation.

💰 Pricing example

Event	Free	Bronze	Silver	Gold
Actor Start (apify-actor-start)	$0.05	$0.05	$0.05	$0.05
Aso Audit Report (aso-audit-report)	$25.00	$22.50	$20.00	$16.75

Worked at the live Free-tier price:

• 1 aso audit reports: $0.05 start + 1 × $25.00 = $25.05
• 25 aso audit reports: $0.05 start + 25 × $25.00 = $625.05
• 100 aso audit reports: $0.05 start + 100 × $25.00 = $2,500.05

A run that delivers zero rows charges the $0.05 start fee only. A BLOCKED run (source refused) fails loud and charges no value event. The start fee is charged once per GB of run memory; the default run memory is 1024 MB.

Yield on the sample run: NORMAL: emitted 1 item(s).

⚖️ Legal & ToS

This actor reads public, logged-out pages and feeds published by itunes.apple.com. It collects only what the source publishes to any visitor, identifies itself with a contact User-Agent, and does not access accounts, private data or anything behind authentication. Use the output in line with the source's terms and your local law; the intended use is B2B research and monitoring.

❓ FAQ

Q: Do I need an API key or a login?
A: No. The source (itunes.apple.com) is read logged-out; the input schema has no key field and the actor carries no secrets.

Q: Why did my run return 0 rows?
A: Read the run's status message. GENUINE_EMPTY means the source was read and had nothing in scope for your input; BLOCKED means the source refused and the run failed without billing a value event — retry later or narrow the input. A zero-row run bills the start fee only.

Q: How fresh is the data?
A: Every run reads the source live at run time; nothing is cached between runs. Put it on a schedule for a continuous feed.

Q: What formats can I export?
A: The dataset downloads as JSON, CSV, Excel, XML or RSS from the run's Dataset tab or the Apify API, and any run can push to a webhook or integration.

Q: How is this different from the other premium report actors actors?
A: Same output shape and billing model; this one covers itunes.apple.com. The siblings under Related Actors cover the other sources or slices — run several on one schedule for a combined feed.

Q: Are there rate limits?
A: The actor paces itself against the source; there is no per-buyer limit beyond your Apify plan's concurrency.

🆘 Troubleshooting

• Run FAILED with BLOCKED → the source refused the request or changed its page shape → nothing was billed beyond the start fee; retry after a while, and if it persists open an Issue with the run id.
• Fewer rows than expected → the source had fewer items in scope → widen the input.
• Input validation error on start → a field is outside the schema's allowed values → start from the Quick start block and change one field at a time.
• Run TIMED-OUT → a very wide request on a slow day → raise the run timeout in Run options or narrow the input; what was delivered before the timeout is still in the dataset.

🔗 Related Actors

• App Review Competitive Report — Head-to-Head Comparison — Stop paying $50–100+/month for a review-intelligence subscription to compare your app against the competition
• App Review Deep Report — Sentiment, Themes & Complaints — Stop paying $50–100+/month for a review-intelligence subscription you use a few times
• EDGAR Diligence Report — Per-Issuer SEC Filing Brief — Per-issuer SEC/EDGAR diligence in one run — material 8-K events, filing history, and risk factors as structured findings plus a rendered markdown bri…
• Grant Funding Report — NIH Awards & Grants.gov Window — Research-development offices and grant consultancies sizing a funder's activity in a topic area, and life-science BD teams tracking award concentrati…
• Tender Pipeline Report — UK & EU Procurement Window Analysis — Bid teams and procurement-intelligence vendors sizing a pipeline for a buyer or CPV category over a dated window, and consultancies producing client…
• 🏢 About NexGenData — NexGen Watch is NexGenData's fleet of 256 public monitoring and lookup actors built on official sources, pay-per-result. Browse the catalog at apify.com/nexgenwatch.

⭐ Found this useful?

If this actor saved you a manual check, a quick review on the Apify Store helps other teams find it. Feature request or a source that changed? Open it from the Issues tab — every one is read.