# Ad Library through toolfare

> A company’s Google and LinkedIn ads by domain, ad creatives searched across social networks, and TikTok and Facebook ads with delivery and engagement data, plus advertiser rankings — asked from Claude, ChatGPT, Codex or Cursor. No ad-intelligence subscription or API key of your own: each call is quoted before it runs and paid from your toolfare balance.

Page: https://toolfare.ai/ad-library

## Use it from your agent

Paste this into Claude Code, Codex, Cursor or any agent with a shell:

> Set up https://toolfare.ai/skill.md, then use toolfare to show me the LinkedIn ads hubspot.com is running and summarise the offers and angles they use

Apps without a terminal connect toolfare as an MCP server: https://toolfare.ai/docs#connect

## Use it from a script

```sh
mkdir -p ~/.local/bin
curl -fsSL 'https://toolfare.ai/toolfare/toolfare.mjs' -o ~/.local/bin/toolfare
chmod +x ~/.local/bin/toolfare
export PATH="$HOME/.local/bin:$PATH"
export TOOLFARE_MCP_URL='https://api.toolfare.ai/mcp'
toolfare login
```

Sign in once per machine; the CLI renews the sign-in itself. On a CI runner or another server,
create an API key in the toolfare console and set it as `TOOLFARE_API_KEY` instead of signing in.
Paid calls on one sign-in or key run one at a time. `--max-cost` refuses a call quoted above
that many credits (1,000 credits = $3).

## Tools

### Find an advertiser by brand name

Tool: `ad_library_creatives_brands`

Find advertiser brands by name

Required parameters: query

Optional parameters: limit

Cost: From $0.075

Ask:
- Find the advertiser entry for Allbirds.
- Which brands match “Liquid Death” in the ad library?

### Search ad creatives across social networks

Tool: `ad_library_creatives_search`

Search ad creatives on social networks

Optional parameters: cursor, end_date, limit, live_status, media_type, order, platforms, query, start_date

Cost: From $0.075

Ask:
- Show me live video ads that mention “meal kit”.
- Which carousel ads about project management have been running longest?
- Find image ads from the last 30 days for “CRM for startups”.

### A company’s Google ads, by domain

Tool: `ad_library_google_ads`

A company's Google ads

Required parameters: company_domain

Optional parameters: cursor, media_type

Cost: From $0.027

Ask:
- What Google ads is notion.so running?
- Show me this competitor’s Google video ads.

### A company’s LinkedIn ads

Tool: `ad_library_linkedin_ads`

A company's LinkedIn ads

Optional parameters: company_domain, cursor, date_filter, linkedin_page_id

Cost: From $0.027

Ask:
- What LinkedIn ads is our main competitor running?
- Summarise the messaging in hubspot.com’s LinkedIn ads.

### TikTok and Facebook ads that are performing

Tool: `ad_library_performance_ads`

TikTok and Facebook ads with delivery and engagement data

Optional parameters: active, first_seen_after, first_seen_before, landing_domain, media_type, page, page_size, platform, regions, sort, sort_order

Cost: From $1.2

Ask:
- Which TikTok ads pointing to this domain got the most plays?
- Show me the longest-running Facebook video ads in the US that link to glossier.com.

### Who is advertising most, ranked

Tool: `ad_library_performance_advertisers`

Advertiser rankings with delivery statistics

Optional parameters: network, page, page_size, period, search, search_type, sort, sort_order

Cost: From $1.2

Ask:
- Which advertisers ran the most TikTok ads in the last 30 days for “protein powder”?
- Rank advertisers in pet food by plays this week.

### One advertiser’s profile and delivery stats

Tool: `ad_library_performance_advertisers_detail`

Advertiser profile with delivery statistics

Required parameters: id

Cost: From $1.2

Ask:
- Give me the delivery statistics for the top advertiser on that list.
- Pull the full profile of this advertiser from the ranking.
## Price

From $0.027 Quoted before each call; the final charge follows the returned usage. Pay per call from one balance.

Balances and top-ups are in US dollars. Quotes and `--max-cost` count credits: 1,000 credits = $3 ($0.003 each).

## Use it when

- You are planning a campaign and want to see what competitors are already running, and in which format.
- You want ad angles and offers that have kept running for a long time, a rough signal they work.
- You are researching a market on TikTok or Facebook and want to know who the biggest advertisers are.
- You are prospecting for an agency and want to see which brands are actively advertising.

## Look elsewhere when

- You want a modelled figure for a competitor’s monthly paid-search spend.
- You want the keywords a competitor ranks for organically.
- You want a brand’s organic Instagram posts rather than its ads.

## Limits

- Only ads the provider has collected from public sources; nothing from inside an advertiser’s account.
- Delivery and engagement figures come with the TikTok and Facebook tools and advertiser rankings; Google and LinkedIn lookups return the ads themselves.
- Results come back a page at a time; pass the cursor or page number to fetch more.
- Pay as you go from your toolfare balance, in US dollars; there is no subscription. A call runs when your balance covers its quote.