Tools · social media
How to use Facebook Ads Library Scraper from your AI agent
● ready to runsocial media
A social media tool your agent can run. It takes inputs such as Meta Ad Library URL or Facebook Page URL, Results limit per URL and Get only the total ad count per page, and returns its results to your agent. One prepaid apifare balance pays for this and every other capability your agent uses — under per-agent caps, a kill switch, and a signed receipt for every call.
What you need
An apifare key with credits. That's it: get a key (new accounts start with 500 free credits), connect your agent with its setup guide, and ask it to run Facebook Ads Library Scraper.
Inputs it takes
| field | what it sets | example |
|---|---|---|
startUrls required | Meta Ad Library URL or Facebook Page URL | |
resultsLimit | Results limit per URL | |
onlyTotal | Get only the total ad count per page | |
includeAboutPage | Include page "About" information (location, contact details, page his… | |
isDetailsPerAd | Include extra ad details (reach & spend data, basic Instagram data) | |
activeStatus | Active status (if not specified within the Meta Ad Library URL) |
Your agent fills these in from what you ask; you rarely need to name them.
Price
Reserve 5 credits per run, settled to the run's true cost (ceiling 20 credits; 1 credit = $0.01). Failed runs are refunded. The exact billed number always comes from /capabilities.
Run it
Once your agent is connected, ask it:
Use apifare to run "Facebook Ads Library Scraper" for me.Your agent finds it with search_apis and runs it with proxy_call (in apifare-mcp). Over HTTP: GET /v1/search?q=… with Authorization: Bearer <token>, then POST the result's proxy_route with the input JSON. Full reference: the docs · for agents: this page as Markdown.
Give this to your agent
set up https://apifare.com/SKILL.md — and it takes it from there: key, config, first call. $5 of calls free.
No agent open right now? ① Get a key — $5 of calls free ② give it to your agent (one config line)
Tool data © its developer. apifare routes and meters the call; you are responsible for complying with the platform's terms (terms).