<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/Query-Product-Pages",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "rest:apple-ads-platform-api:post:product-pages-query"
  },
  "title" : "Query Product Pages"
}
-->

# Query Product Pages

Queries App Store product pages available to your account.

## 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`](/documentation/Apple-Ads-Platform-API/QueryFilterOperator) for the full set of supported comparison operators.

### Filterable Fields

|Field   |Type   |Operators|Sortable|Description                                                                                                   |
|--------|:-----:|:-------:|:------:|--------------------------------------------------------------------------------------------------------------|
|`adamId`|integer|`EQUALS` |        |Filter to all product pages for a specific app.                                                               |
|`state` |string |`EQUALS` |        |Filter by page state. `state` is a plain nullable string with no fixed enum. The typical value is `PUBLISHED`.|

The request body is a [`QueryRequest`](/documentation/Apple-Ads-Platform-API/QueryRequest) composed of [`QueryFilter`](/documentation/Apple-Ads-Platform-API/QueryFilter) conditions and [`QuerySort`](/documentation/Apple-Ads-Platform-API/QuerySort) directives ([`QuerySortOrder`](/documentation/Apple-Ads-Platform-API/QuerySortOrder)), controlled by [`QueryPagination`](/documentation/Apple-Ads-Platform-API/QueryPagination).

Keep the following constraints in mind when querying product pages:

|Constraint              |Detail                                                                                                          |
|------------------------|----------------------------------------------------------------------------------------------------------------|
|Filter by adamId        |Always filter by `adamId` for targeted results. Omitting it may return product pages across all accessible apps.|
|App Store Connect source|Product page data originates in App Store Connect. This endpoint is read-only.                                  |

## Payload Examples

**Query by App:**

### Request

```json
{
 "filters": [
   {
     "field": "adamId",
     "operator": "EQUALS",
     "value": 123456789
   }
 ],
 "pagination": {
   "offset": 0,
   "pageSize": 20
 }
}
```

### Response

```json
{
 "result": [
   {
     "id": "133fc807-d4d5-4c77-92ae-1d6ffdf0c7dc",
     "adamId": 123456789,
     "name": "AwayFinder - Holiday Season CPP",
     "state": "PUBLISHED",
     "deepLink": "https://apps.apple.com/us/app/my-productivity-app/id123456789?ppid=133fc807-d4d5-4c77-92ae-1d6ffdf0c7dc",
     "creationTime": "2025-04-10T08:00:00.000",
     "modificationTime": "2025-05-01T14:30:00.000"
   },
   {
     "id": "a4b2c3d4-e5f6-7890-abcd-ef1234567890",
     "adamId": 123456789,
     "name": "AwayFinder - Back to School CPP",
     "state": "PUBLISHED",
     "deepLink": "https://apps.apple.com/us/app/my-productivity-app/id123456789?ppid=a4b2c3d4-e5f6-7890-abcd-ef1234567890",
     "creationTime": "2025-07-15T09:00:00.000",
     "modificationTime": "2025-07-20T11:00:00.000"
   }
 ],
 "pagination": {
   "totalCount": 2,
   "offset": 0,
   "pageSize": 20
 }
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)