{ "openapi": "3.0.1", "info": { "title": "Shopify Email Scraper: Store Contacts, Phones & Socials", "description": "Shopify store contacts lookup by domain: give store URLs, get each store's public emails, phones, address and socials plus Shopify facts (store name, country, currency, myshopify domain, product count). $0.003 per store with an email; stores with nothing found are free.", "version": "0.1", "x-build-id": "vGDXJwaL4LdhKmB4b" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datagleaner~shopify-store-contacts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datagleaner-shopify-store-contacts", "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/datagleaner~shopify-store-contacts/runs": { "post": { "operationId": "runs-sync-datagleaner-shopify-store-contacts", "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/datagleaner~shopify-store-contacts/run-sync": { "post": { "operationId": "run-sync-datagleaner-shopify-store-contacts", "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": { "storeUrls": { "title": "Store URLs or domains", "type": "array", "description": "Shopify stores to look up, one per line: a domain (`brooklinen.com`), any URL on the store (`https://www.allbirds.com/products/x`) or a `name.myshopify.com` address. Sites that are not on Shopify are still checked and flagged `isShopify: false`. Leave empty to run 3 example stores.", "items": { "type": "string" } }, "datasetId": { "title": "Dataset ID (from another Actor)", "type": "string", "description": "Optional. Read store sites from this dataset, for example Google Maps Scraper or a Shopify store list, and add them to the stores above. Each item's `website` (or `storeUrl`, `shopUrl`, `myshopifyDomain`, `domain`, `url`, `homepage`...) is used; items without one are skipped. In an integration use `{{resource.defaultDatasetId}}`." }, "datasetField": { "title": "Dataset field with the store URL", "type": "string", "description": "Optional. Field name to read first in each dataset item (use `a.b` for a nested field). Empty tries the usual names." }, "maxDatasetItems": { "title": "Max sites from the dataset", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Most distinct sites read from the dataset. Only stores with an email are billed.", "default": 1000 }, "maxPagesPerStore": { "title": "Max pages per store", "minimum": 1, "maximum": 10, "type": "integer", "description": "Most HTML pages read per store, the home page included. The run stops reading a store as soon as an email on the store's own domain is found, so most stores take 1 to 3 pages. /meta.json and /products.json are extra.", "default": 5 }, "includeProductStats": { "title": "Include product stats", "type": "boolean", "description": "Read /products.json once per Shopify store for the newest product's date and the latest publish date. The product count comes from Shopify's store summary either way.", "default": true }, "onlyWithEmail": { "title": "Only stores with an email", "type": "boolean", "description": "Output only stores where at least one public email was found. Stores without one are free either way.", "default": false }, "pagePaths": { "title": "Pages to check after the home page", "type": "array", "description": "Paths read in this order after the home page until an email is found. Empty uses /pages/contact, /pages/contact-us, /policies/terms-of-service, /policies/privacy-policy on Shopify stores (and /contact, /contact-us, /about, /privacy-policy elsewhere). A contact page the store links to from its home page is always read first.", "items": { "type": "string" } }, "maxConcurrency": { "title": "Stores in parallel", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many stores are processed at the same time. Shopify slows down heavy traffic from one IP, so keep it modest on large runs.", "default": 5 }, "delaySecs": { "title": "Pacing (seconds)", "minimum": 0, "maximum": 30, "type": "number", "description": "Pause of 50 to 100% of this many seconds between requests to the same store, and a random start delay up to this value per store.", "default": 1 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 3, "maximum": 120, "type": "integer", "description": "How long to wait for each page before retrying.", "default": 20 }, "respectRobotsTxt": { "title": "Respect robots.txt", "type": "boolean", "description": "Skip pages a store's robots.txt disallows. Shopify's default robots.txt disallows /policies/ for search engines on every store, so turning this on skips the terms and privacy pages and finds fewer emails.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Defaults to no proxy. Use Apify Proxy if many stores answer with rate limits (HTTP 429) on large runs." } } }, "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 } } } } } } } } } }