Meta Ad Library & Google Ads Transparency API

PostToData exposes read-only search and creative detail operations for Meta Ad Library and Google Ads Transparency. Search Meta by company or brand name; search Google by company domain such as nike.com. Both return public creative evidence where available, not private advertising-account performance.

Documentation reviewed: 2026-11-13 · By PostToData

Use the right search input for each library

Meta search takes a company or brand name and retrieves available active public ads. Google search takes a company domain, not an arbitrary keyword or full URL. Do not send the same input unchanged to both endpoints.

These integrations currently retrieve the first result page using source ordering. They do not support cursor pagination or custom sorting. An empty or small result set does not prove that the advertiser is inactive.

Public creative research is not campaign analytics

Read creative text, source URLs and available advertiser IDs, creative IDs, formats and first/last shown dates. An active flag is included only when the source explicitly supplies it.

Do not infer spend, conversions, targeting, ROAS or return on investment from a public creative. PostToData does not access your private Meta or Google advertising account. This service is not the official marketing or campaign-management API.

Keep library data separate from Facebook and Pinterest posts

Facebook public post operations and Pinterest pin operations are separate platform entries. A Facebook video search is not a Meta ad search, and a Pinterest pin is not evidence of ad spend. Follow the matching reference for each task.

Start with one library search, retain the source URL and collected-at time, and approve a detail lookup only for a relevant creative. The ad-research workflow shows the planned call and price before execution; its AI skill instructs the model not to invent performance metrics.

Current prices & implemented operations

OperationPer successful call1,000 successful calls
Meta Ad Library · Search ads$0.006$6.00
Google Ads Transparency · Search ads$0.006$6.00
Meta Ad Library · Ad details$0.006$6.00
Google Ads Transparency · Ad details$0.006$6.00

The 1,000-call figure is list price multiplied by calls, not 1,000 records or a top-up package. The example only previews the first operation: no upstream fetch or charge. To retrieve data, remove dry_run=1 and supply Authorization: Bearer API_KEY. Keep max_price_usd to reject a price above the approved amount.

Free price preview
curl --get "https://posttodata.com/v1/meta_ads/search" \
  --data-urlencode 'query=Nike' \
  --data-urlencode 'limit=5' \
  --data-urlencode 'max_price_usd=0.006' \
  --data-urlencode 'dry_run=1'

A per-call ceiling is not a shared budget for the whole task. Bound the number of approved calls and stop on 402, 412 or 429; do not automatically raise limits or rotate accounts.

Frequently asked questions

Can I search Google ads using a product keyword?

Not with this integration. Supply the company domain, for example nike.com. Use Meta’s company-name search or a different data source when the task requires different filters.

Can I download every historical ad or measure ROI?

No. Current integrations are bounded first-page public searches and individual creative lookups. They do not guarantee a complete archive or expose campaign conversions and ROI.

Related guides