{ "openapi": "3.0.1", "info": { "title": "Shopify Store Leads & Emails", "description": "Find Shopify stores by product keyword and country, and get each store's email, phone and socials from its own website, MX-checked, with its currency, catalogue size and shipping countries. This Actor charges only for stores where an email is found; the Google search is billed per page.", "version": "0.2", "x-build-id": "ROskyUYqLy1cFKjvB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sandy_yclept~shopify-store-leads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sandy_yclept-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/sandy_yclept~shopify-store-leads/runs": { "post": { "operationId": "runs-sync-sandy_yclept-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/sandy_yclept~shopify-store-leads/run-sync": { "post": { "operationId": "run-sync-sandy_yclept-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", "required": [ "keywords" ], "properties": { "keywords": { "title": "Product keywords", "type": "array", "description": "What the stores sell, one keyword per line: \"coffee\", \"candles\", \"Naturkosmetik\". Each keyword is searched on Google together with the line Shopify themes print in their footer, \"powered by shopify\". Variants find more stores: \"espresso\", \"cold brew\" and \"coffee roasters\" each add 10-17 new ones to \"coffee\".", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "US", "GB", "CA", "AU", "NZ", "IE", "DE", "AT", "CH", "NL", "BE", "FR", "ES", "IT", "PT", "SE", "DK", "NO", "FI", "PL" ], "type": "string", "description": "Google is searched as from this country, and stores are kept by where they are based (see the next field).", "default": "US" }, "storeLocation": { "title": "Which stores of that country", "enum": [ "based", "ships", "any" ], "type": "string", "description": "Based there (default): stores whose own settings give that country as their address. Based there or shipping there: also stores elsewhere that ship to it, including those shipping worldwide. Any: every Shopify store the search finds.", "default": "based" }, "pagesPerKeyword": { "title": "Google result pages per keyword", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many pages of Google results to read for each keyword. A page gives about 8 Shopify stores, about 6 of them based in the country searched; the Google search bills every page it reads, so this also caps what the search costs. Past the second page the stores drift away from narrow keywords - a new keyword usually finds more.", "default": 2 }, "minProducts": { "title": "Minimum published products", "minimum": 0, "type": "integer", "description": "Skip stores with fewer products on sale. 1 (default) drops empty stores and demos; 0 keeps every store.", "default": 1 }, "maxContactPages": { "title": "Max contact subpages", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many contact-like subpages (/pages/contact, /pages/about, an imprint) to read on each store, on top of its homepage. Set to 0 to read the homepage only. Shopify's own policy pages are closed to crawlers by every store's robots.txt.", "default": 5 }, "validateEmails": { "title": "Validate emails (MX + scoring)", "type": "boolean", "description": "Check each email's domain for MX records and attach a confidence score. An address whose domain accepts no mail is returned but never billed.", "default": true }, "includeSocials": { "title": "Extract social profiles", "type": "boolean", "description": "Extract Instagram, Facebook, TikTok, YouTube, X/Twitter and LinkedIn profile links from each store (share/intent URLs are filtered out). Included in the price of a store; a store with only socials is not billed.", "default": true }, "renderJs": { "title": "JavaScript rendering", "enum": [ "off", "auto", "on" ], "type": "string", "description": "Load pages in a real browser to reach contacts that are rendered by JavaScript. Off (default) is the fastest and cheapest. Auto scans without a browser first and only re-crawls a site in the browser when nothing was found — best accuracy/cost ratio. On always uses the browser. Auto and On require the run memory to be at least 2048 MB. Below 1024 MB the browser is not started and the run says so.", "default": "off" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy for fetching pages. Apify Proxy's datacenter IPs are included in every Apify plan, the Free plan too; residential proxies are billed separately. Left disabled, the Actor connects directly, and retries sites that refuse it through Apify Proxy (see below).", "default": { "useApifyProxy": false } }, "proxyFallback": { "title": "Retry refused sites through Apify Proxy", "type": "boolean", "description": "Every cloud run has a datacenter IP address, and some sites turn those away. A site that refuses or drops the direct connection is retried once through Apify Proxy's datacenter IPs (included in every Apify plan, the Free plan too), then once more directly. Sites that answer directly never go through the proxy, and robots.txt is respected either way. Has no effect when a proxy is configured above.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }