Research Competitor Ad Creatives
Research what ads your competitors are running across Facebook and Google to understand their messaging and creative strategy.
Ad Library Search
Spy on ads across every platform
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.
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.
Returns: List of Facebook ads with ad content, impressions data, media assets, and advertiser information
Parameters
query *stringKeyword to search for in ads
countrystringTwo-letter country code to filter by (e.g. "US", "GB"). Defaults to ALL
statusstringAd status filter. Defaults to ACTIVE
media_typestringMedia type filter. Defaults to ALL
sort_bystringSort by impressions or most recent. Defaults to impressions
search_typestringSearch by keyword or exact phrase
ad_typestringFilter for political/issue ads or all ads
start_datestringImpressions start date in YYYY-MM-DD format
end_datestringImpressions end date in YYYY-MM-DD format
cursorstringPagination cursor from previous response
trimbooleanSet to true for a trimmed response
Example
Search Facebook ads by keyword
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "ad-library-search",
"skill": "search_facebook_ads",
"input": {
"query": "running shoes"
}
}' \
https://api.toolrouter.com/v1/tools/callSearch 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.
Returns: List of companies with their names and ad library page IDs
Parameters
query *stringCompany name to search for
Example
Find a company in the Facebook Ad Library
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "ad-library-search",
"skill": "search_facebook_ad_companies",
"input": {
"query": "Nike"
}
}' \
https://api.toolrouter.com/v1/tools/callGet 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.
Returns: List of ads the company is running with ad content, impressions, media, and targeting data
Parameters
company_namestringCompany name to get ads for
page_idstringAd library page ID (from search_facebook_ad_companies). Use this or company_name
countrystringTwo-letter country code (e.g. "US"). Defaults to ALL
statusstringAd status filter. Defaults to ACTIVE
media_typestringMedia type filter. Defaults to ALL
languagestringTwo-letter language code to filter by (e.g. "EN", "ES")
sort_bystringSort by impressions or most recent
start_datestringStart date in YYYY-MM-DD format
end_datestringEnd date in YYYY-MM-DD format
cursorstringPagination cursor from previous response
trimbooleanSet to true for a trimmed response
Example
Get all Nike ads on Facebook
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "ad-library-search",
"skill": "get_facebook_company_ads",
"input": {
"company_name": "Nike"
}
}' \
https://api.toolrouter.com/v1/tools/callGet Facebook Ad Details
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).
Returns: Full ad details including ad copy, media assets, cards, advertiser info, and optional transcript
Parameters
idstringFacebook Ad ID
urlstringFacebook Ad URL. Use this or id
get_transcriptbooleanGet video transcript (only for videos under 2 minutes)
trimbooleanSet to true for a trimmed response
Example
Get a Facebook ad by ID
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "ad-library-search",
"skill": "get_facebook_ad",
"input": {
"id": "123456789"
}
}' \
https://api.toolrouter.com/v1/tools/callSearch Google Advertisers
Search the Google Ad Transparency Library for advertisers by name. Returns advertiser IDs that can be used with get_google_company_ads.
Returns: List of advertisers with their names and advertiser IDs
Parameters
query *stringAdvertiser name to search for
Example
Search for an advertiser on Google
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "ad-library-search",
"skill": "search_google_advertisers",
"input": {
"query": "Shopify"
}
}' \
https://api.toolrouter.com/v1/tools/callGet 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.
Returns: List of Google ads with advertiser and creative IDs, and optionally full ad details with OCR text
Parameters
domainstringCompany domain (e.g. "shopify.com")
advertiser_idstringGoogle advertiser ID (from search_google_advertisers). Use this or domain
topicstringFilter by topic. Political ads also require a region
regionstringTwo-letter region code (e.g. "US"). Required for political topic
start_datestringStart date in YYYY-MM-DD format
end_datestringEnd date in YYYY-MM-DD format
get_ad_detailsbooleanSet to true to get full ad details (costs 25 credits per ad instead of 1)
cursorstringPagination cursor from previous response
Example
Get ads by domain
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "ad-library-search",
"skill": "get_google_company_ads",
"input": {
"domain": "shopify.com"
}
}' \
https://api.toolrouter.com/v1/tools/callGet Google Ad Details
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.
Returns: Ad details including OCR-extracted text, media type, and advertiser information
Parameters
url *stringGoogle Ad Transparency URL (must contain advertiser and creative IDs, e.g. https://adstransparency.google.com/advertiser/AR.../creative/CR...)
Example
Get a specific Google ad
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "ad-library-search",
"skill": "get_google_ad",
"input": {
"url": "https://adstransparency.google.com/advertiser/AR17804957702832168961/creative/CR04185088030974935041"
}
}' \
https://api.toolrouter.com/v1/tools/callSearch LinkedIn Ads
Search the LinkedIn ad library by company name, keyword, or company ID. At least one parameter is required.
Returns: List of LinkedIn advertisements with ad content, sponsor details, and campaign metadata
Parameters
companystringCompany name to search for ads (e.g. "Salesforce")
keywordstringKeyword to search for in ad content
company_idstringLinkedIn company ID to filter ads by
Example
Search LinkedIn ads by company name
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "ad-library-search",
"skill": "search_linkedin_ads",
"input": {
"company": "Salesforce"
}
}' \
https://api.toolrouter.com/v1/tools/callGet LinkedIn Ad Details
Get full details of a specific LinkedIn advertisement by URL. Returns ad copy, media, sponsor information, and engagement data.
Returns: LinkedIn ad details including ad copy, media assets, sponsor info, and engagement metrics
Parameters
url *stringFull URL of the LinkedIn advertisement
Example
Get details of a LinkedIn ad
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "ad-library-search",
"skill": "get_linkedin_ad",
"input": {
"url": "https://www.linkedin.com/ad/library/123456789"
}
}' \
https://api.toolrouter.com/v1/tools/callSearch Reddit Ads
Search Reddit for promoted and sponsored posts matching a query. Returns ad content, targeting info, and engagement metrics.
Returns: List of Reddit sponsored posts with ad content, subreddit targeting, and engagement data
Parameters
query *stringSearch query to find Reddit advertisements
Example
Search for Reddit ads about a product category
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "ad-library-search",
"skill": "search_reddit_ads",
"input": {
"query": "project management software"
}
}' \
https://api.toolrouter.com/v1/tools/callGet Reddit Ad
Get full details of a specific Reddit advertisement by URL, including ad copy, media, targeting, and engagement metrics.
Returns: Reddit ad details including ad copy, media assets, advertiser info, and engagement metrics
Parameters
url *stringFull URL of the Reddit advertisement post
Example
Get details of a specific Reddit ad
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "ad-library-search",
"skill": "get_reddit_ad",
"input": {
"url": "https://www.reddit.com/user/ExampleBrand/comments/abc123/try_our_new_product/"
}
}' \
https://api.toolrouter.com/v1/tools/callQuick Start
MCP (Claude Code)
claude mcp add --transport stdio \
--env TOOLROUTER_API_KEY=YOUR_API_KEY \
toolrouter -- npx -y toolrouter-mcpREST API
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{"tool":"ad-library-search","skill":"search_facebook_ads","input":{}}' \
https://api.toolrouter.com/v1/tools/callUse Cases
Analyze Ad Messaging Trends
Analyze messaging trends in your industry by searching ads across Facebook and LinkedIn to spot what resonates.
Analyze App Review Sentiment
Understand how users feel about your app by analyzing sentiment patterns across hundreds or thousands of reviews.
Optimize App Title and Subtitle for Search
Craft high-performing app titles and subtitles that maximize keyword visibility and conversion in the App Store.
Workflows
Competitor Analysis Suite
Build a complete competitive intelligence dossier by combining company research, SEO analysis, social media audits, and ad library searches.
Full-Funnel Ad Research
Research competitor advertising across platforms, analyze their strategy, study their organic content, and generate your own ad creatives.
Ecommerce Competitor Intelligence
Gather ecommerce competitive intelligence by scraping pricing data, researching businesses, monitoring social commerce, and analyzing ad campaigns.
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.