API and MCP

Ask SpyWinAds right inside ChatGPT and Claude.

Let ChatGPT, Claude, Cursor or your own scripts look up Facebook video ads with SpyWinAds: how old an ad video really is, and every store running that same video.

https://spywinads.com/mcp
Read-only5 toolsFree plan: 30 calls a dayOAuth sign-in

Connect

ChatGPT

  1. Open Plugins in the left sidebar, click More at the top right, then choose Add custom MCP server.
  2. Paste https://spywinads.com/mcp.
  3. When a tool needs your account, ChatGPT asks you to sign in to SpyWinAds and click Allow.

Claude.ai / Claude Desktop

  1. Go to Customize → Connectors → Add custom connector.
  2. Paste https://spywinads.com/mcp, choose Sign in when needed.
  3. Sign in when Claude asks, then click Allow.

Claude Code · Cursor · VS Code

Claude Code: run the command, then type /mcp to sign in.

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

Cursor, VS Code, Windsurf, scripts: send an API key in a header:

{ "mcpServers": { "spywinads": {
  "url": "https://spywinads.com/mcp",
  "headers": { "Authorization": "Bearer YOUR_KEY" } } } }

Never put your key in a URL. You can revoke keys and remove connected apps at any time in SpyWinAds under Settings → API and MCP.

Ask your AI assistant

“Is this video ad new, or an old video being run again? https://www.facebook.com/ads/library/?id=…”
“Which Facebook video ads is example.com running, and how many other stores use the same videos?”
“Copy this Shopify product to a CSV file I can import into my store: https://store.com/products/…”

Tools

Read-only. 5 tools. Free plan: 30 calls per day. Scopes: ads:read to look up public ad data and product:export to create product CSV files. It never reads account data and never writes anything.

spywin_lookup_video_adInput

Meta Ad Library link or ad ID

Returns

The video's real age (the date the file was first uploaded to Facebook, accurate to within 1–2 days), the first ad, number of active ads, number of shops running and that have run the same video, and the earliest shops in the database

spywin_spy_store_adsInput

Store domain

Returns

Active ads, new ads in the last 7 days, number of videos, products, Pages, and top videos with their real age and shop count

spywin_get_page_adsInput

Facebook Page link or ID

Returns

Total and active ads, number of videos, top videos, and the stores the Page sends traffic to

spywin_export_shopify_productInput

Shopify product link

Returns

Title, price, variants, images, a download link for a Shopify import CSV file (kept for 24 hours), and the product's ad videos in the database. Requires product:export

spywin_get_video_reuse_researchInput

—

Returns

Key figures from the SpyWinAds Video Reuse Index report, with links to the methodology and data. No sign-in required

Get a free API key

For scripts and code editors (Cursor, VS Code). ChatGPT and Claude don't need a key: they sign in with your SpyWinAds account. Enter your email, and we'll send a confirmation link and show your key once.

Already have a SpyWinAds account? Create a key right in the app: Settings → API and MCP.

REST API

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://spywinads.com/api/v1/store?domain=example.com"

Endpoints: /api/v1/video?ad= · /api/v1/store?domain= · /api/v1/page?page= · /api/v1/product?url= · /api/v1/research/video-reuse. OpenAPI spec: /api/v1/openapi.json (works with GPT Actions and n8n).

Limits and data

  • Free plan: 30 calls per day (resets at 0:00 Vietnam time), up to 20 calls per minute. Trial accounts: 100 calls per day.
  • Data: Meta ads (Facebook, Instagram) shown in the US, from the SpyWinAds database. Counts are minimums, not sales. No ad spend, reach or revenue figures. “Earliest store” means earliest in our database, not the video's owner.
  • Each call returns exactly what the free web tools show; there is no search across the full database.
  • Not in the database yet? Results include a link to the web tool, where you can request a free scan.

Questions: support@spywinads.com · Privacy policy ›