Skip to content

Adspy.sh · Add a brand to the ad library

Adspy.sh

Add a brand from its Meta Ad Library page URL (view_all_page_id) or Google Ads Transparency advertiser URL (AR…): Adspy.sh collects its ads, then analyses, tags and transcribes them. Returns a jobId at once: poll adspy/get-fetch-job until isTerminal, then read the ads with adspy/search-creatives and the returned brandKey. A brand already in the library or already being fetched costs nothing. Take the URL and name from adspy/search-advertisers. Agentik price: $0.002 per Adspy credit, billed exactly from the credits Adspy settles for this call (1 per creative, +3 for analysis, 60 per X-Ray, 400 per new brand fetch); creatives this workspace retrieved in the last 30 days, X-Rays from the last 24 hours, reused fetches and missing items cost nothing. At most $0.8; reserved before the call, the unused part refunded.

Usage based Adspy.shAdvertisingadspy/request-brand-fetch

Use this tool with your agent

Give this to your agent
Use my connected Agentik MCP server. I want to use the tool adspy/request-brand-fetch (Adspy.sh: Add a brand to the ad library). Call inspect_tool with {"tool_id": "adspy/request-brand-fetch"} first and tell me the price before anything runs. Ask me for the inputs it needs; never invent values, IDs or file URLs. When I confirm, call run_tool with tool_id "adspy/request-brand-fetch" and my inputs, follow it with get_run if it is still running, and give me the result and the price Agentik reports. If it cannot run right now, use discover_tools to propose a similar tool.
Show the prompt

Paste it into Claude, ChatGPT or Codex: your agent takes it from there, and shows the price before it runs.

Parameters

NameTypeRequiredDescription
urlstringYes
namestringYes
resultCapintegerNoSuggested page size for later creative retrieval, not an ingestion limit. Fetching costs a flat 400 credits.

How your agent calls it

First inspect_tool for the current schema and price, then run_tool with the published example after confirming your inputs:

{
  "tool_id": "adspy/request-brand-fetch",
  "input": {
    "url": "https://www.facebook.com/ads/library/?view_all_page_id=183869772601",
    "name": "AG1 by Athletic Greens"
  }
}

Price and billing

Price
Usage based
Model
Usage based
Detail
Billed at the cost the provider reports for the call, never above $0.8. Your agent sees the maximum before running.
Attribution
Ad research by Adspy.sh (adspy.sh), from public ad libraries.
  • The provider’s price, 0% markup.
  • One prepaid balance for every provider; your agent sees the price before it runs.
  • Pay for measured usage; unused reservations are released.