---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/ad-library-search
---
# Ad Library Search

Browse the public ad libraries of Facebook, Google, LinkedIn, and Reddit. Search by keyword or company name to surface active creatives, impression data, and ad copy. Built for marketers and strategists tracking competitive messaging.

- **Version:** 0.02
- **Categories:** marketing, analytics

## Skills (11)

### Search Facebook Ads (`search_facebook_ads`)

Search the Facebook (Meta) Ad Library by keyword. Filter by country, status, media type, date range, and more. Returns up to ~1,500 results with pagination.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Keyword to search for in ads |
| `country` | string | No | Two-letter country code to filter by (e.g. "US", "GB"). Defaults to ALL |
| `status` | string | No | Ad status filter. Defaults to ACTIVE (ALL, ACTIVE, INACTIVE) |
| `media_type` | string | No | Media type filter. Defaults to ALL (ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE) |
| `sort_by` | string | No | Sort by impressions or most recent. Defaults to impressions (total_impressions, relevancy_monthly_grouped) |
| `search_type` | string | No | Search by keyword or exact phrase (keyword_unordered, keyword_exact_phrase) |
| `ad_type` | string | No | Filter for political/issue ads or all ads (all, political_and_issue_ads) |
| `start_date` | string | No | Impressions start date in YYYY-MM-DD format |
| `end_date` | string | No | Impressions end date in YYYY-MM-DD format |
| `cursor` | string | No | Pagination cursor from previous response |
| `trim` | boolean | No | Set to true for a trimmed response |

**Returns:** List of Facebook ads with ad content, impressions data, media assets, and advertiser information

**Examples:**

*Search Facebook ads by keyword:*

```json
{
  "query": "running shoes"
}
```

*Search active video ads in the US:*

```json
{
  "query": "fitness app",
  "country": "US",
  "status": "ACTIVE",
  "media_type": "VIDEO"
}
```

### Search Facebook Ad Companies (`search_facebook_ad_companies`)

Search for companies in the Facebook Ad Library by name. Returns company names and their ad library page IDs, which can be used with get_facebook_company_ads.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Company name to search for |

**Returns:** List of companies with their names and ad library page IDs

**Examples:**

*Find a company in the Facebook Ad Library:*

```json
{
  "query": "Nike"
}
```

### Get Facebook Company Ads (`get_facebook_company_ads`)

Get all ads a company is running on Facebook/Meta. Search by company name or page ID. Filter by country, status, media type, language, and date range.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `company_name` | string | No | Company name to get ads for |
| `page_id` | string | No | Ad library page ID (from search_facebook_ad_companies). Use this or company_name |
| `country` | string | No | Two-letter country code (e.g. "US"). Defaults to ALL |
| `status` | string | No | Ad status filter. Defaults to ACTIVE (ALL, ACTIVE, INACTIVE) |
| `media_type` | string | No | Media type filter. Defaults to ALL (ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE) |
| `language` | string | No | Two-letter language code to filter by (e.g. "EN", "ES") |
| `sort_by` | string | No | Sort by impressions or most recent (total_impressions, relevancy_monthly_grouped) |
| `start_date` | string | No | Start date in YYYY-MM-DD format |
| `end_date` | string | No | End date in YYYY-MM-DD format |
| `cursor` | string | No | Pagination cursor from previous response |
| `trim` | boolean | No | Set to true for a trimmed response |

**Returns:** List of ads the company is running with ad content, impressions, media, and targeting data

**Examples:**

*Get all Nike ads on Facebook:*

```json
{
  "company_name": "Nike"
}
```

*Get active video ads by page ID:*

```json
{
  "page_id": "123456789",
  "status": "ACTIVE",
  "media_type": "VIDEO"
}
```

### Get Facebook Ad Details (`get_facebook_ad`)

Get full details of a specific Facebook ad by ID or URL. Includes ad copy, media, cards, and optional video transcript (for videos under 2 minutes).

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `id` | string | No | Facebook Ad ID |
| `url` | string | No | Facebook Ad URL. Use this or id |
| `get_transcript` | boolean | No | Get video transcript (only for videos under 2 minutes) |
| `trim` | boolean | No | Set to true for a trimmed response |

**Returns:** Full ad details including ad copy, media assets, cards, advertiser info, and optional transcript

**Examples:**

*Get a Facebook ad by ID:*

```json
{
  "id": "123456789"
}
```

### Search Google Advertisers (`search_google_advertisers`)

Search the Google Ad Transparency Library for advertisers by name. Returns advertiser IDs that can be used with get_google_company_ads.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Advertiser name to search for |

**Returns:** List of advertisers with their names and advertiser IDs

**Examples:**

*Search for an advertiser on Google:*

```json
{
  "query": "Shopify"
}
```

### Get Google Company Ads (`get_google_company_ads`)

Get ads a company is running on Google. Search by domain or advertiser ID. Filter by topic, region, and date range. Only public ads are available.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `domain` | string | No | Company domain (e.g. "shopify.com") |
| `advertiser_id` | string | No | Google advertiser ID (from search_google_advertisers). Use this or domain |
| `topic` | string | No | Filter by topic. Political ads also require a region (all, political) |
| `region` | string | No | Two-letter region code (e.g. "US"). Required for political topic |
| `start_date` | string | No | Start date in YYYY-MM-DD format |
| `end_date` | string | No | End date in YYYY-MM-DD format |
| `get_ad_details` | boolean | No | Set to true to get full ad details (costs 25 credits per ad instead of 1) |
| `cursor` | string | No | Pagination cursor from previous response |

**Returns:** List of Google ads with advertiser and creative IDs, and optionally full ad details with OCR text

**Examples:**

*Get ads by domain:*

```json
{
  "domain": "shopify.com"
}
```

*Get ads with full details by advertiser ID:*

```json
{
  "advertiser_id": "AR17804957702832168961",
  "get_ad_details": true
}
```

### Get Google Ad Details (`get_google_ad`)

Get details of a specific Google ad by its Ad Transparency URL. The URL must include both advertiser and creative IDs. Uses OCR to extract ad text.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Google Ad Transparency URL (must contain advertiser and creative IDs, e.g. https://adstransparency.google.com/advertiser/AR.../creative/CR...) |

**Returns:** Ad details including OCR-extracted text, media type, and advertiser information

**Examples:**

*Get a specific Google ad:*

```json
{
  "url": "https://adstransparency.google.com/advertiser/AR17804957702832168961/creative/CR04185088030974935041"
}
```

### Search LinkedIn Ads (`search_linkedin_ads`)

Search the LinkedIn ad library by company name, keyword, or company ID. At least one parameter is required.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `company` | string | No | Company name to search for ads (e.g. "Salesforce") |
| `keyword` | string | No | Keyword to search for in ad content |
| `company_id` | string | No | LinkedIn company ID to filter ads by |

**Returns:** List of LinkedIn advertisements with ad content, sponsor details, and campaign metadata

**Examples:**

*Search LinkedIn ads by company name:*

```json
{
  "company": "Salesforce"
}
```

### Get LinkedIn Ad Details (`get_linkedin_ad`)

Get full details of a specific LinkedIn advertisement by URL. Returns ad copy, media, sponsor information, and engagement data.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the LinkedIn advertisement |

**Returns:** LinkedIn ad details including ad copy, media assets, sponsor info, and engagement metrics

**Examples:**

*Get details of a LinkedIn ad:*

```json
{
  "url": "https://www.linkedin.com/ad/library/123456789"
}
```

### Search Reddit Ads (`search_reddit_ads`)

Search Reddit for promoted and sponsored posts matching a query. Returns ad content, targeting info, and engagement metrics.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search query to find Reddit advertisements |

**Returns:** List of Reddit sponsored posts with ad content, subreddit targeting, and engagement data

**Examples:**

*Search for Reddit ads about a product category:*

```json
{
  "query": "project management software"
}
```

### Get Reddit Ad (`get_reddit_ad`)

Get full details of a specific Reddit advertisement by URL, including ad copy, media, targeting, and engagement metrics.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `url` | string | Yes | Full URL of the Reddit advertisement post |

**Returns:** Reddit ad details including ad copy, media assets, advertiser info, and engagement metrics

**Examples:**

*Get details of a specific Reddit ad:*

```json
{
  "url": "https://www.reddit.com/user/ExampleBrand/comments/abc123/try_our_new_product/"
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call ad-library-search search_facebook_ads --query running shoes

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"ad-library-search","skill":"search_facebook_ads","input":{"query":"running shoes"}}' \
     https://api.toolrouter.com/v1/tools/call
```

## Frequently Asked Questions

### How do I find a company’s ads on Facebook or Meta?

Start by searching the company name to get its ad library page ID, then use that ID to pull the running ads and filter them by country, status, media type, or date range.

### Can I see only active ads?

Yes. Set the status filter to `ACTIVE` when you want the ads that are still running instead of the full historical library.

### Can I inspect the full creative for a single ad?

Yes. The ad detail lookup returns the ad copy, media, cards, and, for short videos, an optional transcript so you can see the creative without guessing from the preview.

### Does it cover other ad libraries besides Meta?

Yes. The tool also searches Google, LinkedIn, and Reddit ad libraries, so you can compare messaging across both B2C and B2B channels.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs