# Shopify Store Audit & Tech-Stack Lead Scorer (`fried_calamaries/shopify-store-intel`) Actor Audit any Shopify store — installed apps, theme, pricing & catalog signals, and tech-stack gaps. Bulk-score a prospect list and monitor stores for app installs/removals. - **URL**: https://apify.com/fried\_calamaries/shopify-store-intel.md - **Developed by:** [ByteMe](https://apify.com/fried_calamaries) (community) - **Categories:** E-commerce, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Shopify Store Audit & Tech-Stack Lead Scorer Turn a list of Shopify store domains into qualified, scored leads. For each store you get the detected apps (reviews, email, search, upsell, loyalty, subscription, chat), theme, and catalog/pricing signals — plus the tech-stack GAPS (which app categories are missing) and a lead-match flag against your criteria. Run it on a schedule and it also reports what changed since last time (apps added/removed, product-count delta) — turning competitor and prospect monitoring into a set-and-forget task. Built for app vendors and agencies prospecting Shopify merchants. ### How to use Set the input, run the actor, and collect results from the run's dataset (export to JSON/CSV/Excel, or pull via the Apify API). Example input: ```json { "domains": [ "allbirds.com", "colourpop.com" ], "targetGaps": [ "reviews" ], "compareToPrevious": true } ```` See **Inputs** below for every available field. ### What you get One row per record: | Field | Description | |---|---| | `domain` | Store domain audited | | `is_shopify` | Whether the domain is a confirmed Shopify store | | `detected_apps` | Installed apps detected from the storefront ({name, category}) | | `app_categories` | Categories of detected apps | | `missing_categories` | App categories with NO detected app — the prospecting gaps | | `matches_criteria` | True when all your target-gap categories are missing (a lead) | | `has_reviews_app / has_search_app / …` | Per-category presence flags (reviews, email, search, upsell, loyalty, subscription, chat) | | `theme_name` | Storefront theme name | | `product_count` | Product count (caps at maxProductsPerStore) | | `price_min / price_max` | Variant price range | | `currency` | Store currency (ISO code) | | `discount_rate` | Fraction of products with a compare-at markdown | | `new_products_30d` | Products created in the last 30 days (catalog velocity) | | `shopify_plus` | Best-effort Shopify Plus signal | | `products_json_accessible` | Whether /products.json was readable (else counts via sitemap) | | `apps_added / apps_removed` | Apps installed/removed since the previous run (monitoring) | | `product_count_delta` | Product-count change since the previous run | | `first_seen` | True on the first run for this domain | | `source_url` | The store URL | Sample: ```json { "domain": "allbirds.com", "is_shopify": true, "detection_signals": [ "cdn.shopify.com", "Shopify.theme" ], "shopify_plus": false, "theme_name": "Dawn", "detected_apps": [ { "name": "Yotpo", "category": "reviews" }, { "name": "Klaviyo", "category": "email" } ], "app_categories": [ "email", "reviews" ], "has_reviews_app": true, "has_email_app": true, "has_search_app": false, "missing_categories": [ "search", "upsell", "loyalty", "subscription", "chat" ], "matches_criteria": false, "product_count": 629, "price_min": 18.0, "price_max": 160.0, "currency": "USD", "discount_rate": 0.12, "new_products_30d": 7, "products_json_accessible": true, "first_seen": false, "apps_added": [ "Klaviyo" ], "apps_removed": [], "product_count_delta": 12, "source_url": "https://allbirds.com" } ``` ### Inputs | Field | Required | Type | Default | Description | |---|---|---|---|---| | `domains` | yes | array | `["allbirds.com"]` | Shopify store domains or URLs to audit, e.g. 'allbirds.com'. Paste a list to bulk-audit a prospect list. We audit the domains you provide (we don't discover stores). | | `targetGaps` | no | array | — | App categories that should be MISSING for a store to count as a lead — sets 'matches\_criteria'. E.g. a reviews-app vendor sets \['reviews']. Categories: reviews, email, search, upsell, loyalty, subscription, chat. | | `includeProducts` | no | boolean | `false` | When off (default), return store signals only (fast, cheap — the lead-gen need). Turn on to also include the (slimmed) product catalog. | | `compareToPrevious` | no | boolean | `true` | When on (default), diff each store against the previous run and report what changed — apps added/removed and product-count delta. Run on a schedule to track stores over time. | | `maxProductsPerStore` | no | integer | `1000` | Cap on products sampled per store (bounds cost). Product count caps here for very large stores. | | `proxyConfiguration` | no | object | `{"useApifyProxy": false}` | Optional. Shopify storefronts are usually reachable directly; enable a proxy (e.g. residential) only if a store is blocked. | ### Pricing **Free.** No per-result charge — you only pay your own Apify platform usage (compute) per your plan. This actor is free to run while we gauge interest — there's no per-result charge. ### Use cases - App-vendor prospecting — find Shopify stores missing your app's category (e.g. no reviews app) and treat them as warm leads. - Agency lead-gen — bulk-audit a prospect list, score by tech-stack gaps and store size, and export for your CRM/outreach. - Competitor & prospect monitoring — run weekly to get alerted when stores install or remove apps, or ramp their catalog. - Enrich a domain list — add apps, theme, pricing range and catalog signals to stores you already have. ### Limitations & updates Storefront (public) data only — never returns real inventory counts, sales, revenue, orders, traffic, or customers (those are Admin-API-only). It audits the domains you provide; it does not discover stores across Shopify. ~10–15% of stores disable /products.json (counts fall back to the sitemap). App detection is best-effort from storefront markers and is kept current via the self-healer. Some stores sit behind bot protection — enable the residential proxy toggle if a run is blocked. # Actor input Schema ## `domains` (type: `array`): Shopify store domains or URLs to audit, e.g. 'allbirds.com'. Paste a list to bulk-audit a prospect list. We audit the domains you provide (we don't discover stores). ## `targetGaps` (type: `array`): App categories that should be MISSING for a store to count as a lead — sets 'matches\_criteria'. E.g. a reviews-app vendor sets \['reviews']. Categories: reviews, email, search, upsell, loyalty, subscription, chat. ## `includeProducts` (type: `boolean`): When off (default), return store signals only (fast, cheap — the lead-gen need). Turn on to also include the (slimmed) product catalog. ## `compareToPrevious` (type: `boolean`): When on (default), diff each store against the previous run and report what changed — apps added/removed and product-count delta. Run on a schedule to track stores over time. ## `maxProductsPerStore` (type: `integer`): Cap on products sampled per store (bounds cost). Product count caps here for very large stores. ## `proxyConfiguration` (type: `object`): Optional. Shopify storefronts are usually reachable directly; enable a proxy (e.g. residential) only if a store is blocked. ## Actor input object example ```json { "domains": [ "allbirds.com", "colourpop.com" ], "targetGaps": [ "reviews" ], "includeProducts": false, "compareToPrevious": true, "maxProductsPerStore": 1000, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `audits` (type: `string`): Per-store intelligence: detected apps, gap flags, pricing/catalog signals, and changes since the last run. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "domains": [ "allbirds.com" ] }; // Run the Actor and wait for it to finish const run = await client.actor("fried_calamaries/shopify-store-intel").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "domains": ["allbirds.com"] } # Run the Actor and wait for it to finish run = client.actor("fried_calamaries/shopify-store-intel").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "domains": [ "allbirds.com" ] }' | apify call fried_calamaries/shopify-store-intel --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fried_calamaries/shopify-store-intel", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Shopify Store Audit & Tech-Stack Lead Scorer", "description": "Audit any Shopify store — installed apps, theme, pricing & catalog signals, and tech-stack gaps. Bulk-score a prospect list and monitor stores for app installs/removals.", "version": "0.1", "x-build-id": "eV2zQVemSjXXkGIP6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fried_calamaries~shopify-store-intel/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fried_calamaries-shopify-store-intel", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/fried_calamaries~shopify-store-intel/runs": { "post": { "operationId": "runs-sync-fried_calamaries-shopify-store-intel", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/fried_calamaries~shopify-store-intel/run-sync": { "post": { "operationId": "run-sync-fried_calamaries-shopify-store-intel", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "domains" ], "properties": { "domains": { "title": "Store domains", "type": "array", "description": "Shopify store domains or URLs to audit, e.g. 'allbirds.com'. Paste a list to bulk-audit a prospect list. We audit the domains you provide (we don't discover stores).", "items": { "type": "string" } }, "targetGaps": { "title": "Target gaps (lead criteria)", "type": "array", "description": "App categories that should be MISSING for a store to count as a lead — sets 'matches_criteria'. E.g. a reviews-app vendor sets ['reviews']. Categories: reviews, email, search, upsell, loyalty, subscription, chat.", "items": { "type": "string" } }, "includeProducts": { "title": "Include full catalog", "type": "boolean", "description": "When off (default), return store signals only (fast, cheap — the lead-gen need). Turn on to also include the (slimmed) product catalog.", "default": false }, "compareToPrevious": { "title": "Monitor changes", "type": "boolean", "description": "When on (default), diff each store against the previous run and report what changed — apps added/removed and product-count delta. Run on a schedule to track stores over time.", "default": true }, "maxProductsPerStore": { "title": "Max products per store", "minimum": 1, "maximum": 25000, "type": "integer", "description": "Cap on products sampled per store (bounds cost). Product count caps here for very large stores.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Shopify storefronts are usually reachable directly; enable a proxy (e.g. residential) only if a store is blocked.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```