---
title: "CPP Usage (iOS)"
method: POST
path: "/data/ads/cpp/populate"
tags: ["Ads"]
---

# CPP Usage (iOS)

`POST /data/ads/cpp/populate`

## Request

- Base URL: `https://data.applyzer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://data.applyzer.com/data/ads/cpp/populate`
- Auth: API key in header `Authorization`

This endpoint analyzes Custom Product Page (CPP) usage for the provided keywords using existing MongoDB snapshots (it does not scrape/populate).<br/>

Credit Cost: 5

Credits per extra keyword: 5

## Request body

- object
  - `keywords` string[], required: List of keywords to analyze.
  - `language` string, required: The code for English (United States) 'en-us'. The prefix, 'en', is a language code following the ISO 639-1 standard. The suffix, 'us', is a country code following the ISO 3166-1 Alpha-2 standard.
  - `device` string: iphone / ipad / mac (default is iphone). Used to select the most relevant CPP screenshot/video previews.
  - `days_back` integer: Number of days back to look for CPP snapshots (default is 30)
  - `group_by` string: keyword / app (default is keyword). Response shape depends on this value.
  - `source_type` string: both / organic / paid (default is both)
  - `appid` string: Optional iOS app id to filter CPP results to a single app.
  - `show_default_pages` boolean: If true, includes default CPP pages in the results (default is false)

## Response `200`

Successful operation

- object
  - `message` string: The response message
  - `response` object[]: Results array. If group_by=keyword each item represents a keyword; if group_by=app each item represents an app.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `500`: Error

---

[API](https://skmtc.dev/applyzer/apis/applyzer-data-api.md) - [All operations](https://skmtc.dev/applyzer/apis/applyzer-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/applyzer/apis/applyzer-data-api/revisions/ffe6cc179bf5?raw)