# Shopify Store Leads & Contacts API by StoreInspect (`storeinspect/shopify-store-search`) Actor Find qualified Shopify store leads, enrich known domains, and reveal verified decision-maker contacts with StoreInspect. Filter by category, country, traffic, apps, pixels, Shopify Plus, tech gaps, and contact roles. Runs directly on Apify with pay-per-event pricing. - **URL**: https://apify.com/storeinspect/shopify-store-search.md - **Developed by:** [StoreInspect](https://apify.com/storeinspect) (community) - **Categories:** Lead generation, E-commerce - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 store search results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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 Leads & Contacts API by StoreInspect Find qualified Shopify store leads, enrich known domains, preview decision-maker contacts, and reveal selected contact details through StoreInspect on Apify. StoreInspect is built for Shopify-specific prospecting and market research. Instead of crawling random websites one by one, this Actor returns structured intelligence for Shopify stores: categories, countries, traffic signals, Shopify Plus signals, apps, pixels, technology gaps, contact availability, and contact roles. Use it to build Shopify lead lists, enrich store domains, and reveal selected decision-maker contacts with transparent pay-per-event pricing. ### What You Can Do - Search Shopify store leads by ICP filters such as country, category, traffic, Shopify Plus, app usage, pixel usage, and contact availability. - Enrich known Shopify domains with store, technology, and optional contact preview data. - Search preview-safe contacts for Shopify brands without exposing email, phone, or LinkedIn URLs. - Reveal selected contacts only after explicit confirmation with `confirm_spend_credits=true`. - Save results to the Apify dataset for CSV, JSON, Excel, API, and automation workflows. ### Good Use Cases - Find US beauty Shopify stores missing Klaviyo. - Find Shopify Plus stores using Meta Pixel for agency outreach. - Enrich a CRM list of Shopify domains before sales prospecting. - Find founder, owner, ecommerce manager, or marketing contacts at Shopify brands. - Build Shopify app partner, agency prospecting, or competitive research lists. ### Endpoints This Actor runs in Apify Standby mode. Use the Actor's Standby URL from Apify Console and call these endpoints: | Endpoint | What it does | Billing event | | ----------------------- | ----------------------------------------------- | ---------------------------------------------- | | `POST /stores/search` | Search qualified Shopify stores | `store-search-result` | | `POST /stores/enrich` | Enrich known Shopify domains | `store-enrichment`, optional `contact-preview` | | `POST /contacts/search` | Return preview-safe Shopify contacts | `contact-preview` | | `POST /contacts/reveal` | Reveal selected contact data after confirmation | `contact-reveal` | | `POST /` | Mode-based wrapper for all workflows | Depends on mode | To preview the output format, run the default sample mode. It creates one example dataset item and does not use live StoreInspect data. Use the Standby endpoints above, or choose one of the paid modes below, for live StoreInspect data. ### Example: Search Shopify Store Leads Use this to find Shopify store leads matching a specific sales or research workflow. ```json { "filters": { "countries": ["US"], "categories": ["beauty"], "apps": { "none": ["Klaviyo"] }, "pixels": { "any": ["Meta Pixel"] }, "contacts": { "has_revealable_contacts": true, "roles_any": ["founder", "ecommerce_manager"] } }, "limit": 5, "push_data": true } ```` Call it with: ```bash curl -X POST "https://storeinspect--shopify-store-search.apify.actor/stores/search" \ -H "content-type: application/json" \ -H "authorization: Bearer " \ -d '{ "filters": { "countries": ["US"], "categories": ["beauty"], "apps": { "none": ["Klaviyo"] }, "pixels": { "any": ["Meta Pixel"] }, "contacts": { "has_revealable_contacts": true, "roles_any": ["founder", "ecommerce_manager"] } }, "limit": 5, "push_data": true }' ``` ### Example: Enrich Known Shopify Domains Use this when you already have domains from a CRM, spreadsheet, scrape, trade show, or another Apify Actor. ```json { "domains": ["skims.com", "allbirds.com"], "include": ["store", "technologies", "contact_previews"], "contact_roles": ["founder", "ecommerce_manager"], "max_contacts_per_store": 1, "push_data": true } ``` ### Example: Search Contact Previews Contact previews tell you whether StoreInspect has useful contact data without revealing paid fields. ```json { "person": { "roles_any": ["founder", "owner", "ecommerce_manager"] }, "store": { "countries": ["US"], "apps": { "any": ["Shopify"] }, "contacts": { "has_revealable_contacts": true } }, "limit": 10, "push_data": true } ``` Preview results do not include email addresses, phone numbers, or LinkedIn URLs. ### Example: Reveal Selected Contacts Reveals must be explicit. The Actor will not reveal contact details unless you pass `confirm_spend_credits=true`. ```json { "contact_ids": ["ct_123"], "confirm_spend_credits": true, "push_data": true } ``` Call it with: ```bash curl -X POST "https://storeinspect--shopify-store-search.apify.actor/contacts/reveal" \ -H "content-type: application/json" \ -H "authorization: Bearer " \ -d '{ "contact_ids": ["ct_123"], "confirm_spend_credits": true, "push_data": true }' ``` Already-revealed contacts for the same Apify user are returned without another reveal charge when StoreInspect can verify the prior reveal. ### Mode-Based Wrapper You can also call `POST /` with a `mode` field. ```json { "mode": "search_stores", "filters": { "countries": ["US"], "shopify_plus": true }, "limit": 10, "push_data": true } ``` Supported modes: - `sample` - `search_stores` - `enrich_domains` - `search_contacts` - `reveal_contacts` ### Output Each successful response is wrapped like this: ```json { "ok": true, "mode": "search_stores", "endpoint": "/stores/search", "dataset_items_written": 5, "result": { "data": [ { "domain": "example-store.com", "name": "Example Store", "country": "US", "category": "beauty", "traffic_tier": "50k-200k", "shopify_plus": false, "app_names": ["Reviews App"], "pixels": ["Meta Pixel"], "contacts_count": 2 } ], "next_cursor": null, "billing_truncated": false } } ``` When `push_data` is true, items from `result.data[]` are also saved to the Apify dataset. The Actor adds `_storeinspect` metadata to each dataset item with the selected mode, API endpoint, and retrieval timestamp. ### Pricing This Actor uses Apify pay-per-event billing: | Event | Price | | ------------------- | -------------------------------------: | | Store search result | $2.00 / 1,000 returned stores | | Store enrichment | $5.00 / 1,000 enriched domains | | Contact preview | $1.00 / 1,000 preview-safe contacts | | Contact reveal | $75.00 / 1,000 newly revealed contacts | Apify platform usage may also apply while the Actor is running, depending on the billing settings shown in Apify Console. If your Apify run charge limit is reached, the Actor truncates returned results to the count Apify actually charged. ### Contact Preview vs Contact Reveal Contact preview is for qualification. It can show that a contact exists and has revealable channels, but it does not include email, phone, or LinkedIn URL. Contact reveal is for outreach-ready data. It requires: ```json { "contact_ids": ["ct_123"], "confirm_spend_credits": true } ``` This guard prevents accidental contact reveal charges from automated workflows or AI agents. ### Notes - Paid results are available through Apify pay-per-event runs. - Data availability depends on StoreInspect's Shopify store and contact coverage. - Result fields can vary by workflow and available data. Use the Output tab or dataset export to inspect returned fields. - Follow applicable outreach, privacy, and email compliance rules for your use case. ### Support Use the Apify Issues tab for Actor questions or failures. Include the run ID, endpoint, input shape, and approximate time of the run so the issue can be debugged quickly. # Actor input Schema ## `mode` (type: `string`): Which StoreInspect workflow to run when calling POST / or starting a standard Actor run. Sample mode creates one example dataset item and does not call live StoreInspect data. ## `filters` (type: `object`): Store filters for search\_stores, or store-side filters for search\_contacts. Example: country, category, apps, pixels, Shopify Plus, traffic, and contact availability. ## `person` (type: `object`): Person filters for search\_contacts. Example: target founders, owners, ecommerce managers, marketing leaders, or operations roles. ## `domains` (type: `array`): Known Shopify domains to enrich when mode is enrich\_domains. ## `contact_ids` (type: `array`): Public StoreInspect contact IDs to reveal when mode is reveal\_contacts, e.g. ct\_123. ## `confirm_spend_credits` (type: `boolean`): Must be true for reveal\_contacts. This prevents accidental contact reveal charges. ## `limit` (type: `integer`): Maximum number of search results to return. ## `push_data` (type: `boolean`): When true, response items are saved to the Apify dataset. ## Actor input object example ```json { "mode": "sample", "filters": { "countries": [ "US" ], "categories": [ "beauty" ], "apps": { "none": [ "Klaviyo" ] }, "pixels": { "any": [ "Meta Pixel" ] }, "contacts": { "has_revealable_contacts": true, "roles_any": [ "founder", "ecommerce_manager" ] } }, "person": { "roles_any": [ "founder", "ecommerce_manager" ] }, "domains": [ "skims.com", "allbirds.com" ], "contact_ids": [ "ct_123" ], "confirm_spend_credits": false, "limit": 5, "push_data": true } ``` # Actor output Schema ## `results` (type: `string`): Sample, store, enrichment, contact preview, or contact reveal items returned by the selected workflow. # 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 = { "mode": "sample", "filters": { "countries": [ "US" ], "categories": [ "beauty" ], "apps": { "none": [ "Klaviyo" ] }, "pixels": { "any": [ "Meta Pixel" ] }, "contacts": { "has_revealable_contacts": true, "roles_any": [ "founder", "ecommerce_manager" ] } }, "person": { "roles_any": [ "founder", "ecommerce_manager" ] }, "domains": [ "skims.com", "allbirds.com" ], "contact_ids": [ "ct_123" ], "limit": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("storeinspect/shopify-store-search").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 = { "mode": "sample", "filters": { "countries": ["US"], "categories": ["beauty"], "apps": { "none": ["Klaviyo"] }, "pixels": { "any": ["Meta Pixel"] }, "contacts": { "has_revealable_contacts": True, "roles_any": [ "founder", "ecommerce_manager", ], }, }, "person": { "roles_any": [ "founder", "ecommerce_manager", ] }, "domains": [ "skims.com", "allbirds.com", ], "contact_ids": ["ct_123"], "limit": 5, } # Run the Actor and wait for it to finish run = client.actor("storeinspect/shopify-store-search").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 '{ "mode": "sample", "filters": { "countries": [ "US" ], "categories": [ "beauty" ], "apps": { "none": [ "Klaviyo" ] }, "pixels": { "any": [ "Meta Pixel" ] }, "contacts": { "has_revealable_contacts": true, "roles_any": [ "founder", "ecommerce_manager" ] } }, "person": { "roles_any": [ "founder", "ecommerce_manager" ] }, "domains": [ "skims.com", "allbirds.com" ], "contact_ids": [ "ct_123" ], "limit": 5 }' | apify call storeinspect/shopify-store-search --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=storeinspect/shopify-store-search", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Shopify Store Leads & Contacts API by StoreInspect", "description": "Find qualified Shopify store leads, enrich known domains, and reveal verified decision-maker contacts with StoreInspect. Filter by category, country, traffic, apps, pixels, Shopify Plus, tech gaps, and contact roles. Runs directly on Apify with pay-per-event pricing.", "version": "0.1", "x-build-id": "HWT3WJRWDTtmFZpBk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/storeinspect~shopify-store-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-storeinspect-shopify-store-search", "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/storeinspect~shopify-store-search/runs": { "post": { "operationId": "runs-sync-storeinspect-shopify-store-search", "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/storeinspect~shopify-store-search/run-sync": { "post": { "operationId": "run-sync-storeinspect-shopify-store-search", "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": { "mode": { "title": "Mode", "enum": [ "sample", "search_stores", "enrich_domains", "search_contacts", "reveal_contacts" ], "type": "string", "description": "Which StoreInspect workflow to run when calling POST / or starting a standard Actor run. Sample mode creates one example dataset item and does not call live StoreInspect data.", "default": "sample" }, "filters": { "title": "Store filters", "type": "object", "description": "Store filters for search_stores, or store-side filters for search_contacts. Example: country, category, apps, pixels, Shopify Plus, traffic, and contact availability.", "default": {} }, "person": { "title": "Person filters", "type": "object", "description": "Person filters for search_contacts. Example: target founders, owners, ecommerce managers, marketing leaders, or operations roles.", "default": {} }, "domains": { "title": "Domains", "type": "array", "description": "Known Shopify domains to enrich when mode is enrich_domains.", "items": { "type": "string" }, "default": [] }, "contact_ids": { "title": "Contact IDs", "type": "array", "description": "Public StoreInspect contact IDs to reveal when mode is reveal_contacts, e.g. ct_123.", "items": { "type": "string" }, "default": [] }, "confirm_spend_credits": { "title": "Confirm reveal spend", "type": "boolean", "description": "Must be true for reveal_contacts. This prevents accidental contact reveal charges.", "default": false }, "limit": { "title": "Limit", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of search results to return.", "default": 25 }, "push_data": { "title": "Save results to dataset", "type": "boolean", "description": "When true, response items are saved to the Apify dataset.", "default": true } } }, "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 } } } } } } } } } } ```