---
updatedAt: 2026-10-05T14:42:48.000Z
agentTools:
  projectIndex: https://developers.apptweak.com/llms.txt
---

# CPP Breakdown by App

Returns the Custom Product Pages (CPPs) Apple has served for a given app, with the creative used and the period each page was seen. <br/><br/> Custom Product Pages are an Apple feature, so this endpoint covers iOS only. <br/><br/> <b>Price</b><table><thead><tr><th>Data</th><th>Credits</th><th>Per</th></tr></thead><tbody><tr><td>CPP breakdown by app</td><td>5</td><td>request</td></tr></tbody></table> <br/><br/> Any date range up to 1 year costs the same.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "1",
    "title": "App Store API",
    "contact": {
      "name": "AppTweak",
      "email": "support@apptweak.com"
    }
  },
  "servers": [
    {
      "url": "https://public-api.apptweak.com/api/public/store"
    }
  ],
  "security": [
    {
      "api_key": []
    }
  ],
  "tags": [
    {
      "name": "CPP Intelligence",
      "description": "AppTweak's CPP Intelligence endpoints provides deep insights into Custom Product Pages (CPPs) available on the Apple App Store. You can retrieve CPP creatives date (icons, screenshots) based on app, keyword, category, or DNA segmentation."
    }
  ],
  "paths": {
    "/cpps/breakdown/apps": {
      "get": {
        "summary": "CPP Breakdown by App",
        "description": "Returns the Custom Product Pages (CPPs) Apple has served for a given app, with the creative used and the period each page was seen. <br/><br/> Custom Product Pages are an Apple feature, so this endpoint covers iOS only. <br/><br/> <b>Price</b><table><thead><tr><th>Data</th><th>Credits</th><th>Per</th></tr></thead><tbody><tr><td>CPP breakdown by app</td><td>5</td><td>request</td></tr></tbody></table> <br/><br/> Any date range up to 1 year costs the same.",
        "operationId": "get_cppsbreakdownapps",
        "tags": [
          "CPP Intelligence"
        ],
        "parameters": [
          {
            "name": "application_id",
            "in": "query",
            "description": "App ID. <a href=\"https://developers.apptweak.com/reference/how-to-find-app-ids\" target=\"_blank\"><b>How to find App IDs?</b></a>",
            "required": true,
            "example": "426826309",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Two-letter country code (`us`, `gb`, `fr`). Only <a href=\"https://ads.apple.com/app-store/countries-and-regions\" target=\"_blank\"><b>Apple Ads countries and regions</b></a> are supported. Defaults to us.",
            "required": false,
            "schema": {
              "default": "us",
              "type": "string"
            }
          },
          {
            "name": "language",
            "in": "query",
            "description": "AppTweak language code, not always ISO: US English is `us`, US Spanish `sp`. Accepted pairs: <a href=\"https://developers.apptweak.com/reference/languages-1\" target=\"_blank\"><code>GET /api/public/apptweak/languages</code></a> with `store=ios` or `store=android`. Defaults to the country's <a href=\"https://developers.apptweak.com/reference/languages-overview#default-language\" target=\"_blank\"><b>default language</b></a>.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "device",
            "in": "query",
            "description": "iphone or ipad. Defaults to iphone.",
            "required": false,
            "schema": {
              "default": "iphone",
              "type": "string",
              "enum": [
                "iphone",
                "ipad"
              ]
            }
          },
          {
            "name": "start_date",
            "in": "query",
            "description": "Start date (YYYY-MM-DD). Maximum 31 days. Defaults to 30 days ago.",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "end_date",
            "in": "query",
            "description": "End date (YYYY-MM-DD). Maximum 31 days. Defaults to yesterday.",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "array",
                      "description": "One element per screenshot of each matching Custom Product Page, so a CPP with several screenshots or device classes spans several elements. Empty when nothing matches the filter.",
                      "items": {
                        "$ref": "#/components/schemas/CppScreenshot"
                      }
                    },
                    "metadata": {
                      "$ref": "#/components/schemas/ResponseMetadata"
                    }
                  }
                },
                "examples": {
                  "iOS": {
                    "value": {
                      "result": [
                        {
                          "cpp_id": "734221ef-8964-4c36-b525-6afa05010727",
                          "application_id": "426826309",
                          "developer_id": "1758",
                          "developer_name": "Strava, Inc.",
                          "first_seen_at": "2023-09-29T21:41:34.181+00:00",
                          "last_seen_at": "2025-08-02T00:13:38.425+00:00",
                          "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple126/v4/63/97/fa/6397fafd-2dda-d3bb-4367-0d127dd1e47e/AppIcon-0-1x_U007ephone-0-85-220.png/1024x1024bb.jpg",
                          "device_version": "iphone_6_5",
                          "type": "screenshot",
                          "url": "https://is4-ssl.mzstatic.com/image/thumb/PurpleSource116/v4/e7/f9/71/e7f97100-2704-f4b6-8b25-d80f8a96fda2/967dece3-6bb7-4fc3-bb19-5f16c6c211ea_AppStore-Primary-en-US-Card-02-Walk.png/1284x2778bb.jpg"
                        },
                        {
                          "cpp_id": "734221ef-8964-4c36-b525-6afa05010727",
                          "application_id": "426826309",
                          "developer_id": "1758",
                          "developer_name": "Strava, Inc.",
                          "first_seen_at": "2023-09-29T21:41:34.181+00:00",
                          "last_seen_at": "2025-08-02T00:13:38.425+00:00",
                          "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple126/v4/63/97/fa/6397fafd-2dda-d3bb-4367-0d127dd1e47e/AppIcon-0-1x_U007ephone-0-85-220.png/1024x1024bb.jpg",
                          "device_version": "iphone_6_5",
                          "type": "screenshot",
                          "url": "https://is2-ssl.mzstatic.com/image/thumb/PurpleSource126/v4/8f/a4/5b/8fa45b7e-4243-2681-516e-d3b7eda0b078/4554660e-0024-4f0f-a906-d38cc3cb4dae_AppStore-Primary-en-US-Card-03-Walk.png/1284x2778bb.jpg"
                        }
                      ],
                      "metadata": {
                        "request": {
                          "path": "/api/public/store/cpps/breakdown/apps",
                          "params": {
                            "device": "iphone",
                            "country": "us",
                            "language": "us",
                            "start_date": "2025-07-05",
                            "end_date": "2025-08-03",
                            "application_id": "426826309"
                          },
                          "cost": 5,
                          "status": 200,
                          "charge_type": "credits"
                        },
                        "response": null
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized. Unknown or missing API token."
          },
          "403": {
            "description": "Forbidden. Not enough credits to perform the request."
          },
          "422": {
            "description": "Validation error. Returned when a parameter is invalid."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "name": "x-apptweak-key",
        "in": "header"
      }
    },
    "schemas": {
      "CppScreenshot": {
        "type": "object",
        "title": "CPP screenshot",
        "properties": {
          "cpp_id": {
            "type": "string",
            "format": "uuid",
            "description": "Apple Custom Product Page ID. Repeats across every element belonging to the same CPP."
          },
          "application_id": {
            "type": "string",
            "description": "Numeric App Store ID of the app owning the CPP."
          },
          "developer_id": {
            "type": "string",
            "description": "AppTweak's internal developer ID, as a numeric string. Not the Apple artist ID."
          },
          "developer_name": {
            "type": "string",
            "description": "Developer display name."
          },
          "first_seen_at": {
            "type": "string",
            "format": "date-time",
            "description": "When AppTweak first observed the CPP. A property of the CPP, not of this screenshot, so it is identical on every element sharing a `cpp_id`."
          },
          "last_seen_at": {
            "type": "string",
            "format": "date-time",
            "description": "Most recent observation of the CPP. Same CPP-level scope as `first_seen_at`."
          },
          "icon": {
            "type": "string",
            "format": "uri",
            "description": "App icon URL. A property of the app, repeated on every element."
          },
          "device_version": {
            "type": "string",
            "description": "Apple's screenshot device-class key, passed through verbatim from the store."
          },
          "type": {
            "type": "string",
            "enum": [
              "screenshot"
            ],
            "description": "Asset kind. Always `screenshot` on these endpoints."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "The screenshot image. The only field that varies between elements sharing the same `cpp_id` and `device_version`."
          }
        }
      },
      "ResponseMetadata": {
        "type": "object",
        "description": "Standard response envelope, identical on every endpoint.",
        "properties": {
          "request": {
            "type": "object",
            "properties": {
              "path": {
                "type": "string",
                "description": "The path that was called."
              },
              "params": {
                "type": "object",
                "nullable": true,
                "description": "The query as the API parsed it, with defaults applied."
              },
              "cost": {
                "type": "integer",
                "description": "Credit cost of the request. Thread tokens do not debit credits."
              },
              "charge_type": {
                "type": "string",
                "enum": [
                  "credits",
                  "thread"
                ],
                "description": "How the request is paid. `credits`: debited from the company's balance. `thread`: an unlimited token, not debited; `cost` shows what the request is worth."
              },
              "status": {
                "type": "integer",
                "description": "HTTP status of the response."
              }
            }
          },
          "response": {
            "type": "object",
            "nullable": true,
            "description": "Endpoint-specific notes; null when there are none."
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```