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

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

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

Searches for audience attributes that can be used to generate insights. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [FieldError]() [HeaderError]() [InternalError]() [QuotaError]() [RangeError]() [RequestError]()

## Path parameters

- `customerId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesListAudienceInsightsAttributesRequest — Request message for AudienceInsightsService.ListAudienceInsightsAttributes.
  - `dimensions` string[] — Required. The types of attributes to be returned. Supported dimensions are CATEGORY, KNOWLEDGE_GRAPH, GEO_TARGET_COUNTRY, SUB_COUNTRY_LOCATION, YOUTUBE_LINEUP, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, .
  - `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.
  - `youtubeReachLocation` 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.
  - `locationCountryFilters` GoogleAdsSearchads360V23CommonLocationInfo[] — If SUB_COUNTRY_LOCATION attributes are one of the requested dimensions and this field is present, then the SUB_COUNTRY_LOCATION attributes returned will be located in these countries. If this field is absent, then location attributes are not filtered by country. Setting this field when SUB_COUNTRY_LOCATION attributes are not requested will return an error.
    - `geoTargetConstant` string — The geo target constant resource name.
  - `queryText` string — Required. A free text query. If the requested dimensions include Attributes CATEGORY or KNOWLEDGE_GRAPH, then the attributes returned for those dimensions will match or be related to this string. For other dimensions, this field is ignored and all available attributes are returned.

## 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/revisions/40d087435afd/schema)