Method: products.list

  • This page documents the API endpoint for listing products in a Google Merchant Center account.

  • The endpoint supports pagination, allowing retrieval of large product lists in manageable chunks using nextPageToken.

  • Requests require authorization with the https://www.googleapis.com/auth/content scope.

  • The response provides a list of products, a nextPageToken for further retrieval (if applicable), and basic metadata.

  • Developers can use query parameters to control the maximum number of results per page and navigate through pages.

Lists the products in your Merchant Center account. The response might contain fewer items than specified by maxResults. Rely on nextPageToken to determine if there are more items to be requested.

HTTP request

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

Path parameters

Parameters
merchantId

string

The ID of the account that contains the products. This account cannot be a multi-client account.

Query parameters

Parameters
maxResults

integer (uint32 format)

The maximum number of products to return in the response, used for paging. The default value is 25. The maximum value is 250.
pageToken

string

The token returned by the previous request.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

JSON representation 
{
  "nextPageToken": string,
  "kind": string,
  "resources": [
    {
      object (Product)
    }
  ]
}
Fields
nextPageToken

string

The token for the retrieval of the next page of products.
kind

string

Identifies what kind of resource this is. Value: the fixed string "content#productsListResponse".
resources[]

object (Product)

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.