{
  "openapi": "3.0.1",
  "info": {
    "title": "WooCommerce Store Leads Scraper — 1M+ Stores, Emails & Tech",
    "description": "Find active WooCommerce leads across 1M+ indexed stores in 140+ countries with DNS MX-checked emails, phones, socials, live SKU counts, USD prices & product titles. Filter by catalog size & 64 installed/missing plugins (Klaviyo, Meta Pixel, Judge.me) — pay-as-you-go at $4.50/1k.",
    "version": "0.1",
    "x-build-id": "Ka4ccWtZzdrk1xLsT"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/ordesign~woocommerce-store-leads/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-ordesign-woocommerce-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/ordesign~woocommerce-store-leads/runs": {
      "post": {
        "operationId": "runs-sync-ordesign-woocommerce-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/ordesign~woocommerce-store-leads/run-sync": {
      "post": {
        "operationId": "run-sync-ordesign-woocommerce-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",
        "properties": {
          "country": {
            "title": "Country Code (ISO-3166 Alpha-2)",
            "type": "string",
            "description": "Two-letter country code filter (e.g. US, GB, DE, AU, CA). Leave empty for all countries."
          },
          "installedTech": {
            "title": "Installed Technologies (MUST Have)",
            "type": "array",
            "description": "Plugins or pixels from the 64-plugin catalog that MUST be installed (case-insensitive, with 'Did you mean?' typo suggestions). Supported 64 slugs — Email/SMS/Popups: klaviyo, mailchimp, omnisend, attentive, postscript, drip, activecampaign, brevo, convertkit, privy, justuno, optinmonster | Reviews: judge-me, yotpo, stamped, loox, trustpilot, okendo | Support: gorgias, tidio, zendesk, intercom, livechat, crisp, tawk-to | Subscriptions/Funnels: woocommerce-subscriptions, recharge, bold-subscriptions, cartflows, funnelkit | Payments/BNPL: stripe, paypal, klarna, afterpay, affirm, square, adyen, mollie, razorpay, sezzle, splitit, amazon-pay | Pixels/Analytics: google-analytics, meta-pixel, tiktok-pixel, pinterest-tag, snapchat-pixel, reddit-pixel, linkedin-insight, bing-ads, triple-whale, hotjar, microsoft-clarity | SEO/Speed/Infra: yoast, rank-math, all-in-one-seo, wpml, weglot, wp-rocket, nitropack, cloudflare, elementor, shipstation, hubspot.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "missingTech": {
            "title": "Missing Technologies (MUST NOT Have)",
            "type": "array",
            "description": "Plugins or pixels from the 64-plugin catalog that MUST NOT be installed on the store, verified live across storefront HTML and Google Tag Manager (case-insensitive, with 'Did you mean?' typo suggestions). Supported 64 slugs — Email/SMS/Popups: klaviyo, mailchimp, omnisend, attentive, postscript, drip, activecampaign, brevo, convertkit, privy, justuno, optinmonster | Reviews: judge-me, yotpo, stamped, loox, trustpilot, okendo | Support: gorgias, tidio, zendesk, intercom, livechat, crisp, tawk-to | Subscriptions/Funnels: woocommerce-subscriptions, recharge, bold-subscriptions, cartflows, funnelkit | Payments/BNPL: stripe, paypal, klarna, afterpay, affirm, square, adyen, mollie, razorpay, sezzle, splitit, amazon-pay | Pixels/Analytics: google-analytics, meta-pixel, tiktok-pixel, pinterest-tag, snapchat-pixel, reddit-pixel, linkedin-insight, bing-ads, triple-whale, hotjar, microsoft-clarity | SEO/Speed/Infra: yoast, rank-math, all-in-one-seo, wpml, weglot, wp-rocket, nitropack, cloudflare, elementor, shipstation, hubspot.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Niche / Domain Keywords",
            "type": "array",
            "description": "Optional keywords matched against domain name and store niche tokens (e.g. coffee, skincare, supplements).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxLeads": {
            "title": "Max Qualified Leads",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum number of DNS MX-checked store leads to produce (Free-plan runs are capped at 25 sample leads).",
            "default": 100
          },
          "countOnly": {
            "title": "Count Only (Free Match Preview)",
            "type": "boolean",
            "description": "When enabled, queries the 1M+ store index and returns total matching stores, sample domains, market-sizing facets (top_countries, top_themes, has_wc_api_count), and all 64 available_tech_slugs with $0 in lead fees.",
            "default": false
          },
          "minSkus": {
            "title": "Minimum Product SKU Count",
            "minimum": 1,
            "type": "integer",
            "description": "Optional minimum catalog size (sku_count from the WooCommerce Store API). Stores with fewer SKUs are skipped at $0 in lead fees."
          },
          "minPriceMaxUsd": {
            "title": "Minimum Highest Product Price in USD (minPriceMaxUsd)",
            "minimum": 1,
            "type": "integer",
            "description": "Optional minimum threshold for a store's highest product price (price_max) converted to USD across 150+ ISO-4217 currencies. Keeps stores whose price_max_usd >= X ($0 in lead fees if below threshold)."
          },
          "minPriceMedianUsd": {
            "title": "Minimum Median Product Price in USD (minPriceMedianUsd)",
            "minimum": 1,
            "type": "integer",
            "description": "Optional minimum threshold for a store's typical product price (price_median across canonical per-SKU prices) converted to USD across 150+ ISO-4217 currencies. Ideal for AOV/catalog qualification without single high-ticket outlier distortion ($0 in lead fees if below threshold)."
          },
          "emailTypes": {
            "title": "Allowed Email Types (role / personal)",
            "uniqueItems": true,
            "type": "array",
            "description": "Optional filter for contact email classification: select 'role' for corporate role inboxes only (info@, sales@, wholesale@, etc. — ideal for GDPR / ePrivacy minimization), 'personal' for named individual inboxes only, or leave empty / select both for all DNS MX-checked merchant emails.",
            "items": {
              "type": "string",
              "enum": [
                "role",
                "personal"
              ],
              "enumTitles": [
                "Role Inboxes (info@, sales@, wholesale@)",
                "Personal / Named Inboxes (founder@, alex@)"
              ]
            },
            "default": []
          },
          "preferPersonalEmails": {
            "title": "Prefer Personal / Founder Emails First",
            "type": "boolean",
            "description": "When enabled, ranks DNS MX-checked first-party personal/founder emails (e.g. jane@brand.com) ahead of role inboxes for primary_email while falling back to role inboxes when no personal email exists. Named individual emails are personal data under GDPR/UK GDPR — review local rules before enabling in EU/UK campaigns.",
            "default": false
          },
          "theme": {
            "title": "WooCommerce / WP Theme Slug",
            "type": "string",
            "description": "Optional theme filter (e.g. flatsome, astra, woodmart, divi, hello-elementor, storefront)."
          },
          "hasWcApi": {
            "title": "Require Public WooCommerce Store API",
            "type": "boolean",
            "description": "When enabled, filters for stores exposing the public /wp-json/wc/store/v1/products catalog endpoint (SKU count & price range)."
          },
          "onlyNewLeads": {
            "title": "Only New Leads (Cross-Run Deduplication)",
            "type": "boolean",
            "description": "When enabled on a paid Apify plan, automatically skips domains already delivered in previous runs using persistent history stored in your 'ecommerce-leads-seen' Key-Value Store (skipped on Free-plan sample runs). Ideal for scheduled weekly n8n/Make/Clay pipelines.",
            "default": false
          },
          "dedupScope": {
            "title": "Deduplication Scope / Campaign ID (Optional)",
            "type": "string",
            "description": "Optional campaign or client ID for onlyNewLeads (e.g. 'agency-client-a' or 'klaviyo-us-q4') so each client or campaign keeps separate deduplication history inside 'ecommerce-leads-seen'."
          },
          "domains": {
            "title": "Bring Your Own Domains (Optional Direct Enrichment)",
            "type": "array",
            "description": "Optional list of specific WooCommerce store domains or URLs to enrich live (e.g. ['acme-coffee-demo.com', 'alpine-skincare-demo.com']; Free-plan sample runs enrich up to 10 domains). When provided, CartPulse enriches these exact domains instead of querying the pre-indexed database.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "excludeDomains": {
            "title": "Exclude Domains (Suppression List)",
            "type": "array",
            "description": "Optional list of domains or URLs to exclude from results before live scraping on paid Apify plans (e.g. existing clients, competitors, or suppression lists) without modifying your persistent onlyNewLeads history.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxCruxBucket": {
            "title": "Traffic Tier (Max CrUX Rank)",
            "minimum": 1000,
            "maximum": 10000000,
            "type": "integer",
            "description": "Optional popularity ceiling from Google Chrome UX Report: 1000 = major global brands, 10000 = large retailers, 100000 = established DTC brands, 1000000 = growing SMB stores, 10000000 = all indexed stores."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}