# Ecommerce Store Intelligence API (`soft_but_savage/ecommerce-store-intelligence`) Actor Enrich ecommerce store domains with platform detection, contact data, socials, tech signals, and a qualification score. - **URL**: https://apify.com/soft\_but\_savage/ecommerce-store-intelligence.md - **Developed by:** [Tahira Muhammad](https://apify.com/soft_but_savage) (community) - **Categories:** E-commerce, Lead generation - **Stats:** 1 total users, 0 monthly users, 50.0% runs succeeded, NaN 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 ## Ecommerce Store Intelligence API Turn a list of store domains into structured lead data — platform, contact emails, social profiles, tech stack signals, and a qualification score — in a single Actor run. Built for ecommerce agencies, SaaS tools, and outbound teams who already know which stores they want to target and need rich data fast. --- ### What you get per domain | Field | Example | |---|---| | `platform` | `shopify` | | `platform_confidence` | `high` | | `contact_emails` | `["help@allbirds.com"]` | | `phones` | `["+18889638944"]` | | `socials` | `{"instagram": "...", "tiktok": "..."}` | | `tech_signals` | `["shopify", "klaviyo", "yotpo", "meta_pixel"]` | | `store_name` | `Allbirds` | | `title_tag` | `Allbirds: Comfortable, Sustainable Shoes & Apparel` | | `meta_description` | full meta description text | | `about_text` | first 600 chars of visible homepage text | | `category_hint` | `apparel` (if you pass category keywords) | | `rdap_created` | `2002-01-09T15:24:37Z` (domain registration date) | | `ip_addresses` | `["23.227.38.32"]` | | `qualification_score` | `0–100` | | `qualification_reasons` | `["shopify_detected", "contact_email_found", ...]` | --- ### Platform detection Detects **Shopify**, **WooCommerce**, and **BigCommerce** from HTML signals and response headers. Returns a confidence level (`high` / `medium` / `low`) so you know how reliable each detection is. **Tech signals** also captured: Klaviyo, Recharge, Yotpo, Judge.me, Attentive, Meta Pixel, TikTok Pixel, Shopify Cloud. --- ### Contact extraction - Prioritizes `mailto:` and `tel:` href links — highest-quality signal - Falls back to visible page text for emails and phone numbers - Deduplicated across homepage and contact/about pages - Emails filtered to the store's own domain only — no third-party vendor leakage --- ### Qualification score A 0–100 score built from five weighted signals: | Signal | Points | |---|---| | Platform detected | +35 | | Contact email found | +20 | | Social presence | +15 | | 2+ tech signals | +10 | | Title tag present | +10 | | Meta description present | +10 | `qualification_reasons` tells you exactly which signals fired so you can apply your own logic downstream. --- ### Input options ```json { "domains": ["allbirds.com", "gymshark.com", "colourpop.com"], "categoryKeywords": ["apparel", "beauty", "supplements", "pets"], "platforms": ["shopify", "woocommerce"], "followContactPages": true, "timeoutSecs": 15, "userAgent": "Your Company research@yourcompany.com" } ```` | Field | Type | Default | Notes | |---|---|---|---| | `domains` | string\[] | — | Domains to enrich. Protocol and trailing slash stripped automatically. | | `categoryKeywords` | string\[] | `[]` | Homepage text is scanned for these; first match becomes `category_hint`. | | `platforms` | string\[] | `[]` | Leave empty to return all platforms. Set to `["shopify"]` to filter Shopify-only. | | `followContactPages` | boolean | `true` | Fetches `/contact`, `/about`, `/pages/contact-us` to improve email and phone extraction. | | `timeoutSecs` | integer | `15` | Per-domain HTTP timeout (5–60). | | `userAgent` | string | see default | Set this to your company name and email for polite crawling. | *** ### Example output ```json { "domain": "allbirds.com", "store_url": "https://www.allbirds.com/", "store_name": "Allbirds", "platform": "shopify", "platform_confidence": "high", "category_hint": "apparel", "contact_emails": ["help@allbirds.com", "privacy@allbirds.com"], "phones": ["+18889638944"], "socials": { "instagram": "https://www.instagram.com/allbirds", "facebook": "https://www.facebook.com/weareallbirds", "tiktok": "https://www.tiktok.com/@weareallbirds", "youtube": "https://www.youtube.com/channel/UCnGErLCau5qNJ0Xwe6uEyTw", "pinterest": "http://pinterest.com/weareallbirds", "x": "https://twitter.com/allbirds" }, "tech_signals": ["shopify", "yotpo", "shopify_cloud", "tiktok_pixel"], "about_text": "Allbirds: Comfortable, Sustainable Shoes & Apparel...", "title_tag": "Allbirds: Comfortable, Sustainable Shoes & Apparel", "meta_description": "The world's most comfortable shoes made with natural materials...", "rdap_created": "2002-01-09T15:24:37Z", "ip_addresses": ["23.227.38.32"], "qualification_score": 100, "qualification_reasons": [ "shopify_detected", "contact_email_found", "social_presence", "multiple_tech_signals", "title_present", "meta_description_present" ], "enriched_at": "2026-04-10T03:05:52Z" } ``` *** ### Common workflows **Shopify lead list enrichment** — Upload a CSV of domains, set `platforms: ["shopify"]`, export to Google Sheets. You get platform-confirmed stores with emails and social handles ready for outreach. **DTC brand research** — Pass 50–200 brands, use `categoryKeywords` to tag verticals, sort by `qualification_score` to prioritize. **Agency prospecting** — Filter by `platform`, check `tech_signals` for tools you integrate with (Klaviyo, Recharge, Yotpo), reach out to brands already in your ecosystem. **Vendor targeting** — Find stores using specific tech (e.g. Yotpo) that you can replace or complement. *** ### Limitations - Detects Shopify, WooCommerce, BigCommerce. Headless or custom platforms return `platform: "unknown"`. - Email extraction is limited to the store's own domain — transactional and vendor emails are excluded. - Contact pages are fetched on a best-effort basis; some stores block automated access. - Phone extraction requires numbers to appear in visible page text or `tel:` links. - RDAP data depends on registry availability and may be absent for some TLDs. # Actor input Schema ## `domains` (type: `array`): Store domains to enrich. ## `categoryKeywords` (type: `array`): Optional keywords to score category fit from homepage text. ## `platforms` (type: `array`): Optional platform filter to keep only matched stores. ## `followContactPages` (type: `boolean`): Fetch likely contact/about pages to improve email and social extraction. ## `timeoutSecs` (type: `integer`): Per-request timeout for store fetches. ## `userAgent` (type: `string`): User-Agent string used for store requests. ## `openaiApiKey` (type: `string`): Optional API Key for GPT-4o inference on complex stores. ## Actor input object example ```json { "domains": [ "allbirds.com", "gymshark.com", "colourpop.com" ], "categoryKeywords": [ "apparel", "beauty", "supplements", "pets" ], "platforms": [ "shopify", "woocommerce" ], "followContactPages": true, "timeoutSecs": 15, "userAgent": "Soft But Savage research@example.com" } ``` # Actor output Schema ## `results` (type: `string`): No description # 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", "gymshark.com", "colourpop.com" ], "categoryKeywords": [ "apparel", "beauty", "supplements", "pets" ], "platforms": [ "shopify", "woocommerce" ], "followContactPages": true, "timeoutSecs": 15, "userAgent": "Soft But Savage research@example.com" }; // Run the Actor and wait for it to finish const run = await client.actor("soft_but_savage/ecommerce-store-intelligence").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", "gymshark.com", "colourpop.com", ], "categoryKeywords": [ "apparel", "beauty", "supplements", "pets", ], "platforms": [ "shopify", "woocommerce", ], "followContactPages": True, "timeoutSecs": 15, "userAgent": "Soft But Savage research@example.com", } # Run the Actor and wait for it to finish run = client.actor("soft_but_savage/ecommerce-store-intelligence").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", "gymshark.com", "colourpop.com" ], "categoryKeywords": [ "apparel", "beauty", "supplements", "pets" ], "platforms": [ "shopify", "woocommerce" ], "followContactPages": true, "timeoutSecs": 15, "userAgent": "Soft But Savage research@example.com" }' | apify call soft_but_savage/ecommerce-store-intelligence --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=soft_but_savage/ecommerce-store-intelligence", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Ecommerce Store Intelligence API", "description": "Enrich ecommerce store domains with platform detection, contact data, socials, tech signals, and a qualification score.", "version": "0.1", "x-build-id": "17z3SPiBz9uArbaeF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/soft_but_savage~ecommerce-store-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-soft_but_savage-ecommerce-store-intelligence", "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/soft_but_savage~ecommerce-store-intelligence/runs": { "post": { "operationId": "runs-sync-soft_but_savage-ecommerce-store-intelligence", "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/soft_but_savage~ecommerce-store-intelligence/run-sync": { "post": { "operationId": "run-sync-soft_but_savage-ecommerce-store-intelligence", "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": { "domains": { "title": "Domains", "type": "array", "description": "Store domains to enrich.", "items": { "type": "string" } }, "categoryKeywords": { "title": "Category keywords", "type": "array", "description": "Optional keywords to score category fit from homepage text.", "items": { "type": "string" } }, "platforms": { "title": "Platforms", "type": "array", "description": "Optional platform filter to keep only matched stores.", "items": { "type": "string" } }, "followContactPages": { "title": "Follow contact pages", "type": "boolean", "description": "Fetch likely contact/about pages to improve email and social extraction.", "default": true }, "timeoutSecs": { "title": "Timeout seconds", "minimum": 5, "maximum": 60, "type": "integer", "description": "Per-request timeout for store fetches.", "default": 15 }, "userAgent": { "title": "User-Agent", "type": "string", "description": "User-Agent string used for store requests.", "default": "Soft But Savage research@example.com" }, "openaiApiKey": { "title": "OpenAI API Key", "type": "string", "description": "Optional API Key for GPT-4o inference on complex stores." } } }, "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 } } } } } } } } } } ```