AdvertiserLeads

US ecommerce brands flagged on the latest day for a change in their Meta (Facebook/Instagram) ads: newly advertising, scaling, struggling or stopped, with store platform, live ad count and other ad channels. Defaults to new and scaling brands in every niche the caller's plan covers. Without signing in or on the free plan, brand names and domains are masked and only the niche filter applies. On paid plans each brand returned counts toward the account's monthly export rows (the same brand again that month is free).

{
  "type": "object",
  "properties": {
    "niche": {
      "type": "string",
      "enum": [
        "auto_aftermarket",
        "supplements",
        "skincare",
        "pet",
        "home_kitchen"
      ],
      "description": "One niche; all of the caller's niches when left out."
    },
    "signal": {
      "type": "string",
      "enum": [
        "newly_advertising",
        "scaling",
        "struggling",
        "stopped"
      ],
      "description": "One signal type; newly_advertising and scaling when left out. Paid plans only."
    },
    "min_ads": {
      "type": "integer",
      "minimum": 1,
      "description": "At least this many live ads. Paid plans only."
    },
    "platform": {
      "type": "string",
      "enum": [
        "shopify",
        "woocommerce",
        "bigcommerce",
        "other_store"
      ],
      "description": "Store platform. Paid plans only."
    },
    "pixel": {
      "type": "string",
      "enum": [
        "google_ads",
        "tiktok",
        "pinterest",
        "snapchat",
        "reddit",
        "bing"
      ],
      "description": "Also advertises on this channel (tracking pixel on the store). Paid plans only."
    },
    "q": {
      "type": "string",
      "description": "Brand name or domain contains this text. Paid plans only."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "description": "Rows to return, default 25. Masked results return at most 50."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Rows to skip, for paging."
    }
  }
}

Is this store running Meta ads? Finds the Facebook page behind a store domain and returns advertising since, live ads, trend (new, scaling, stable, stopped), channels and store platform. Signed in: catalog size, price range, recent launches and store age (free plan: 5 new domains a day); Pro and up also get recent ads. Unknown domains are checked live in the Meta Ad Library, within a daily limit.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The store's domain, e.g. brand.com. A URL works too."
    }
  },
  "required": [
    "domain"
  ]
}

Store platform (Shopify, WooCommerce, BigCommerce, other store or not a store), catalog size, price range and store age for a domain, plus the tracking pixels and marketing tools on its homepage (Meta, Google Ads, TikTok, Pinterest, Klaviyo, Triple Whale and more). Results under a day old are reused; fresh checks are limited per day (10 without signing in, 50 signed in).

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The store's domain, e.g. brand.com. A URL works too."
    }
  },
  "required": [
    "domain"
  ]
}

The niches AdvertiserLeads tracks, the signal types and filter values search_signals accepts, and what the caller's plan includes.

{
  "type": "object",
  "properties": {}
}