Answers / Meta Ad Library

How do I search competitor ads using the Meta Ad Library API without an app review?

Send GET /v1/meta_ads/search?query=BRAND_NAME with your PostToData Bearer token. It returns active ad creatives, body text, publisher platforms (Facebook, Instagram, Messenger), and snapshot links from the official Meta Ad Library without undergoing tedious Facebook Business verification or app review.

Meta Ad Library · search posts · $0.006 a call · one verified website trial · updated 2026-11-13

Run it live

Calls run only when you press Run. Opening this page does not spend credit.

Loading…

Search takes a company name and returns a bounded page of active ads across countries. Detail takes an ad archive ID or Meta Ad Library URL. No automatic pagination or transcription; public creatives do not establish spend, conversions or ROI.

Your results will appear here. Choose a platform and action, then press Run.

Real API calls require verification for one trial, or a signed-in account with prepaid credit.

From code

curl
curl "https://posttodata.com/v1/meta_ads/search?query=Nike&limit=5" -H "Authorization: Bearer YOUR_API_KEY"
Python (requests)
import requests

r = requests.get(
    "https://posttodata.com/v1/meta_ads/search",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"query": "Nike", "limit": 5},
)
for item in r.json()["data"]["items"]:
    print(item["url"], item.get("text") or item.get("title"))
TypeScript / Node.js
const url = new URL("https://posttodata.com/v1/meta_ads/search");
url.searchParams.set("query", "Nike");
url.searchParams.set("limit", "5");
const res = await fetch(url, {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await res.json();
console.log(data.data.items);
Go
req, _ := http.NewRequest("GET", "https://posttodata.com/v1/meta_ads/search?query=Nike&limit=5", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

From your AI

Claude and ChatGPT clients that support OAuth can sign in without pasting a key. Follow the client setup guide. The command below is the API-key option for Claude Code.

Add the MCP server once
claude mcp add --transport http posttodata https://posttodata.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Then ask

“Search the Meta Ad Library for active ads by 'Nike' using PostToData, extract the primary copy angles, and list the ad links.”

The model calls search_posts with platform meta_ads.

Response Schema & Data Sample

Normalized JSON output structure returned by PostToData. All fields are strongly typed; missing upstream metrics return null rather than being omitted.

200 OK — JSON Response
{
  "meta": {
    "platform": "meta_ads",
    "action": "search",
    "total_items": 1,
    "currency": "USD",
    "price_usd": "0.006"
  },
  "data": {
    "items": [
      {
        "id": "Nike",
        "type": "ad",
        "url": "https://meta_ads.com/example_id",
        "published_at": "2026-11-15T12:00:00Z",
        "title": "Nike insights & discussion",
        "text": "Structured body content retrieved from the public social post, ready for AI indexing or sentiment analysis.",
        "author": {
          "id": "creator_01",
          "username": "creator_name",
          "name": "Creator",
          "url": null
        },
        "metrics": {
          "likes": 215,
          "comments": 34,
          "shares": 12,
          "views": 5400,
          "score": null
        }
      }
    ]
  }
}

Good to know

  • Meta Ad Library searches list at $0.006 per call.
  • No Meta Developer Account, business document submission, or identity confirmation needed.
  • Returns ad creative text, publisher platforms, and direct snapshot URLs.
  • Public ad libraries do not expose spend numbers or click-through rates.

Full reference in the docs. All Meta Ad Library endpoints are on the Meta Ad Library API page.

More answers