# Shopify Store Leads (`dami_studio/shopify-store-leads`) Actor Enrich Shopify domains with contacts, social profiles, catalog samples, currency, country, theme, apps, technologies, and high-value page URLs. Uses keyless direct HTTP by default, validates every destination against SSRF, and charges only confirmed Shopify stores. - **URL**: https://apify.com/dami\_studio/shopify-store-leads.md - **Developed by:** [Dami's Studio](https://apify.com/dami_studio) (community) - **Categories:** E-commerce, Lead generation, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $4.50 / 1,000 shopify store leads This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Leads Shopify Store Leads finds public Shopify storefronts and returns one consolidated lead record per store. It uses direct HTTP requests by default, detects Shopify from public HTML and storefront endpoints, samples products, and enriches contact and social signals from a small set of same-site pages. ### What it does - Accepts store domains, URLs, or Apify `startUrls`. - Confirms Shopify with multiple independent public signals. - Extracts store title, description, country, currency, theme hints, technologies, emails, phones, social profiles, contact/about URLs, and product samples. - Uses `/products.json` and `/shop.json` when those public endpoints are available. - Enforces SSRF checks before every initial request and redirect, including DNS resolution against private and reserved addresses. - Keeps concurrency, response size, redirects, pages, and product samples bounded. - Supports an optional Apify or custom proxy for stores that block direct cloud traffic. ### Input Provide `stores` as domains or URLs, or `startUrls` as request-list objects. `maxPagesPerStore` defaults to 4, `maxProducts` to 20, and `maxConcurrency` to 5. `defaultCountry` is used only for local phone normalization. Proxy use is opt-in. ### Output One row is emitted per requested store. Successful rows have `ok: true` and `isShopify: true`. A failed, blocked, invalid, unreachable, or non-Shopify input becomes an `ok: false` diagnostic row. Diagnostics include an `errorCode` and are never charged. Empty input emits a clearly labeled `_sample: true` row for the Apify input preview. Sample rows are never charged. ### Billing and economics The actor emits the pay-per-event event `store` only after a confirmed Shopify result has been written to the dataset. Non-Shopify sites and all diagnostic or sample rows do not call `Actor.charge`. The planned price is **$0.0045 per confirmed Shopify store**, below the observed $0.00599 per-store competitor benchmark. Direct HTTP is the default because residential proxy bandwidth can erase the margin on small lead records. At the planned price, validate a representative cloud batch before publishing or enabling residential proxy by default. ### Proxy and limitations Some Shopify stores use bot protection, geoblocking, consent interstitials, or client-rendered content. A proxy can help with IP blocking but adds bandwidth cost and may still be blocked. This actor does not bypass authentication, CAPTCHAs, paywalls, checkout flows, or private APIs. It does not submit forms or contact stores. The product endpoint is a public sample, not a guaranteed complete inventory. `productCountType` tells you whether the count is a storefront endpoint sample or unavailable. ### Local development ```bash npm install npm test npm run check npm run smoke ```` The live smoke test uses `SHOPIFY_SMOKE_URL` when supplied and defaults to `https://www.allbirds.com`. It is intentionally local-only and does not deploy or publish the actor. # Actor input Schema ## `stores` (type: `array`): Shopify store domains or full URLs, one per line. Values without a scheme use HTTPS. ## `startUrls` (type: `array`): Alternative Apify request-list input. Can be combined with Store domains or URLs. ## `maxPagesPerStore` (type: `integer`): Maximum HTML page attempts per store. Contact and about pages are prioritized. ## `maxProducts` (type: `integer`): Maximum products to retain from the public Shopify catalog endpoint. Set to 0 to skip catalog lookup. ## `maxConcurrency` (type: `integer`): Number of stores processed concurrently. ## `requestTimeoutSecs` (type: `integer`): Maximum duration of each HTTP request. ## `maxResponseSizeKb` (type: `integer`): Maximum HTML or JSON response body size per request. ## `defaultCountry` (type: `string`): Optional ISO 3166-1 alpha-2 country code used to normalize local phone numbers. ## `proxyConfiguration` (type: `object`): Optional. Direct HTTP is used by default. Enable a proxy only for stores that block Apify cloud IPs. ## Actor input object example ```json { "stores": [ "allbirds.com", "https://www.gymshark.com" ], "startUrls": [ { "url": "https://www.allbirds.com" } ], "maxPagesPerStore": 4, "maxProducts": 20, "maxConcurrency": 5, "requestTimeoutSecs": 12, "maxResponseSizeKb": 2048, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): Store lead records in the default dataset. # 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 = { "stores": [ "https://www.allbirds.com" ] }; // Run the Actor and wait for it to finish const run = await client.actor("dami_studio/shopify-store-leads").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 = { "stores": ["https://www.allbirds.com"] } # Run the Actor and wait for it to finish run = client.actor("dami_studio/shopify-store-leads").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 '{ "stores": [ "https://www.allbirds.com" ] }' | apify call dami_studio/shopify-store-leads --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dami_studio/shopify-store-leads", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Shopify Store Leads", "description": "Enrich Shopify domains with contacts, social profiles, catalog samples, currency, country, theme, apps, technologies, and high-value page URLs. Uses keyless direct HTTP by default, validates every destination against SSRF, and charges only confirmed Shopify stores.", "version": "0.1", "x-build-id": "W0TgcqO9GRcVd5TW5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~shopify-store-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-shopify-store-leads", "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/dami_studio~shopify-store-leads/runs": { "post": { "operationId": "runs-sync-dami_studio-shopify-store-leads", "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/dami_studio~shopify-store-leads/run-sync": { "post": { "operationId": "run-sync-dami_studio-shopify-store-leads", "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", "properties": { "stores": { "title": "Store domains or URLs", "type": "array", "description": "Shopify store domains or full URLs, one per line. Values without a scheme use HTTPS.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Alternative Apify request-list input. Can be combined with Store domains or URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxPagesPerStore": { "title": "Maximum pages per store", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum HTML page attempts per store. Contact and about pages are prioritized.", "default": 4 }, "maxProducts": { "title": "Maximum product samples", "minimum": 0, "maximum": 250, "type": "integer", "description": "Maximum products to retain from the public Shopify catalog endpoint. Set to 0 to skip catalog lookup.", "default": 20 }, "maxConcurrency": { "title": "Maximum concurrent stores", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of stores processed concurrently.", "default": 5 }, "requestTimeoutSecs": { "title": "Request timeout", "minimum": 3, "maximum": 45, "type": "integer", "description": "Maximum duration of each HTTP request.", "default": 12 }, "maxResponseSizeKb": { "title": "Maximum response size", "minimum": 128, "maximum": 5120, "type": "integer", "description": "Maximum HTML or JSON response body size per request.", "default": 2048 }, "defaultCountry": { "title": "Default phone country", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Optional ISO 3166-1 alpha-2 country code used to normalize local phone numbers." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Direct HTTP is used by default. Enable a proxy only for stores that block Apify cloud IPs.", "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 } } } } } } } } } } ```