{
"openapi": "3.0.1",
"info": {
"title": "Shopify Store Finder - Find Stores By Country, Industry & Rank",
"description": "Find Shopify stores by country, ranking, industry or tech stack from millions of shopify stores, then verify each store live and add revenue estimates, catalogue size, apps, ad pixels, emails and social profiles. Lead lists for agencies, SaaS and researchers. CSV, Excel or JSON.",
"version": "1.0",
"x-build-id": "ulijrAQ2hF8kUdoiY"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zaver.api~shopify-store-finder/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zaver.api-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/zaver.api~shopify-store-finder/runs": {
"post": {
"operationId": "runs-sync-zaver.api-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/zaver.api~shopify-store-finder/run-sync": {
"post": {
"operationId": "run-sync-zaver.api-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": {
"countries": {
"title": "Countries",
"type": "array",
"description": "Two-letter country codes, one per line (US, IN, GB, DE). Leave empty to search all 6.6 million stores worldwide, which takes about a minute longer to load.",
"items": {
"type": "string"
}
},
"sortBy": {
"title": "Sort by",
"enum": [
"rank",
"revenue",
"newest",
"catalog"
],
"type": "string",
"description": "Order of results. rank = most visited first (global traffic rank), revenue = highest seed revenue estimate first, newest = most recently detected stores first, catalog = most products first.",
"default": "rank"
},
"maxStores": {
"title": "Max stores",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "How many stores to return.",
"default": 100
},
"skip": {
"title": "Skip",
"minimum": 0,
"maximum": 1000000000,
"type": "integer",
"description": "Skip this many stores first. Use it to page through a large list across runs: 0, then 1000, then 2000.",
"default": 0
},
"verticals": {
"title": "Industries",
"type": "array",
"description": "Optional. Keep stores whose industry contains any of these words: Fashion, Beauty, Food, Sports, Health, Home, Technology, Pets.",
"items": {
"type": "string"
}
},
"techKeywords": {
"title": "Tech stack keywords",
"type": "array",
"description": "Optional. Keep stores whose known stack mentions any of these: Klaviyo, Shopify Plus, Klarna, PayPal, Hubspot, Gorgias.",
"items": {
"type": "string"
}
},
"onlyShopifyPlus": {
"title": "Only Shopify Plus stores",
"type": "boolean",
"description": "Keep only stores detected on Shopify Plus.",
"default": false
},
"onlyRanked": {
"title": "Only stores with a traffic rank",
"type": "boolean",
"description": "Keep only stores that have a global traffic rank, which usually means real visitor traffic.",
"default": false
},
"maxRank": {
"title": "Best traffic rank cut-off",
"minimum": 0,
"maximum": 1000000000000,
"type": "integer",
"description": "Optional. Keep only stores ranked better than this global rank, for example 1000000 for the top million websites. 0 means no cut-off.",
"default": 0
},
"minRevenueSeed": {
"title": "Minimum revenue estimate (seed, USD per year)",
"minimum": 0,
"maximum": 1000000000000,
"type": "integer",
"description": "Optional. Keep only stores whose seed revenue estimate is at least this. 0 means no minimum.",
"default": 0
},
"minProducts": {
"title": "Minimum products (seed)",
"minimum": 0,
"maximum": 1000000000,
"type": "integer",
"description": "Optional. Keep only stores with at least this many products in the index. 0 means no minimum.",
"default": 0
},
"onlyWithSeedEmail": {
"title": "Only stores with a known email in the index",
"type": "boolean",
"description": "Keep only stores that already have an email address in the index. Turn on 'Find emails and social profiles' to look up the rest live.",
"default": false
},
"detectedAfter": {
"title": "New stores since",
"type": "string",
"description": "Optional. Only stores first detected on or after this date (2026-06-01). Use it for lists of new Shopify stores."
},
"domains": {
"title": "Specific domains",
"type": "array",
"description": "Optional. Look up these store domains instead of searching: one per line. Rows tell you whether each domain is in the index.",
"items": {
"type": "string"
}
},
"verifyStores": {
"title": "Verify stores live",
"type": "boolean",
"description": "Open each store and confirm it is a live Shopify store. Adds store name, real country and currency, product count, price range, newest product date, brands sold and collection count. Charged per live store.",
"default": false
},
"estimateRevenue": {
"title": "Estimate revenue",
"type": "boolean",
"description": "Estimate monthly and annual revenue in USD from traffic rank, catalogue size, price level and activity, with a tier and confidence. Needs the live store data and is charged per estimate produced.",
"default": false
},
"detectTech": {
"title": "Detect apps and ad pixels",
"type": "boolean",
"description": "Detect the theme, installed apps by category (email marketing, reviews, chat, subscriptions, loyalty, buy-now-pay-later), analytics and ad pixels, markets, and which categories are missing. Charged per store where something was detected.",
"default": false
},
"findContacts": {
"title": "Find emails and social profiles",
"type": "boolean",
"description": "Scan the store's website for email addresses, phone numbers and Facebook, Instagram, LinkedIn, X, YouTube, TikTok and WhatsApp links. Charged only when an email address is found.",
"default": 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
}
}
}
}
}
}
}
}
}
}