Facebook Ad Library Search Companies API

What is the Facebook Ad Library Search Companies API?

The Facebook Ad Library Search Companies API lets you search and return matching results from Ad Library with a single REST call. No OAuth, no scraping infrastructure, and no platform SDKs — send the URL, get clean structured JSON back. Results are cached for 24 hours, so repeat lookups are instant and free.

What you get

• Ranked, structured result list
• Title, URL, author, and thumbnail per result
• Engagement metrics where available
• Configurable result limit

Try it

Fill in the parameters below and copy a ready-to-run request in your language of choice.

curl "https://api.captapi.com/v1/ad-library/facebook/search-companies?q=skincare" \
  -H "Authorization: Bearer capt_live_..."

Example response

{
  "success": true,
  "cached": false,
  "creditsUsed": 20,
  "data": {
    "total": 2,
    "results": [
      {
        "title": "Top result",
        "url": "https://example.com/1",
        "author": "@creator",
        "views": 530120
      },
      {
        "title": "Second result",
        "url": "https://example.com/2",
        "author": "@maker",
        "views": 210430
      }
    ]
  }
}

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Parameters

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 20 credits — billed per result, so the exact amount scales with how many items you request. Repeat calls for the same request are served from cache for free (metrics refresh within ~1 hour).

How it works

1. 1. Sign up — get 100 free credits, no card required.
2. 2. Create a key from your dashboard.
3. 3. Send one request to /v1/ad-library/facebook/search-companies and parse the JSON response.

Use cases

Frequently asked questions

More Ad Library APIs