---
title: "GET /v4/advertisers/{advertisersId}/reachForecast:retrievePlannableUserInterests"
method: GET
path: "/v4/advertisers/{advertisersId}/reachForecast:retrievePlannableUserInterests"
tags: ["advertisers"]
---

# GET /v4/advertisers/{advertisersId}/reachForecast:retrievePlannableUserInterests

`GET /v4/advertisers/{advertisersId}/reachForecast:retrievePlannableUserInterests`

## Request

- Base URL: `https://displayvideo.googleapis.com`
- URL: `https://displayvideo.googleapis.com/v4/advertisers/{advertisersId}/reachForecast:retrievePlannableUserInterests`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/display-video`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/display-video`
- TypeScript: <https://skmtc.dev/google/apis/displayvideo/docs/v4/advertisers/:advertisersId/reachForecast:retrievePlannableUserInterests/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves Google Audiences (User Interests) available for forecasting. API support for generating reach forecasts and retrieving related metadata is in beta. This method is only available to allowlisted users.

## Path parameters

- `advertisersId` string, required

## Query parameters

- `productCategory` 'PLANNABLE_PRODUCT_CATEGORY_UNSPECIFIED' | 'YOUTUBE' | 'OPEN_AUCTION'

## Response `200`

Successful response

- RetrievePlannableUserInterestsResponse: Response for RetrievePlannableUserInterests.
  - `plannableUserInterests` PlannableUserInterest[]: The list of plannable user interests (Google Audiences).
    - `userInterest` UserInterest: The identifier for a user interest.
      - `userInterestCategory` string: Output only. The resource name of the interest category. Populated when `product_category` is "Youtube". Format: customers/{customer_id}/userInterests/{user_interest_id}
      - `userInterestUserList` string: Output only. The resource name of the user list. Populated when `product_category` is "Open Auction". Format: customers/{customer_id}/userLists/{user_list_id}
    - `userInterestDisplayName` string: Output only. The display name of the interest, for example "Outdoor Enthusiasts".
    - `userInterestPath` string: Output only. The category path of the interest.
    - `userInterestType` string: Output only. The type of audience, e.g., "AFFINITY", "IN_MARKET".

---

[API](https://skmtc.dev/google/apis/displayvideo.md) - [All operations](https://skmtc.dev/google/apis/displayvideo/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/displayvideo/revisions/d80b56b6703a?raw)