Shopify App Merchant Finder

Search the Shopify App Store from your terminal. Type a free-text query like email marketing, shipping, or SEO, and get a structured list of matching Shopify apps — name, rating, review count, pricing tier, developer, and description — pulled live from apps.shopify.com.

This actor used to do reverse-lookup on retail Shopify storefronts. Because retail Shopify is now too aggressively anti-bot for headless HTTP fetches, the actor was rewritten to scrape the Shopify App Store directly (which is openly indexable and SSR-rendered).

---

Use cases

• Competitive landscape — see who's in a given Shopify app category and their review counts.
• App vendor discovery — find Shopify apps for a niche use case without paginating the store UI.
• Market sizing — measure category density and rating distributions.
• Lead lists — pipe app developer names into your CRM as B2B targets.

---

Inputs

Field	Type	Description
query	string	Free-text search (e.g. email marketing, shipping, SEO, dropshipping). Matched against Shopify App Store category slugs.
appHandle	string	Optional. Fetch one specific app directly by its handle (e.g. klaviyo-email-marketing).
categorySlug	string	Optional. Pin discovery to a known category slug.
maxApps	integer	Max apps to return. Default 40, range 1–200.
enrichDetail	boolean	When true (default), fetches each app's detail page for JSON-LD ratings + description.

At least one of query, appHandle, or categorySlug must be provided.

---

Output schema

Field	Type	Example
handle	string	klaviyo-email-marketing
appUrl	string	https://apps.shopify.com/klaviyo-email-marketing
name	string	Klaviyo: Email Marketing & SMS
developer	string	Klaviyo
rating	number	4.6
reviewCount	integer	2770
pricingTag	string	Free plan available
iconUrl	string	CDN URL of the app icon
description	string	Short app description from JSON-LD
categorySlug	string	The category slug the app was discovered under
queryMatched	string	The original query that mapped to the category
crawledAt	string	ISO timestamp

---

Notes

• Data source: apps.shopify.com (the public Shopify App Store).
• Real failures (no matching category, network errors, empty results) cause the run to FAIL with a clear status message, instead of returning a placeholder dataset.
• Per-event pricing remains in place: apify-actor-start, app-discovered, and detail-enriched.