Shopify App Store Review Intelligence API | Merchant Reviews, Pricing & Themes

Monitor one Shopify App Store listing with a structured row of ratings, pricing hints, AI summary text, and recurring merchant feedback themes. This actor is for app teams, partnerships, support, and growth operators who need a low-maintenance way to spot praise patterns, complaint clusters, and pricing or onboarding friction from public Shopify App Store pages without custom scraping.

Store Quickstart

• Start with store-input.example.json for the smallest useful dataset run.
• Check sample-output.example.json for a recent single-listing sample captured from the repo's live parser output.
• Check live-proof.example.json for the latest live canary + contract proof on the public actor surface.
• Then move through store-input.templates.json in this order:
  • Quickstart Baseline (Single App Listing) — smallest useful dataset run for one listing
  • Recurring Baseline (Multi-App Merchant Feedback Watch) — same schema tuned for repeat monitoring
  • Webhook Routed Alerts (Merchant Review Handoff) — route the same payload after the dataset baseline and destination schema are stable

What first success looks like

A good first run gives you:

1. apps[] — one merchant-review row with rating, pricing hints, AI summary text, and the recurring themes buyers care about first.
2. reviewSamples[] plus rollups — enough raw evidence and grouped complaints to validate whether onboarding, support, billing, or feature friction is real.
3. warnings and endpointStatuses — explicit source honesty when review pages are thin or a listing surface degrades.

What it does

For each app URL or slug you provide, the actor:

1. Fetches the public listing page at apps.shopify.com/{slug}.
2. Extracts structured metadata from JSON-LD and HTML (name, developer, description, icon, category).
3. Parses the rating summary — overall score, total review count, per-star distribution, and star counts.
4. Extracts pricing plan details — plan names, pricing hints, free-trial indicators, and feature-list snippets.
5. Collects the AI-generated review summary that Shopify surfaces on listing pages.
6. Samples individual reviews from listing and paginated review pages (stars, date, store name, location, usage duration, body text, developer replies).
7. Builds keyword-based rollups — top themes (support, ease of use, bugs, billing, onboarding, etc.) and feature-request excerpts.

If certain surfaces are unavailable (for example no reviews or changed HTML structure), the actor returns explicit warnings instead of failing silently.

Use Cases

Who	Why
Shopify app teams	Track merchant praise, complaints, and onboarding friction without manual review reading
Partnerships / GTM teams	Compare category rivals on pricing posture, review volume, and recurring merchant themes
Support / success teams	Pull fresh review evidence into churn-risk, escalation, or FAQ workflows
Product teams	Spot feature gaps, support pain points, and billing friction from public merchant feedback

Input

Field	Type	Default	Description
appUrls	string[]	required	Shopify App Store URLs or bare slugs
reviewLimit	integer	100	Max reviews to collect per app (1–500)
timeoutMs	integer	20000	HTTP timeout per request in ms
delivery	string	"dataset"	"dataset" or "webhook"
webhookUrl	string	—	Webhook URL when delivery=webhook
dryRun	boolean	false	Skip dataset/webhook writes

Input Example

{
  "appUrls": [
    "https://apps.shopify.com/omnisend",
    "klaviyo-email-marketing"
  ],
  "reviewLimit": 50,
  "delivery": "dataset",
  "dryRun": false
}

Output

{
  "meta": {
    "generatedAt": "2026-04-10T17:06:42.111Z",
    "implementationStatus": "live",
    "totalSources": 1,
    "totals": { "apps": 1, "ok": 1, "errors": 0, "warningCount": 0, "totalReviewsSampled": 10 },
    "notes": ["..."]
  },
  "apps": [
    {
      "slug": "omnisend",
      "url": "https://apps.shopify.com/omnisend",
      "status": "ok",
      "app": { "name": "...", "developer": "...", "description": "...", "icon": "...", "category": "..." },
      "rating": { "overall": 4.8, "totalReviews": 2939, "distribution": { "5": 90, "...": "..." }, "starCounts": { "5": 2632, "...": "..." } },
      "pricing": { "hasFreeOption": true, "hasFreeTrial": false, "pricingHint": "Free to install", "plans": ["..."] },
      "reviewSummary": "Merchants praise this app for ...",
      "reviewSamples": [{ "id": "2090002", "stars": 5, "date": "February 21, 2026", "storeName": "...", "body": "..." }],
      "rollups": { "themes": [{ "theme": "customer support", "count": 5 }], "featureRequests": ["..."] },
      "warnings": [],
      "endpointStatuses": { "listing": "ok", "reviews": "ok" },
      "error": null
    }
  ]
}

Proof buyers can inspect

Buyer question	Proof asset	What it proves
"Will one listing already show a usable merchant-feedback story?"	store-input.example.json + sample-output.example.json	The quickstart returns rating, pricing hints, Shopify's AI summary text, sampled reviews, and grouped merchant themes from one listing.
"Is the public actor still working live on Apify?"	live-proof.example.json	The latest canary + contract proof passed on the public actor surface.
"How do I scale from one listing to a watchlist or routing workflow?"	store-input.templates.json	The quickstart, recurring, and webhook templates keep the same review schema while widening the monitoring lane.

Related Actors

Use this actor first when merchant-review intelligence is the starting signal. Add the next actor when you need to widen the commercial story:

• Shopify Store Intelligence API — Add when you also need the merchant's public storefront, catalog, or launch-page changes to explain review swings.
• App Review Intelligence API | App Store + Google Play Summary — Add when the same company also operates iOS / Android apps and you want merchant feedback plus consumer app sentiment in one portfolio.
• Website Content Extractor — Add when pricing, onboarding, or help-center pages need clean copy for battlecards, churn analysis, or support QA.
• Domain Security Audit API — Add when merchant complaints point to login, checkout, or trust issues on owned web properties.

Pricing & Cost Control

Apify Store pricing is usage-based, so total cost mainly follows how many app listings you analyze and how many review pages you sample. Check the Store pricing card for the current per-event rates.

• Start with Quickstart Baseline on 1–2 listings in dataset mode while you validate the schema.
• Keep reviewLimit modest for Recurring Baseline; increase it only when deeper theme clustering changes decisions.
• Move to Webhook Routed Alerts once the merchant-feedback schema already fits your routing workflow.
• Use dryRun: true before recurring runs or larger watchlists.

Local run

npm start          # Uses input.json
npm test           # Run unit tests

Docker

docker build -t shopify-app-reviews .
docker run --rm shopify-app-reviews

⭐ Was this helpful?

If this actor saved you time, please leave a ★ rating on Apify Store. It takes 10 seconds, helps other developers discover it, and keeps updates free.

Bug report or feature request? Open an issue on the Issues tab of this actor.