Get target interests
Retrieve affinity and in-market audience options for Google Ads targeting. Without limit the response is a plain array of root interests (each with a nested children tree). When limit is provided (max 100) the response is a paginated { targetInterests, paging } envelope — a page counts root interests; pass pageToken (from paging.next) to fetch the next batch. By default each node is returned in full; pass projection (comma-separated, e.g. ?projection=name,userInterestId,children) to return only the requested fields — selecting children prunes the whole tree recursively with the same selection, and any value outside the known field set is rejected.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your access token.
adPublishing.OAuthPrivate IntegrationSub-Account TokenRequest
Headers
API Version
v3v3Query Parameters
Location identifier
HChooFuiyPpVYzeJ4HMeInterest type
AFFINITYIN_MARKETAFFINITYChannel type
SEARCHPage size for a paginated fetch (max 100). When set, the response is a { targetInterests, paging } envelope instead of a plain array. Counts root interests — each root includes its full children tree.
100Opaque cursor for the next batch, taken from the previous response paging.next
100Fields to return on each interest node, comma-separated (e.g. ?projection=name,userInterestId,children). When set, only the requested fields are returned. Selecting children prunes the whole tree recursively with the same selection; availabilities returns the whole array. Any value outside the known field set is rejected. Omit the param entirely to receive the full node as-is.
resourceNametaxonomyTypeuserInterestIdnameuserInterestParentavailabilitieschildren["name","userInterestId","children"]Response
A plain array of root interests (default), or a { targetInterests, paging } envelope when limit is provided
- object[]
- PaginatedGoogleTargetInterestsDTO