Get target interests

GET 
/ad-publishing/google/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.

Request

Version stringrequired

API Version

Available optionsv3

locationId stringrequired

Location identifier

type stringrequired

Interest type

Available optionsAFFINITYIN_MARKET

advertisingChannelType stringrequired

Channel type

limit string

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

pageToken string

Opaque cursor for the next batch, taken from the previous response paging.next

projection string[]

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

Available optionsresourceNametaxonomyTypeuserInterestIdnameuserInterestParentavailabilitieschildren

application/json

A plain array of root interests (default), or a { targetInterests, paging } envelope when limit is provided

application/json

Schema

Schema

oneOf
• object[]
• PaginatedGoogleTargetInterestsDTO
Array [
property name*any
]

Example (auto)

[
  {
    "resourceName": "customers/6776452901/userInterests/80546",
    "userInterestId": "80546",
    "name": "Sports & Fitness",
    "taxonomyType": "AFFINITY",
    "children": [
      {
        "resourceName": "customers/6776452901/userInterests/92948",
        "userInterestId": "92948",
        "name": "Fitness Buffs",
        "taxonomyType": "AFFINITY",
        "userInterestParent": "customers/6776452901/userInterests/80546",
        "children": []
      }
    ]
  }
]