---
title: "POST /v23/customers/{+customerId}:generateAudienceOverlapInsights"
method: POST
path: "/v23/customers/{+customerId}:generateAudienceOverlapInsights"
tags: ["customers"]
---

# POST /v23/customers/{+customerId}:generateAudienceOverlapInsights

`POST /v23/customers/{+customerId}:generateAudienceOverlapInsights`

## Request

- Base URL: `https://searchads360.googleapis.com`
- URL: `https://searchads360.googleapis.com/v23/customers/{+customerId}:generateAudienceOverlapInsights`
- Auth: OAuth 2 (implicit, authorization URL `https://accounts.google.com/o/oauth2/auth`, scopes: `https://www.googleapis.com/auth/doubleclicksearch`) and OAuth 2 (authorization code, authorization URL `https://accounts.google.com/o/oauth2/auth`, token URL `https://accounts.google.com/o/oauth2/token`, scopes: `https://www.googleapis.com/auth/doubleclicksearch`)

Returns a collection of audience attributes along with estimates of the overlap between their potential YouTube reach and that of a given input attribute. List of thrown errors: [AudienceInsightsError]() [AuthenticationError]() [AuthorizationError]() [FieldError]() [HeaderError]() [InternalError]() [QuotaError]() [RangeError]() [RequestError]()

## Path parameters

- `customerId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesGenerateAudienceOverlapInsightsRequest: Request message for AudienceInsightsService.GenerateAudienceOverlapInsights.
  - `countryLocation` GoogleAdsSearchads360V23CommonLocationInfo: A location criterion.
    - `geoTargetConstant` string: The geo target constant resource name.
  - `customerInsightsGroup` string: The name of the customer being planned for. This is a user-defined value.
  - `dimensions` string[]: Required. The types of attributes of which to calculate the overlap with the primary_attribute. The values must be a subset of AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE and GENDER.
  - `insightsApplicationInfo` GoogleAdsSearchads360V23CommonAdditionalApplicationInfo: Additional information about the application/tool issuing the request. This field is only used by ContentCreatorInsightsService, AudienceInsightsService, and ReachPlanService APIs.
    - `applicationId` string: The unique identifier of the agency proprietary application. This identifier is generated by Google. Reach out to your Google representative to request an application_id for each new application being integrated.
    - `applicationInstance` 'UNSPECIFIED' | 'UNKNOWN' | 'DEVELOPMENT_AND_TESTING' | 'PRODUCTION': The instance type of the application sending the request.
  - `primaryAttribute` GoogleAdsSearchads360V23CommonAudienceInsightsAttribute: An audience attribute that can be used to request insights about the audience.
    - `ageRange` GoogleAdsSearchads360V23CommonAgeRangeInfo: An age range criterion.
      - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AGE_RANGE_18_24' | 'AGE_RANGE_25_34' | 'AGE_RANGE_35_44' | 'AGE_RANGE_45_54' | 'AGE_RANGE_55_64' | 'AGE_RANGE_65_UP' | 'AGE_RANGE_UNDETERMINED': Type of the age range.
    - `category` GoogleAdsSearchads360V23CommonAudienceInsightsCategory: A Product and Service category.
      - `categoryId` string: Required. The criterion ID of the category.
    - `device` GoogleAdsSearchads360V23CommonDeviceInfo: A device criterion.
      - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MOBILE' | 'TABLET' | 'DESKTOP' | 'CONNECTED_TV' | 'OTHER': Type of the device.
    - `entity` GoogleAdsSearchads360V23CommonAudienceInsightsEntity: A Knowledge Graph entity, represented by its machine id.
      - `knowledgeGraphMachineId` string: Required. The machine ID (mid) of the Knowledge Graph entity.
    - `gender` GoogleAdsSearchads360V23CommonGenderInfo: A gender criterion.
      - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'MALE' | 'FEMALE' | 'UNDETERMINED': Type of the gender.
    - `incomeRange` GoogleAdsSearchads360V23CommonIncomeRangeInfo: An income range criterion.
      - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'INCOME_RANGE_0_50' | 'INCOME_RANGE_50_60' | 'INCOME_RANGE_60_70' | 'INCOME_RANGE_70_80' | 'INCOME_RANGE_80_90' | 'INCOME_RANGE_90_UP' | 'INCOME_RANGE_UNDETERMINED': Type of the income range.
    - `lineup` GoogleAdsSearchads360V23CommonAudienceInsightsLineup: A YouTube Lineup.
      - `lineupId` string: Required. The numeric ID of the lineup.
    - `location` GoogleAdsSearchads360V23CommonLocationInfo: A location criterion.
      - `geoTargetConstant` string: The geo target constant resource name.
    - `parentalStatus` GoogleAdsSearchads360V23CommonParentalStatusInfo: A parental status criterion.
      - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'PARENT' | 'NOT_A_PARENT' | 'UNDETERMINED': Type of the parental status.
    - `userInterest` GoogleAdsSearchads360V23CommonUserInterestInfo: Represents a particular interest-based topic to be targeted.
      - `userInterestCategory` string: The UserInterest resource name.
    - `userList` GoogleAdsSearchads360V23CommonUserListInfo: A User List criterion. Represents a user list that is defined by the advertiser to be targeted.
      - `userList` string: The User List resource name.
    - `youtubeChannel` GoogleAdsSearchads360V23CommonYouTubeChannelInfo: A YouTube Channel criterion.
      - `channelId` string: The YouTube uploader channel id or the channel code of a YouTube channel.
    - `youtubeVideo` GoogleAdsSearchads360V23CommonYouTubeVideoInfo: A YouTube Video criterion.
      - `videoId` string: YouTube video id as it appears on the YouTube watch page.

## Response `200`

Successful response

## Changes

- **2026-10-10** `3c8ec4f526ec`: 2 breaking
  - removed the request body
  - removed the media type `*/*` for the response with the status `200`

[Operation history](https://skmtc.dev/google/apis/searchads360/changes/v23/customers/:customerId:generateAudienceOverlapInsights/post.md)

---

[API](https://skmtc.dev/google/apis/searchads360.md) · [All operations](https://skmtc.dev/google/apis/searchads360/llms.txt) · [OpenAPI document](https://skmtc.dev/google/apis/searchads360/revisions/3c8ec4f526ec?raw)