{
  "openapi": "3.0.1",
  "info": {
    "title": "Shopify Store Leads by App - Stores Using Klaviyo & More",
    "description": "Find Shopify stores by niche and by the apps they use or lack (uses Klaviyo, no loyalty app...) from our weekly-refreshed index of high-traffic stores, or audit your own list: 435+ apps, pixels, theme, catalog, app spend, gap scores, pitch reasons, emails, socials.",
    "version": "0.2",
    "x-build-id": "nZaEjVUIvW61SZLwd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/centorprat~shopify-store-leads-app-audit/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-centorprat-shopify-store-leads-app-audit",
        "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/centorprat~shopify-store-leads-app-audit/runs": {
      "post": {
        "operationId": "runs-sync-centorprat-shopify-store-leads-app-audit",
        "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/centorprat~shopify-store-leads-app-audit/run-sync": {
      "post": {
        "operationId": "run-sync-centorprat-shopify-store-leads-app-audit",
        "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": "🔍 Niche keywords",
            "type": "array",
            "description": "What the stores sell, e.g. [\"skincare\"], [\"dog treats\", \"cat toys\"], [\"yoga\"]. Matched instantly against our index of high-traffic Shopify stores (name, description, product types). Turn on Live Google search below to search Google instead.",
            "items": {
              "type": "string"
            }
          },
          "maxStoresPerKeyword": {
            "title": "💯 Max stores per keyword",
            "minimum": 1,
            "maximum": 300,
            "type": "integer",
            "description": "Up to this many stores per keyword (1-300), most-visited stores first.",
            "default": 20
          },
          "useApps": {
            "title": "✅ Stores that use these apps",
            "type": "array",
            "description": "Keep stores running ALL of these apps, e.g. [\"Klaviyo\"] or [\"Gorgias\", \"Recharge\"]. Any of the 435+ known app names (Shopify App Detector's list).",
            "items": {
              "type": "string"
            }
          },
          "withoutApps": {
            "title": "🚫 Stores that do NOT use these apps",
            "type": "array",
            "description": "Drop stores running any of these, e.g. [\"Yotpo\"] to find stores that could switch to your reviews app.",
            "items": {
              "type": "string"
            }
          },
          "missingCategories": {
            "title": "Missing app categories",
            "type": "array",
            "description": "Keep stores with NO app in these categories, e.g. no loyalty program, no reviews app.",
            "items": {
              "type": "string",
              "enum": [
                "reviews",
                "emailSms",
                "upsell",
                "loyalty",
                "support",
                "subscriptions",
                "search",
                "bnpl",
                "returns",
                "shipping",
                "analytics",
                "abTesting",
                "personalization",
                "pageBuilder",
                "consent",
                "accessibility",
                "affiliates",
                "ugcVideo",
                "productOptions",
                "preorder",
                "wishlist",
                "giftCards",
                "localization",
                "seo",
                "fraud",
                "forms",
                "quizzes",
                "channels",
                "b2b",
                "discounts",
                "storefrontUx"
              ],
              "enumTitles": [
                "Reviews & Q&A",
                "Email, SMS & pop-ups",
                "Upsell, bundles & cart",
                "Loyalty & referrals",
                "Help desk, chat & AI agents",
                "Subscriptions & memberships",
                "Search & merchandising",
                "BNPL & payment messaging",
                "Returns & exchanges",
                "Shipping, tracking & protection",
                "Analytics, attribution & server-side tracking",
                "A/B testing, heatmaps & CRO",
                "Personalization & recommendations",
                "Page builders & CMS",
                "Cookie consent & privacy",
                "Accessibility",
                "Affiliates, influencers & creators",
                "UGC, social feeds & shoppable video",
                "Product options, sizing & customizers",
                "Pre-order & back-in-stock",
                "Wishlists",
                "Gift cards, gifting & store credit",
                "Translation, currency & cross-border",
                "SEO, redirects & speed",
                "Fraud, bots & order limits",
                "Forms & customer fields",
                "Product quizzes",
                "Sales channels, feeds & mobile apps",
                "B2B & wholesale",
                "Discounts & promotions",
                "Storefront UX (menus, badges, timers, fonts)"
              ]
            }
          },
          "hasCategories": {
            "title": "Has app categories",
            "type": "array",
            "description": "Keep stores with at least one app in each of these categories, e.g. subscriptions.",
            "items": {
              "type": "string",
              "enum": [
                "reviews",
                "emailSms",
                "upsell",
                "loyalty",
                "support",
                "subscriptions",
                "search",
                "bnpl",
                "returns",
                "shipping",
                "analytics",
                "abTesting",
                "personalization",
                "pageBuilder",
                "consent",
                "accessibility",
                "affiliates",
                "ugcVideo",
                "productOptions",
                "preorder",
                "wishlist",
                "giftCards",
                "localization",
                "seo",
                "fraud",
                "forms",
                "quizzes",
                "channels",
                "b2b",
                "discounts",
                "storefrontUx"
              ],
              "enumTitles": [
                "Reviews & Q&A",
                "Email, SMS & pop-ups",
                "Upsell, bundles & cart",
                "Loyalty & referrals",
                "Help desk, chat & AI agents",
                "Subscriptions & memberships",
                "Search & merchandising",
                "BNPL & payment messaging",
                "Returns & exchanges",
                "Shipping, tracking & protection",
                "Analytics, attribution & server-side tracking",
                "A/B testing, heatmaps & CRO",
                "Personalization & recommendations",
                "Page builders & CMS",
                "Cookie consent & privacy",
                "Accessibility",
                "Affiliates, influencers & creators",
                "UGC, social feeds & shoppable video",
                "Product options, sizing & customizers",
                "Pre-order & back-in-stock",
                "Wishlists",
                "Gift cards, gifting & store credit",
                "Translation, currency & cross-border",
                "SEO, redirects & speed",
                "Fraud, bots & order limits",
                "Forms & customer fields",
                "Product quizzes",
                "Sales channels, feeds & mobile apps",
                "B2B & wholesale",
                "Discounts & promotions",
                "Storefront UX (menus, badges, timers, fonts)"
              ]
            }
          },
          "minEstimatedAppSpend": {
            "title": "Minimum estimated app spend (USD / month)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep stores whose installed apps add up to at least this much per month (public plan prices x store size). Bigger budgets = bigger buyers."
          },
          "sizeTiers": {
            "title": "Store size (catalog)",
            "type": "array",
            "description": "Keep stores of these catalog sizes.",
            "items": {
              "type": "string",
              "enum": [
                "micro",
                "small",
                "medium",
                "large"
              ],
              "enumTitles": [
                "Micro (<20 products)",
                "Small (20-199)",
                "Medium (200-999)",
                "Large (1000+)"
              ]
            }
          },
          "searchCountry": {
            "title": "🌍 Google search country",
            "type": "string",
            "description": "Two-letter country code for the live Google search, e.g. us, gb, ca, au, de, es.",
            "default": "us"
          },
          "liveSearch": {
            "title": "Live Google search instead of the index",
            "type": "boolean",
            "description": "Search Google for keyword stores (finds smaller/newer stores outside the index). Runs the Google Search Scraper, which bills its own result pages (~$0.0045 each) to your account.",
            "default": false
          },
          "refreshAudit": {
            "title": "Re-check index stores live",
            "type": "boolean",
            "description": "Re-read every store found in the index right now instead of using its last check (slower, same price).",
            "default": false
          },
          "category": {
            "title": "🎯 What do you sell to Shopify stores?",
            "enum": [
              "all",
              "reviews",
              "emailSms",
              "adsTracking",
              "upsell",
              "loyalty",
              "support",
              "subscriptions",
              "theme"
            ],
            "type": "string",
            "description": "Score and sort stores for one app category, or 'all' to use each store's best fit.",
            "default": "all"
          },
          "minScore": {
            "title": "Minimum opportunity score (0-100)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "A store is 'qualified' when its score for the chosen category is at least this AND it has a public email or social profile.",
            "default": 50
          },
          "onlyQualified": {
            "title": "Only return qualified stores",
            "type": "boolean",
            "description": "Drop stores below the minimum score or without contacts. Only returned stores are billed.",
            "default": false
          },
          "storeCountries": {
            "title": "Store countries (optional)",
            "type": "array",
            "description": "Keep only stores based in these countries (two-letter codes from the store's Shopify settings), e.g. [\"US\", \"CA\"].",
            "items": {
              "type": "string"
            }
          },
          "domains": {
            "title": "🔗 Store domains (optional)",
            "type": "array",
            "description": "Audit these stores directly, e.g. [\"allbirds.com\", \"gymshark.com\"]. No search cost. Non-Shopify sites are skipped for free.",
            "items": {
              "type": "string"
            }
          },
          "datasetId": {
            "title": "Dataset with store URLs (optional)",
            "type": "string",
            "description": "Pick (or paste the ID of) any dataset whose rows contain store URLs or domains (url, website, domain, link fields, or Google organicResults). Read-only access."
          },
          "maxItems": {
            "title": "Max rows to read from the dataset",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "Safety cap when reading a dataset.",
            "default": 2000
          },
          "language": {
            "title": "Google search language (optional)",
            "type": "string",
            "description": "Language code for the Google search, e.g. en, es, de."
          },
          "concurrency": {
            "title": "Parallel store audits",
            "minimum": 1,
            "maximum": 16,
            "type": "integer",
            "description": "How many stores are audited at once.",
            "default": 8
          },
          "webhookUrl": {
            "title": "Webhook URL (optional)",
            "type": "string",
            "description": "If set, qualified stores are POSTed here as JSON (Zapier / Make / n8n / your CRM)."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}