Facebook Ad Search
Search the Meta Ad Library by keyword and get matching ads (advertiser, creative text, CTA, platforms, and run dates) with cursor pagination.
- Price
- $0.00121 / call
- Success (7 days)
- —
- Median latency
- —
- Runs (30 days)
- 25
Details
- Tier
- bridged
- Safe to retry
- No
- Data
- Scraped from public web pages
- Source terms
- —
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Keyword to search the Meta Ad Library for (e.g. "protein powder"). |
adType | string | No | Restrict to all ads (default) or only political and issue ads. |
country | string | No | Two-letter country code to scope results. Omit for all countries. |
cursor | string | No | Opaque pagination cursor from a previous response's nextCursor. |
endDate | string | No | Filter to ads with impressions on or before this date, in YYYY-MM-DD format. |
mediaType | string | No | Creative media type filter. |
searchType | string | No | Match mode for the query: loose keyword match (keyword_unordered, the default) or exact phrase (keyword_exact_phrase). |
sortBy | string | No | Sort order: impressions (highest first, the default) or recent (most recent). |
startDate | string | No | Filter to ads with impressions on or after this date, in YYYY-MM-DD format. |
status | string | No | Ad status filter. |
Call it
curl https://api.orcarouter.ai/v1/tools/anyapi.facebook-ads-search/run \
-H "Authorization: Bearer $ORCAROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":{"query":"query","status":"ACTIVE"}}'curl "https://api.orcarouter.ai/v1/tools/functions?ids=anyapi.facebook-ads-search&format=openai" \
-H "Authorization: Bearer $ORCAROUTER_API_KEY"{
"mcpServers": {
"orcarouter": {
"type": "http",
"url": "https://api.orcarouter.ai/v1/tools/mcp",
"headers": {
"Authorization": "Bearer <ORCAROUTER_API_KEY>"
}
}
}
}Questions
How much does Facebook Ad Search cost?
Facebook Ad Search costs $0.00121 per call: 1,000 calls cost $1.21.
What does a $10 budget buy with Facebook Ad Search?
About 8264 calls at $0.00121 per call.
What inputs does Facebook Ad Search need?
Required inputs: query.
How do I call Facebook Ad Search?
Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.
Alternatives
| Tool | Price | Success (7 days) | Median latency | Runs (30 days) | Tier |
|---|---|---|---|---|---|
| Facebook Company AdsList the Meta Ad Library ads a company is running by page ID or company name (creative text, format, platforms, and run dates) with cursor pagination. | $0.00121 / call | — | — | — | bridged |
| Facebook Ad DetailsLook up a single Meta Ad Library ad by ID or URL and get the advertiser, creative text, call-to-action, platforms, and run dates as clean JSON. | $0.00132 / call | — | — | — | bridged |
| Facebook Ad TranscriptGet the spoken-word transcript of a Meta Ad Library video ad by ad ID or URL. | $0.00132 / call | — | — | — | bridged |
| Facebook Ad Creative DetailsPull one Meta Ad Library ad with its creative: every carousel variant, image and video URL, headline, body, and call to action. | $0.00508 / call | — | — | — | bridged |
