Developers

Ad signals in your AI tools and code

Ask Claude, ChatGPT or Cursor which brands just started running Meta ads, or pull the same rows into your own pipeline with the REST API.

MCP serverREST API

MCP server

A remote MCP server that gives AI assistants four tools: the daily signal feed, brand lookup, store check and the niche list. It works without an account (brand names are masked); sign in to get what your plan includes.

https://advertiserleads.com/mcp

Claude

In claude.ai or the desktop app: Settings → Connectors → Add custom connector, paste the URL above, then sign in with your AdvertiserLeads email when asked.

ChatGPT

With developer mode on, add a connector with the URL above and OAuth authentication, then sign in when asked.

Claude Code

claude mcp add --transport http advertiserleads https://advertiserleads.com/mcp

Run /mcp in Claude Code to sign in.

Cursor, VS Code, Windsurf

{
  "url": "https://advertiserleads.com/mcp",
  "headers": { "Authorization": "Bearer al_your_key" }
}

VS Code also wants "type": "http". Create the key in Settings.

Tools

ToolInputReturns
search_signalsThe same parameters as the API belowBrands flagged on the latest day as newly advertising, scaling, struggling or stopped, with store platform, live ads and other ad channels.
lookup_branddomainWhether a store runs Meta ads: advertising since, live ads, trend, channels and store. Signed in: catalog, price range, launches and store age; Pro and up add recent ads.
check_storedomainStore platform, catalog size, price range, store age, and the tracking pixels and marketing tools on its homepage.
list_nichesnoneThe niches we track, signal types, filter values, and what your plan includes.

Access and limits

  • Without signing in: masked brands in every niche, no filters, at most 50 rows; 3 new brand lookups and 10 store checks a day.
  • Free account: masked brands in your niche (except ones you revealed), 5 new lookups and 50 store checks a day.
  • Paid plans: every brand unmasked with filters. Each brand returned counts toward your monthly export rows, like the CSV export; the same brand again that month is free.
  • 600 tool calls an hour per account, 60 an hour per IP without signing in.

REST API

One JSON endpoint with the same rows as the CSV export. It's on the Agency and Data plans; create a key in Settings, and it's shown once.

GET https://advertiserleads.com/api/v1/signals 
curl -H "Authorization: Bearer al_your_key" \
  "https://advertiserleads.com/api/v1/signals?niche=auto_aftermarket&signal=newly_advertising&limit=50"

Parameters

ParameterMeaning
nicheOne niche id (see list_niches); every niche on your plan when left out.
signalnewly_advertising, scaling, struggling, stopped. New and scaling brands when left out.
min_adsAt least this many live Meta ads.
platformshopify, woocommerce, bigcommerce, other_store.
pixelAlso advertises on this channel: google_ads, tiktok, pinterest, snapchat, reddit, bing.
qBrand name or domain contains this text.
limitRows to return, 1 to 500. Default 100 on the API, 25 on the MCP server.
offsetRows to skip, for paging.

All parameters are optional. A niche outside your plan falls back to every niche you have.

Response

{
  "date": "2026-11-01",
  "total": 214,
  "offset": 0,
  "rows": [ { "brand": "…", "domain": "…", "signal": "newly_advertising", … } ],
  "withheld": 0,
  "rows_left_this_month": 9786
}

Each row has: date, first_flagged, niche, signal, score, brand, domain, store_url, store_platform, product_count, price_range, active_ads, what_changed, first_ad_days_ago, launches_7d, channels, history_check, evidence, ad_library_url, page_id.

  • Rows count toward your monthly export rows, shared with the CSV export. Rows past the limit are left out and counted in withheld.
  • Errors are JSON with an error message: 401 for a missing or invalid key, 403 on plans without the API, 429 past 600 requests an hour.

Need a custom feed?

Lenders, SaaS and 3PLs can get custom feeds and higher limits on the Data plan, from $750/month.

Talk to usSee plans