APapptweak
CPP Intelligence

CPP Breakdown by Category

Changed on

Returns the Custom Product Pages (CPPs) served for the apps in a store category. <br/><br/> Custom Product Pages are an Apple feature, so this endpoint covers iOS only. <br/><br/> <b>Price</b> <table> <thead><tr><th>Datapoint</th><th>Description</th><th>Credits/app for 1 day</th><th>Credits/app per extra day</th></tr></thead> <tbody> <tr><td><b>cpp</b></td><td>Hash containing CPP ID, app ID, developer name & ID, first & last seen at, type of CPP and URL of the creative</td><td>500</td><td>50</td></tr> </tbody> </table> We source apps from the Top Charts—specifically, the top 200 free apps within your selected category. From this list, we display apps with at least one detected CPP in the chosen date range, ordered by their category rank.

get/cpps/breakdown/categories

Request

  • Base URL
    https://public-api.apptweak.com/api/public/store
  • URL
    https://public-api.apptweak.com/api/public/store/cpps/breakdown/categories
  • Auth
    API key in header x-apptweak-key

Query parameters

category_idstring required

The category ID. The ids are on the <a href="https://developers.apptweak.com/reference/app-store-categories" target="_blank"><b>App Store Categories</b></a> page.

countrystring

Two-letter country code (us, gb, fr). Accepted values: <a href="https://developers.apptweak.com/reference/countries-1" target="_blank"><code>GET /api/public/apptweak/countries</code></a> with store=ios or store=android. Defaults to us.

languagestring

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>.

device'iphone' | 'ipad'

iphone or ipad. Defaults to iphone.

start_datestring date

Start date (YYYY-MM-DD). Maximum 31 days. Defaults to 30 days ago.

end_datestring date

End date (YYYY-MM-DD). Maximum 31 days. Defaults to yesterday.

Response

Successful response.

Changes

  • a4af4000f1e3Revision changes
    • breaking

      the query request parameter device was restricted to a list of enum values

    • breaking

      for the query request parameter end_date, default value was removed

    • breaking

      for the query request parameter language, default value us was removed

    • breaking

      for the query request parameter start_date, default value was removed

    • info

      api tag CPP Intelligence added

    • info

      added the new enum value ipad to the query request parameter device

    • info

      added the new enum value iphone to the query request parameter device

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status