CPP Intelligence

Available Endpoints

CPP by App - Query all available Custom Product Pages by specifying:

Input params: app_id, country,language

This endpoint is ideal for analyzing how a specific app is using CPPs across regions.

Query CPPs from top apps in a given store category. We source these apps from the Top Charts—specifically, the top 200 free apps within your selected category.

Input params: category_id, country,language

Use this to benchmark creative strategies across a market segment.

CPP by DNA

Retrieve CPPs based on DNA top chart clusters (groupings based on similar creative/metadata traits).

Input: subclass_id, country,language

Very useful if you want to look at apps that are in the same segment as yours.

CPP by Keyword

See which CPPs are associated with apps bidding on a specific keyword in Apple Search Ads.

Input: keyword, country,language

This endpoint surfaces the creatives linked to keyword-driven ad strategies.

CPP Keywords

Returns the list of keywords driving traffic to specific CPPs for an app.

Input params: cpp_id, country,language

Provides a direct mapping between search terms and custom pages.

All the endpoints can be filtered by device (iphone or ipad) and for a specific date range (defined by start_date and end_date).

Response example

Example of a response for CPP by App

{
  "result": [
    {
      "cpp_id": "9140aa46-ba99-49e6-834f-f3ae2844b70c",
      "application_id": "302920553",
      "developer_id": "1938",
      "developer_name": "GrubHub.com",
      "first_seen_at": "2023-05-20T02:18:24.055+00:00", // Date & time it was first seen by AppTweak
      "last_seen_at": "2025-07-25T03:50:22.567+00:00", // Date & time it was last seen by AppTweak
      "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple126/v4/a9/5a/74/a95a749e-b088-ff5f-eab2-60b9f051c92d/AppIcon-0-1x_U007emarketing-0-7-0-85-220.png/1024x1024bb.jpg",
      "device_version": "iphone_6_5", 
      "type": "screenshot", // Creative type
      "url": "https://is4-ssl.mzstatic.com/image/thumb/Purple116/v4/f0/79/04/f0790461-4a3b-c0a0-08e3-bdb9c923b893/3d6ab510-b9bf-4857-bf50-a8e60ddbd16b_GrubHub_GrubHub_iOS_6.5_US_Screenshot_Mockups_230126_01.png/1284x2778bb.jpg"
    },...
    {
      "cpp_id": "9140aa46-ba99-49e6-834f-f3ae2844b70c",
      "application_id": "302920553",
      "developer_id": "1938",
      "developer_name": "GrubHub.com",
      "first_seen_at": "2023-05-20T02:18:24.055+00:00",
      "last_seen_at": "2025-07-25T03:50:22.567+00:00",
      "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple126/v4/a9/5a/74/a95a749e-b088-ff5f-eab2-60b9f051c92d/AppIcon-0-1x_U007emarketing-0-7-0-85-220.png/1024x1024bb.jpg",
      "device_version": "iphone6plus",
      "type": "screenshot",
      "url": "https://is3-ssl.mzstatic.com/image/thumb/Purple126/v4/f2/6d/2f/f26d2f3d-8574-a99f-60f0-c6b4a3c629b2/95a5f5f3-3605-426b-a6b0-2d2604f268ba_GrubHub_GrubHub_iOS_5.5_Handset_US_Screenshot_Mockups_230125_07__U00282_U0029.png/1242x2208bb.jpg"
    }
  ],
  "metadata": {
    "request": {
      "path": "/api/public/store/cpps/breakdown/apps",
      "params": {
        "device": "iphone",
        "country": "us",
        "language": "us",
        "start_date": "2025-06-25",
        "end_date": "2025-07-24",
        "application_id": "302920553"
      },
      "cost": 2001,
      "max_credit_cost": 2001,
      "status": 200
    },
    "response": null
  }
}

Device Versions

Device versions for iPhone & the associated resolutions:

device_version	Resolution
iphone6plus	1242x2208
iphone_6_5	1242x2688 1284x2778
iphone_d74	1290x2796 1320x2868

Device version for iPad & the associated resolutions:

device_version	Resolution
ipadPro_2018	2048x2732
ipadPro	2048x2732

Comparing with default Product Page

To compare the CPP with the default product page, you can simply make a call to App Metadata - Current.

FAQs

How do I fetch a competitor's Custom Product Page creatives via API?

You can pull an app's Custom Product Page assets with AppTweak's CPP by App endpoint (GET /cpps/breakdown/apps), which takes an application_id plus country, language, and a device (iphone or ipad) and returns every CPP AppTweak has observed for that app, including each variant's cpp_id, screenshot/icon url, device_version, first_seen_at, and last_seen_at. Results are limited to a start_date/end_date window of up to 31 days, so a full creative history needs multiple calls across periods.

What's the difference between the CPP by App, CPP by Category, and CPP by DNA endpoints?

The difference is scope: CPP by App looks at one specific app, while CPP by Category and CPP by DNA look at groups of apps. CPP by App (application_id) returns the CPPs of a single app you name. CPP by Category (category_id) returns CPPs from the top 200 free apps in a given App Store category, for benchmarking creative strategy across a market segment. CPP by DNA (subclass_id) returns CPPs from apps in the same AppTweak DNA cluster — a grouping by similar creative or metadata traits rather than by official category — for comparing against closer look-alike competitors.

Can I see which app store keywords are driving traffic to a specific Custom Product Page?

Yes — the CPP Keywords endpoint (GET /cpps/keywords) returns the keywords associated with a given Custom Product Page. It takes a cpp_id (the identifier of one specific CPP variant, obtainable from CPP by App or a related breakdown endpoint) plus country, language, and a date range, and returns the list of keywords AppTweak has mapped to that page. This is the direct mapping between a search term and the exact variant a searcher would land on, rather than the app's default product page.

How do I find which apps are running Custom Product Pages tied to a specific keyword?

You can query the CPP by Keyword endpoint (GET /cpps/breakdown/keywords), which takes a keyword plus country, language, and device, and returns the CPP creatives — screenshots, icons, cpp_id, application_id — for apps whose Custom Product Page is linked to that keyword through Apple Search Ads bidding. This surfaces creative-to-keyword pairing at the market level: which apps target a term with a paid ad and what App Store creative that ad points to.

What creative asset types and device sizes does the Custom Product Page data cover?

AppTweak's CPP endpoints return creative assets by type (for example screenshot) alongside a device_version field identifying the specific device the asset was captured for, across both iPhone and iPad. Each asset also comes with a url, plus first_seen_at and last_seen_at timestamps marking when AppTweak first and most recently observed that creative live.