---
title: "POST /{merchantId}/reports/search"
method: POST
path: "/{merchantId}/reports/search"
tags: ["reports"]
---

# POST /{merchantId}/reports/search

`POST /{merchantId}/reports/search`

Retrieves merchant performance metrics matching the search query and optionally segmented by selected dimensions.

## Path parameters

- `merchantId` string, required

## Request body

- SearchRequest — Request message for the ReportService.Search method.
  - `pageSize` integer — Number of ReportRows to retrieve in a single page. Defaults to 1000. Values above 5000 are coerced to 5000.
  - `pageToken` string — Token of the page to retrieve. If not specified, the first page of results is returned. In order to request the next page of results, the value obtained from `next_page_token` in the previous response should be used.
  - `query` string — Required. Query that defines performance metrics to retrieve and dimensions according to which the metrics are to be segmented. For details on how to construct your query, see the [Query Language guide](https://developers.google.com/shopping-content/guides/reports/query-language/overview).

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/content.md) · [All operations](https://skmtc.net/google/apis/content/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/content/revisions/1033388fc86f/schema)