Google Ad Library API
Discover public advertisers, collect creatives for a company, or retrieve one known Transparency Center creative by URL for research and review.
Available Google Ad Library APIs
Use Advertiser Search to find candidates, Company Ads to collect bounded creative sets, and Ad Details to resolve one exact public creative URL.
What Google ad transparency data can you retrieve?
SocQ normalizes available public Transparency Center fields while preserving unavailable source values as null or empty.
Advertiser discovery
Find candidate advertiser identities, websites, logos, regions, and available ad-count fields by query.
Creative and destination context
Collect available text, advertiser references, formats, media assets, and landing-page destinations.
Public delivery context
Preserve available dates, countries, Google surfaces, and safely normalized impression values.
SocQ and Google Ads products
SocQ normalizes supported public transparency records. Google Ads products remain the appropriate choice for authorized account and campaign operations.
| Capability | SocQ | Google Ads products |
|---|---|---|
| Primary use | Discover and normalize public transparency records | Manage authorized advertising accounts and campaigns |
| Inputs | Query, company identifier and filters, or exact creative URL | Product-specific account, campaign, or reporting inputs |
| Authentication | SocQ API key | Product-specific Google credentials and authorization |
| Response format | Normalized public advertiser and ad records | Product-specific native response |
How the Google Ad Library APIs work
All three endpoints use SocQ's asynchronous submit, poll, and result-reading lifecycle.
1. Choose an endpoint
Submit a query to Advertiser Search, a domain or advertiser ID to Company Ads, or one creative URL to Ad Details.
2. Submit and track the task
POST the request, store task_id, and poll /v1/tasks/{task_id} until processing finishes.
3. Read normalized results
Process data.results.items; Company Ads observes the requested cap, while Ad Details returns at most one item.
Authenticate with a SocQ API key and provide either a company domain or advertiser ID. The default result cap is 40.
curl -X POST "https://api.socq.ai/v1/google-ad-library/company-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain":"lululemon.com","results_limit":40}'
# Also available:
# POST /v1/google-ad-library/advertiser-search
# POST /v1/google-ad-library/ad
# Poll GET /v1/tasks/{task_id}Common Google Ad Library API use cases
Advertiser discovery
Resolve a brand or website query into public advertiser candidates before collecting ads.
Company creative research
Collect bounded sets of public creatives with optional topic, region, date, surface, and format filters.
Selected-creative enrichment
Complete a known creative record with advertiser, text, media, destination, and delivery fields.
Limits and public-data policy
Results depend on current public source visibility and do not provide private Google Ads account data.
- Advertiser Search requires one query and accepts an optional region; it has no results_limit input.
- Company Ads requires domain or advertiser_id and accepts results_limit in multiples of 40 from 40 through 2,000.
- Ad Details requires one adstransparency.google.com URL whose path contains /creative/ and returns at most one item.
- Public records can be incomplete and do not expose private budgets, clicks, conversions, bids, audiences, or return on ad spend.
Google Ad Library API frequently asked questions
Which endpoint should I use first?
Use Advertiser Search when you only know a brand or website, Company Ads when you have a domain or advertiser ID, and Ad Details when you already have an exact creative URL.
Can I filter company ads?
Yes. Optional controls include topic, region, date range, Google surface, format, and a bounded results_limit.
Can these APIs access private campaign performance?
No. They work with public transparency records and do not expose private account or campaign analytics.
How are results priced?
Each returned record costs 0.5 SocQ credits, with no configured base charge for an empty result.
Combine data across platforms for more complete business insights
Bring public profiles, content, and engagement data from different platforms into one workflow to track brands, creators, and topics and run cross-platform monitoring and analysis more efficiently.
Google Maps API
Discover public places, retrieve normalized details for known Maps URLs, and collect public reviews with source-linked place and author context.
Kwai API
Retrieve public Kwai profiles, one page of account posts, or one known post with normalized identity, content, media, timestamps, and visible engagement.
Truth Social API
Retrieve public account details, collect one source page of account posts, or resolve one known post URL into normalized records.
LinkedIn API
Retrieve public LinkedIn profile, company, post, and job data from known URLs, with normalized identity, career, company, content, engagement, and job fields.
Reddit API
Retrieve public Reddit posts and comments from known URLs, browse new, top, or hot subreddit posts, or search discussions by keyword and publication window.
Rednote API
Retrieve public profiles and notes, search notes or users, collect comments and nested replies, and capture one home recommendation page.