---
title: "POST /v1/{+parent}/insights:retrieve"
method: POST
path: "/v1/{+parent}/insights:retrieve"
tags: ["accountTypes"]
---

# POST /v1/{+parent}/insights:retrieve

`POST /v1/{+parent}/insights:retrieve`

Retrieves marketing data insights for a given user list. This feature is only available to data partners. Authorization Headers: This method supports the following optional headers to define how the API authorizes access for the request: * `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}` * `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`

## Path parameters

- `parent` string, required

## Request body

- RetrieveInsightsRequest — Request message for DM API MarketingDataInsightsService.RetrieveInsights
  - `baseline` Baseline — Baseline criteria against which insights are compared.
    - `locationAutoDetectionEnabled` boolean — If set to true, the service will try to automatically detect the baseline location for insights.
    - `baselineLocation` Location — The baseline location of the request. Baseline location is on OR-list of ISO 3166-1 alpha-2 region codes of the requested regions.
      - `regionCodes` string[] — List of ISO 3166-1 alpha-2 region codes.
  - `userListId` string — Required. The user list ID for which insights are requested.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/datamanager.md) · [All operations](https://skmtc.dev/google/apis/datamanager/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/datamanager/revisions/a26378ca9ba8/schema)