← Catalog

Competitor ads API: Meta Ad Library and Google Ads Transparency Center

ads.search

live

Public ad creatives from the Meta Ad Library (advertiser or keyword) or the Google Ads Transparency Center (advertiser domain).

live coverage

Apify: Meta Ad Library ✓Google ✓

✓ marks a combination proven with a real provider call. Others are wired and unit-tested; their first live run verifies them.

Providers

ProviderStatus
ScrapeCreators adapter next
Apify live
Adyntel planned
TikHub adapter next

Billing

Unit: per_search · unmatched results billed: no

The exact quote is returned by /v1/inspect before every call and held with headroom on execution. The quote is the price floor: if the provider's actual cost overruns it, the run bills the overrun at the same rate, never above the hold. The unused part of every hold is released.

Run it

curl https://api.jell.run/v1/run \
  -H "Authorization: Bearer $JELL_API_KEY" \
  -d '{
    "capability": "ads.search",
    "input": { "query": "..." },
    "routing": {"provider": "auto"}
  }'

Input schema

{
  "properties": {
    "limit": {
      "default": 20,
      "type": "integer"
    },
    "platform": {
      "default": "meta",
      "enum": [
        "meta",
        "google",
        "tiktok"
      ],
      "type": "string"
    },
    "query": {
      "description": "Advertiser name or keyword (Meta); advertiser domain such as hubspot.com (Google)",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Normalized output fields

ads

Used in these guides

Competitor ad intelligence →