Google Ad Library Advertiser Search
Google Ads Transparency Center can expose multiple advertiser records for a brand, organization, or website search term, including regional or similarly named entities. Reviewing their IDs, names, websites, logos, regions, and available ad counts helps select the right public advertiser record before collecting its creatives.
Features
- Name-led advertiser discoverySearch with one non-empty brand, organization, advertiser, or website term and receive normalized advertiser candidates rather than ad creatives.
- Optional regional contextPass a region such as US to contextualize the upstream search while keeping region distinct from ad-delivery geography.
- Candidate identity fieldsCompare the public advertiser ID, name, URL, website, logo, region, and available source-reported ad count without inferred enrichment.
- Complete single-response storageStore every usable advertiser returned by the one upstream search response; no caller-controlled result limit or provider pagination loop is applied.
Parameters
| Parameters | Required | Description |
|---|---|---|
query | Required | Required non-empty advertiser, brand, organization, or website search term. Matching behavior is source-dependent and is not guaranteed to be exact, prefix, or fuzzy. |
region | Optional | Optional non-empty region string such as US, forwarded as geographic search context. It does not prove where any advertiser's ads were delivered. |
How to Use
Submit a search term, follow the asynchronous task, and review each normalized advertiser candidate before using its identity in later research.
- Choose a specific advertiser, brand, organization, or website term; optionally add a region such as US.
- POST query and optional region to /v1/google-ad-library/advertiser-search, then save task_id.
- Poll /v1/tasks/{task_id} until the task succeeds or fails.
- Read data.results.items and verify candidate identity using more than name similarity before selecting an advertiser ID.
curl -X POST "https://api.socq.ai/v1/google-ad-library/advertiser-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Nike","region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Review data.results.items as advertiser candidatesBest Use Cases
- Resolve a brand to advertiser IDs: Build a candidate list from a name or website term before choosing an advertiser ID for a separate public ad-inventory request.
- Separate regional or legal entities: Compare names, regions, websites, and public advertiser pages when several similar records may represent subsidiaries, resellers, or unrelated organizations.
- Create a review queue: Store candidate identities and collection timestamps for manual verification without asserting ownership from name similarity alone.
Pro Tips
- Use a specific legal name, brand, or domain-like term; broad wording can produce ambiguous candidates and matching rules are not guaranteed.
- Treat region as search context, not evidence that every ad from the advertiser ran in that geography.
- Verify candidates with ID, name, website, region, and their public advertiser page before merging records or collecting creatives.
- Do not send results_limit: this operation stores the usable advertiser array returned by one upstream response and does not paginate the source.
Related APIs
Use these APIs when you need a different type of public Google Ad Library data.
- Google Ad Library Ad API — Retrieve one known public Transparency Center creative by URL with advertiser, copy, media, delivery, region, format, destination, and impression fields.
- Google Ad Library Company Ads API — Collect public Transparency Center creatives by company domain or advertiser ID with topic, region, date, surface, format, and result-limit controls.