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

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

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

Returns a collection of audience attributes using generative AI based on the provided audience description. List of thrown errors: [AudienceInsightsError]() [AuthenticationError]() [AuthorizationError]() [FieldError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]()

## Path parameters

- `customerId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesGenerateAudienceDefinitionRequest — Request message for AudienceInsightsService.GenerateAudienceDefinition.
  - `audienceDescription` GoogleAdsSearchads360V23ServicesInsightsAudienceDescription — A text description of the audience of interest for which insights are being requested in AudienceInsightsService.
    - `marketingObjective` 'UNSPECIFIED' | 'UNKNOWN' | 'AWARENESS' | 'CONSIDERATION' | 'RESEARCH' — Optional. An optional marketing objective which will influence the type of suggestions produced.
    - `audienceDimensions` GoogleAdsSearchads360V23ServicesAudienceInsightsDimensions — A collection of dimensions to be used for generating insights.
      - `dimensions` string[] — Required. A list of dimensions.
    - `countryLocations` GoogleAdsSearchads360V23CommonLocationInfo[] — Required. The countries for the audience.
      - `geoTargetConstant` string — The geo target constant resource name.
    - `audienceDescription` string — Required. An English language text description of an audience to get suggestions for. Maximum length is 2000 characters. For example, "Women in their 30s who love to travel".
  - `customerInsightsGroup` string — Optional. The name of the customer being planned for. This is a user-defined value.
  - `insightsApplicationInfo` GoogleAdsSearchads360V23CommonAdditionalApplicationInfo — Additional information about the application/tool issuing the request. This field is only used by ContentCreatorInsightsService, AudienceInsightsService, and ReachPlanService APIs.
    - `applicationInstance` 'UNSPECIFIED' | 'UNKNOWN' | 'DEVELOPMENT_AND_TESTING' | 'PRODUCTION' — The instance type of the application sending the request.
    - `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.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/searchads360.md) · [All operations](https://skmtc.net/google/apis/searchads360/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/searchads360/versions/40d087435afd/schema)