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 options2023-02-21

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": []
      }
    ]
  }
]