ToolVet
83trust / 100

Facebook Search

by ads.apitoll.cloud in Search & web

x402 APIPassing, checked 4 h ago

Facebook Ad Library search by keyword — every live and recent ad matching a search term across all advertisers on Facebook, Instagram, Messenger and Threads. Returns the full ad creative (headline, body copy, CTA button + destination link, image and video URLs), the advertiser, run dates and days-running, and platform mix. Commercial and political ads, no Meta API or login. Competitor ad intelligence, ad spy, and creative research for AI agents.

GET https://ads.apitoll.cloud/v1/ads/facebook/search

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
197 ms typical, 197 ms slowest 5%
Last check
4 h ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X GET "https://ads.apitoll.cloud/v1/ads/facebook/search?country=US&q=running+shoes"
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.03:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fads.apitoll.cloud%2Fv1%2Fads%2Ffacebook%2Fsearch
const res = await pay("https://ads.apitoll.cloud/v1/ads/facebook/search?country=US&q=running+shoes");
console.log(await res.json());

Example input

{
  "country": "US",
  "q": "running shoes"
}

Example output

{
  "ads": [
    {
      "adArchiveId": "1234567890123456",
      "bodyText": "Lightweight cushioning for your longest runs. Free shipping this week.",
      "country": "US",
      "ctaText": "Shop Now",
      "ctaType": "SHOP_NOW",
      "daysRunning": 28,
      "displayFormat": "VIDEO",
      "imageUrls": [
        "https://scontent.xx.fbcdn.net/v/img1.jpg"
      ],
      "isActive": true,
      "linkUrl": "https://acmefootwear.com/aeroglide?utm_source=fb",
      "linkUrlType": "destination",
      "mediaExpiresAt": "2026-06-29T22:19:28Z",
      "pageId": "100066543210987",
      "pageName": "Acme Footwear",
      "pageVerified": true,
      "publisherPlatform": [
        "FACEBOOK",
        "INSTAGRAM"
      ],
      "scrapedAt": "2026-06-25T14:32:09Z",
      "sourceUrl": "https://www.facebook.com/ads/library/?q=running%20shoes&country=US",
      "startDate": 1717200000,
      "templatedText": false,
      "title": "Run Further in the new AeroGlide",
      "videoUrl": "https://video.xx.fbcdn.net/v/ad_hd.mp4"
    }
  ],
  "asOf": "2026-06-25T14:32:10Z",
  "count": 25,
  "country": "US",
  "query": {
    "keyword": "running shoes"
  },
  "source": {
    "name": "Facebook Ad Library",
    "via": "Apify"
  }
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
4 h agoPassed402197 ms$0.03