---
title: Query Product Pages
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/query-product-pages
---

# Query Product Pages

Queries App Store product pages available to your account.

## URL

POST https://api.ads.apple.com/v1/product-pages/query

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

Discussion This endpoint queries product pages available to your ad account, returning Default Product Pages (DPPs), Custom Product Pages (CPPs), and Product Page Optimization (PPO) variants. Product pages come from App Store Connect and reflect the current publishing state of your product pages. Filter by adamId to list all product pages for a specific app. This is the recommended starting point when building a CUSTOM_PRODUCT_PAGE creative: use this endpoint to discover the available productPageId values for an app, then fetch locale details or pass the ID directly to the creative creation endpoint. Changes made in App Store Connect, such as publishing, hiding, or editing a product page, appear in this endpoint’s results after a short propagation delay. See QueryFilterOperator for the full set of supported comparison operators. Filterable Fields  |  |  |  |   |  |  |  |   |  |  |  |  The request body is a QueryRequest composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by QueryPagination. Keep the following constraints in mind when querying product pages:  |   |   |  Payload Examples

## See Also

- [Get Product Page by ID](apple-ads-platform-api/get-product-page-by-id.md)
- [Query Product Page Locale Details](apple-ads-platform-api/query-product-page-locale-details.md)
- [Query App Locale Details](apple-ads-platform-api/query-default-product-page-locale-details-by-adam-id.md)