Social Fetch
Google

Search Google Ad Library advertisers

Search Google Ad Transparency advertisers by name.

GET/v1/google/ad-library/advertisers/search
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
2
query*stringquery

Search query text for Google Ad Transparency advertisers.

min 1 chars · max 512 chars

regionstringoptionalquery

Optional two-letter country code to search in. Defaults to US when omitted.

Response fields
14

Endpoint-specific response payload.

dataquery
string

Search query that was evaluated for this response.

Advertisers returned for the search query.

dataadvertisers[]name
string

Advertiser display name.

min 1 chars

dataadvertisers[]advertiserId
string

Google Ad Transparency advertiser id for use with other Ad Library endpoints.

min 1 chars

dataadvertisers[]region
stringnullable

Region associated with the advertiser when available.

dataadvertisers[]adsEstimate
integernullable

Estimated number of ads for this advertiser when reported; otherwise null.

≥ 0

Website domains associated with the search results.

datawebsites[]domain
string

Website domain associated with the search.

min 1 chars

datatotalAdvertisers
integer

Number of advertisers returned in this response.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/google/ad-library/advertisers/search?query=lululemon" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Advertisers matching the search query.