Schemas

Suggestion

Autocomplete suggestions from a platform's search box for a partial query: completed searches, accounts, hashtags and websites, in its order.

Endpoints

3 endpoints return suggestions on Google Ads Transparency Center, Instagram and TikTok.

Schema

Every endpoint above returns an array of these objects as data, with a page object. The standard meta comes with every response.

platformstring

Platform whose search box offers the suggestion.

textstring

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.

typestring

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.

One ofqueryprofilehashtagwebsite

positioninteger

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).

urlstring uri

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.

profileobjectnullable

The account a profile suggestion names; null for every other type.

Show 6 child fields

idstringnullable

Platform-native account ID; null when only the handle is known.

usernamestringnullable

Handle without the @; null when the account has none.

display_namestringnullable

Display name shown on the profile.

urlstring urinullable

Canonical profile URL.

avatar_urlstring urinullable

Profile picture URL. Platform CDN URLs can expire within hours.

is_verifiedbooleannullable

Platform verification badge; null where the platform has no badge.

hashtagobjectnullable

The hashtag a hashtag suggestion names, keyed as the platform's hashtag endpoints key it; null for every other type.

Show 4 child fields

idstring

The hashtag's ID as the platform's hashtag endpoints key it: its native ID, or the name lowercased where the platform's pages key a hashtag by name (Instagram).

namestring

The tag without #, as the platform shows it (case kept).

urlstring uri

Canonical hashtag page URL.

metricsobject

Counts at fetch time; null = hidden or not exposed, 0 = zero.

Show 1 child field

post_countintegernullable

Posts carrying the tag, as the platform counts them; rounded on YouTube and Threads (see approximate_fields).

platform_specificobject

Fields only this platform has, under its ID (platform_specific.<platform>); each null when unknown.

Show 3 child fields

tiktokobjectnullable

A TikTok suggestion's own fields.

Show 2 child fields

languagestringnullable

The suggestion's language as TikTok labels it, an ISO 639-1 code (en, es); null when TikTok does not say.

scorenumbernullable

TikTok's predicted click-through rate for the suggestion, 0 to 1: a relative signal among one query's suggestions; null when not given.

instagramobjectnullable

An Instagram suggestion's own fields.

Show 1 child field

tag_idstringnullable

Instagram's own numeric ID of a hashtag suggestion's tag; null for every other type.

googleobjectnullable

A Google Ads Transparency Center suggestion's own fields.

Show 2 child fields

country_codestringnullable

The country an advertiser suggestion's advertiser is based in, an ISO 3166-1 alpha-2 code; null for a website suggestion, or when not shown.

adsobjectnullable

The ads the center shows for an advertiser suggestion's advertiser, as Google's range (equal bounds when exact), in the region the request names where it takes one; null for a website suggestion, or when not shown.

Show 2 child fields

lower_boundinteger

Inclusive lower bound.

upper_boundintegernullable

Inclusive upper bound; null when open-ended (e.g. ">1M"). Equal to lower_bound when exact.

approximate_fieldsstring[]

JSON paths of values rounded or capped by the platform (hashtag.metrics.post_count at Instagram's ceiling). [] when all exact.

unknown_fieldsstring[]

JSON paths of lists whose [] means unknown rather than none; [] when every list is known (a suggestion has none yet).

Example (Google Ads Transparency Center)

{
  "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 for display.