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.
Amazon API
Search public Amazon products and collect normalized product details, Best Sellers, reviews, and seller-profile records from supported marketplaces.
Apple App Store API
Collect public Apple App Store app details, category rankings, and reviews from known store URLs as normalized app and review records.
SEO API
Query live Google organic results, compare keyword demand and ranking difficulty, expand seed terms, uncover the keywords and pages driving a site's search visibility, and classify search intent. Every endpoint uses the same SocQ API key, asynchronous task flow, and normalized result format.
Instagram API
Look up or find public profiles and collect follower-list records, following relationships, authored posts, profile-tagged posts, hashtag results, Reels, transcripts, comments, account counts, engagement metrics and media metadata through one asynchronous workflow.
TikTok API
Collect supported public TikTok profiles, direct video metadata, top-level comments, video search results, and videos for specified hashtags through one normalized asynchronous workflow.