# Google Ads Transparency Center Search Suggestions API. Advertisers and websites matching your search. Advertisers and websites suggested for a query. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dgoogle.search_suggestions) ## Google Ads Transparency Center Search Suggestions API at a glance Returns what the Google Ads Transparency Center search box suggests for a query, in its order: matching advertisers, then websites with ads. Each advertiser has its AR ID, name, country, verification badge and ad count as Google's range, and each website its bare domain, ready for the Google Ads Transparency Center Ads by Website API. Filter to one country, and page past what the box shows. GET `/v1/google/search_suggestions` [Read the API reference](https://socialtap.dev/docs/reference/google/search_suggestions/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **9 typed fields** null when unknown - **20** advertisers and websites per page, the center's search box order: on each page its advertisers, then its websites - **`query`** is all it needs, e.g. `lululemon` ## Send one request. Get up to 20 advertisers and websites back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `query = lululemon` [Open in playground](https://socialtap.dev/playground/?endpoint=google.search_suggestions) cURL: ```shell curl 'https://socialtap.dev/v1/google/search_suggestions?query=Lululemon' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.google.searchSuggestions.list({ query: "Lululemon" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ query: "Lululemon", }); const res = await fetch(`https://socialtap.dev/v1/google/search_suggestions?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, page, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/google/search_suggestions", params={"query": "Lululemon"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, page, meta = body["data"], body["page"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("query", "Lululemon") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/google/search_suggestions?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Page json.RawMessage `json:"page"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": [ { "approximate_fields": [], "hashtag": null, "platform": "google", "platform_specific": { "google": { "ads": { "lower_bound": 16, "upper_bound": 16 }, "country_code": "MX" } }, "position": 0, "profile": { "avatar_url": null, "display_name": "LULULEMON MEXICO", "id": "AR02903092099014459393", "is_verified": true, "url": "https://adstransparency.google.com/advertiser/AR02903092099014459393", "username": null }, "text": "LULULEMON MEXICO", "type": "profile", "unknown_fields": [], "url": "https://adstransparency.google.com/advertiser/AR02903092099014459393" }, { "approximate_fields": [], "hashtag": null, "platform": "google", "platform_specific": { "google": { "ads": { "lower_bound": 4000, "upper_bound": 5000 }, "country_code": "HK" } }, "position": 1, "profile": { "avatar_url": null, "display_name": "lululemon HK Limited", "id": "AR01382517811867287553", "is_verified": true, "url": "https://adstransparency.google.com/advertiser/AR01382517811867287553", "username": null }, "text": "lululemon HK Limited", "type": "profile", "unknown_fields": [], "url": "https://adstransparency.google.com/advertiser/AR01382517811867287553" }, { "approximate_fields": [], "hashtag": null, "platform": "google", "platform_specific": { "google": { "ads": { "lower_bound": 55, "upper_bound": 55 }, "country_code": "QA" } }, "position": 2, "profile": { "avatar_url": null, "display_name": "LULULEMON ATHLETICA TRADING", "id": "AR06362141867382931457", "is_verified": true, "url": "https://adstransparency.google.com/advertiser/AR06362141867382931457", "username": null }, "text": "LULULEMON ATHLETICA TRADING", "type": "profile", "unknown_fields": [], "url": "https://adstransparency.google.com/advertiser/AR06362141867382931457" } ], "page": { "has_more": true, "next_cursor": "c1.EXAMPLE_CURSOR", "next_cursor_expires_at": "2026-10-26T12:00:00Z", "end_reason": null }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "google", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 197, "fetched_at": "2026-10-25T12:00:00Z", "input": null, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 3 platforms. The [response reference](https://socialtap.dev/docs/reference/google/search_suggestions/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/suggestion/index.md). - ### Null means unknown A field Google Ads Transparency Center doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts What to search for, as typed into the Ads Transparency Center's search box: an advertiser's name or a website's domain, or a part of either, in any language (lululemon, nike.com, トヨタ). - ### Write one parser Google Ads Transparency Center, TikTok and Instagram answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform whose search box offers the suggestion. - **`text`string**: The suggestion as the platform shows it, whitespace-trimmed: the completed search for a query suggestion, the account's name for a profile one, the domain for a website one. - **`type`string**: query = a completed search to run; profile = an account (or community) the platform proposes, described in profile; hashtag = a hashtag, described in hashtag; website = a website the platform proposes: text is its domain (nike.com), as the platform's searches by website take it. New values may be added. - **`position`integer**: Zero-based rank of the suggestion in the list, counting every type: the platform's order (each endpoint's notes say how a list combining several of the platform's searches is ordered). - **`url`string**: Where the suggestion leads on the platform: the search results page for a query, the account's page for a profile, the hashtag's page for a hashtag, the platform's page for the website for a website. - **`profile`object**: The account a profile suggestion names; null for every other type. - **`hashtag`object**: The hashtag a hashtag suggestion names, keyed as the platform's hashtag endpoints key it; null for every other type. - **`approximate_fields`string\[\]**: JSON paths of values rounded or capped by the platform (hashtag.metrics.post_count at Instagram's ceiling). \[\] when all exact. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the Google Ads Transparency Center Search Suggestions API. - ### Find a brand's advertisers and websites at once - ### Pick the domain to pull a website's ads - ### Autocomplete an ad library search in your app - ### See which of a brand's country sites advertise ## Good to know before you build. - Each page holds up to ten advertisers, then up to ten websites, as the box lists them. The next page continues both lists, and position counts across pages. The Google Ads Transparency Center Advertiser Search API lists every matching advertiser at once, with sort=popular. - A website suggestion's text is a bare domain (nike.com), which the Google Ads Transparency Center Ads by Website API takes as its query. Its url is the center's page of the ads that lead to that website, from any advertiser. - Ad counts are Google's ranges (thousands are bucketed), in platform_specific.google.ads with both bounds. With country, they count only the ads shown there. - The box matches names and domains, not IDs or links: an advertiser's ID finds nothing, and a website's address is searched as words, so send its bare domain (nike.com). Send an ad's or an advertiser's link to the endpoint that takes it. Another Ads Transparency Center page (a domain search) is refused. - Websites are matched by their domain, so a query in another script (トヨタ) usually suggests advertisers only. ## 1 credit per page. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/google/search_suggestions/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | Platform API `api` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the Google Ads Transparency Center Search Suggestions API. More in the [API reference](https://socialtap.dev/docs/reference/google/search_suggestions/index.md). **How much does the Google Ads Transparency Center Search Suggestions API cost?** A page of up to 20 advertisers and websites costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours. Other platforms ## Suggestions on 2 more platforms. - [TikTok Search Suggestions API](https://socialtap.dev/apis/tiktok/search_suggestions/index.md) (1 credit / page · `GET /v1/tiktok/search_suggestions`) - [Instagram Search Suggestions API](https://socialtap.dev/apis/instagram/search_suggestions/index.md) (1 credit / page · `GET /v1/instagram/search_suggestions`) More Google Ads Transparency Center ## Google Ads Transparency Center API. 6 endpoints, one key. - [Google Ads Transparency Center Advertiser API](https://socialtap.dev/apis/google/advertiser/index.md) (1 credit · `GET /v1/google/advertiser`) - [Google Ads Transparency Center Advertiser Search API](https://socialtap.dev/apis/google/search_advertisers/index.md) (1 credit / page · `GET /v1/google/search_advertisers`) - [Google Ads Transparency Center Ad API](https://socialtap.dev/apis/google/ad/index.md) (1 credit · `GET /v1/google/ad`) - [Google Ads Transparency Center Advertiser Ads API](https://socialtap.dev/apis/google/ads/index.md) (1 credit / page · `GET /v1/google/ads`) - [Google Ads Transparency Center Ads by Website API](https://socialtap.dev/apis/google/search_ads/index.md) (1 credit / page · `GET /v1/google/search_ads`) ## Try it with your own search. Type it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/google/search_suggestions/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)