{ "openapi": "3.0.1", "info": { "title": "Shopify Store Finder: Leads by Keyword with Emails & Ratings", "description": "Find Shopify stores by keyword: business emails, phones and address, Shop app rating, sample products, installed apps, ad pixel IDs and social profiles. Filter by rating, price, store country or contacts. Skip stores from earlier runs. No login.", "version": "0.1", "x-build-id": "LWHPLz2HBtqeWFDkx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/andracore~shopify-store-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-andracore-shopify-store-finder", "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/andracore~shopify-store-finder/runs": { "post": { "operationId": "runs-sync-andracore-shopify-store-finder", "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/andracore~shopify-store-finder/run-sync": { "post": { "operationId": "run-sync-andracore-shopify-store-finder", "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": { "keywords": { "title": "Keywords", "type": "array", "description": "What the stores sell, one keyword per line. Example: yoga mat, organic coffee, dog harness.", "items": { "type": "string" } }, "shipsTo": { "title": "Stores that ship to", "enum": [ "US", "CA", "GB", "AU", "NZ", "IE", "DE", "FR", "ES", "IT", "NL", "BE", "AT", "CH", "SE", "DK", "NO", "FI", "PL", "PT", "JP", "SG", "HK", "AE", "MX", "BR" ], "type": "string", "description": "Only stores that deliver to this country. Prices come in that country's currency.", "default": "US" }, "maxStoresPerKeyword": { "title": "Max stores per keyword", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many stores to return for each keyword.", "default": 50 }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only stores whose products average at least this rating on the Shop app (0 to 5).", "default": 0 }, "minReviews": { "title": "Minimum number of ratings", "minimum": 0, "type": "integer", "description": "Only stores with at least this many product ratings on the Shop app.", "default": 0 }, "enrichStores": { "title": "Add contacts, apps and pixels", "type": "boolean", "description": "Visits each store to add its business email and phone, country, currency, product count, theme, installed apps, ad pixel IDs and social profiles. Included in the price.", "default": true }, "onlyWithContacts": { "title": "Only stores with an email or phone", "type": "boolean", "description": "Skip stores that publish no business email or phone. You only pay for the stores returned.", "default": false }, "minPrice": { "title": "Products from (price)", "minimum": 0, "type": "integer", "description": "Only stores selling matching products at or above this price, in the shipping country's currency." }, "maxPrice": { "title": "Products up to (price)", "minimum": 0, "type": "integer", "description": "Only stores selling matching products at or below this price." }, "storeCountries": { "title": "Store based in", "type": "array", "description": "Only stores based in these countries. Leave empty for any country.", "items": { "type": "string", "enum": [ "US", "CA", "GB", "AU", "NZ", "IE", "DE", "FR", "ES", "IT", "NL", "BE", "AT", "CH", "SE", "DK", "NO", "FI", "PL", "PT", "JP", "SG", "HK", "AE", "MX", "BR" ], "enumTitles": [ "United States", "Canada", "United Kingdom", "Australia", "New Zealand", "Ireland", "Germany", "France", "Spain", "Italy", "Netherlands", "Belgium", "Austria", "Switzerland", "Sweden", "Denmark", "Norway", "Finland", "Poland", "Portugal", "Japan", "Singapore", "Hong Kong", "United Arab Emirates", "Mexico", "Brazil" ] } }, "onlyNewStores": { "title": "Only new stores (skip earlier runs)", "type": "boolean", "description": "Remembers the stores returned in earlier runs and never returns them again. Use it to build a lead list week after week without paying twice for the same store.", "default": false }, "monitorName": { "title": "List name", "type": "string", "description": "Use a different name for each lead list or client so their histories stay separate.", "default": "default" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Usually not needed. If a site blocks the run, the Actor switches to Apify Proxy on its own.", "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 }, "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 } } } } } } } } } }