ghl_ad_google_target_interest_list
Retrieve affinity and in-market interest options for Google Ads targeting, with pagination and field projection to fetch only the needed audience data.
Instructions
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.
Endpoint: GET /ad-publishing/google/target-interests (Version header: v3; source: v3/ad-publishing-v3.json)
OAuth scopes: adPublishing.readonly
Pagination params: limit — pass them to page through full result sets.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"locationId": "<locationId>",
"type": "<type>",
"advertisingChannelType": "<advertisingChannelType>"
},
"name": "ghl_ad_google_target_interest_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | Interest type | |
| limit | No | 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 | No | Opaque cursor for the next batch, taken from the previous response paging.next | |
| locationId | Yes | Location identifier | |
| projection | No | 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. | |
| advertisingChannelType | Yes | Channel type |