search_ads
facebook.comSearches the Meta/Facebook Ad Library on https://www.facebook.com by keyword or advertiser name and returns up to 30 matching active ads, including creative, platform, spend, impression, and funding fields when available.
Playground
Runs on Notte and spends your workspace credits — what comes back is the live response, not a sample.
What is search_ads?
Searches the Meta/Facebook Ad Library on https://www.facebook.com by keyword or advertiser name and returns up to 30 matching active ads, including creative, platform, spend, impression, and funding fields when available. It runs on Notte's browser infrastructure and returns structured JSON, so you can call it like any other API — pass query, country, limit and get the result back without maintaining a scraper.
Response
{
"ads": [
{}
],
"query": "<string>",
"country": "<string>",
"has_more": true,
"total_results": 0,
"returned_count": 0
}Call it
curl --location 'https://us-prod.notte.cc/functions/ee5a8f1a-b384-437d-adf1-b3b07a2963ba/runs/start' \
--header 'x-notte-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
"function_id": "ee5a8f1a-b384-437d-adf1-b3b07a2963ba",
"variables": {
"query": "climate",
"country": "US",
"limit": 10
}
}'Ask an agent
Paste this into Claude Code, Cursor or any MCP client to have an agent call this function for you.
Use the Anything API MCP server (https://anything.notte.cc/mcp). Call run(function_id="ee5a8f1a-b384-437d-adf1-b3b07a2963ba") — the "search_ads" function, which searches the Meta/Facebook Ad Library on https://www.facebook.com by keyword or advertiser name and returns up to 30 matching active ads, including creative, platform, spend, impression, and funding fields when available.. It takes query (str), country (str), limit (int). Return the result as structured JSON.