This section describes CPP Intelligence based API services.
This endpoint allows users to search for CPPs (Custom Product Pages) based on the application and retrieves their screenshots, promotional texts, and videos. The endpoint also provides information about the impression share of each CPP for that app. CPPs can be filtered by startDate and endDate.
GET /searchads-stats/cpps-by-app/{APP_TRACK_ID}?startDate={START_DATE}&endDate={END_DATE}&country={COUNTRY}&page={PAGE)&token={YOUR_API_KEY}
Request Parameters
Field | Description |
---|---|
trackId |
(required) AppStore track id of app |
startDate |
(required) Start date with ISO Date Format (yyyy-MM-dd) and max date range is 30 days. If date range exceed it, End Date automatically set 30 days from Start Date. |
endDate |
(required) End date of with ISO Date Format (yyyy-MM-dd) and max date range is 30 days. If date range exceed it, End Date automatically set 30 days from Start Date. |
country |
(optional) Two letter country code, if it's not specified, returns for all countries. |
page |
(required) Returns maximum 100 CPPs per request, use this parameter to iterate, defaults to 0 |
Response Fields
Field | Description |
---|---|
trackId |
APP_TRACK_ID(number) |
cppId |
CPP_ID(string or null) |
productPageType |
[DESCRIPTION,PROMOTION,IMAGE,VIDEO](enum or null) |
defaultProductPage |
true(boolean) |
firstSeenDate |
YYYY-MM-DD(date) |
lastSeenDate |
YYYY-MM-DD(date) |
impressionShare |
IMPRESSION_SHARE(float number) |
promotionalText |
TEXT(string) |
url |
CPP_URL(string) |
screenshotList |
[URL_1,URL_2](string array) |
videoList |
[URL_1,URL_2](string array) |
curl "https://api.mobileaction.co/searchads-stats/cpps-by-app/1590348243?startDate=2023-02-01&endDate=2023-03-01&country=US&page=0&token=YOUR_API_KEY"
[
{
"trackId": 1590348243,
"cppId": null,
"productPageType": null,
"defaultProductPage": true,
"firstSeenDate": "2023-01-03",
"lastSeenDate": "2023-02-03",
"impressionShare": 100.0,
"promotionalText": "Transform your mental and emotional well-being with personalized sessions tailored to your physical abilities and current mental and emotional state.",
"url": "https://apps.apple.com/us/app/id1590348243?platform=iphone",
"screenshotList": [
"https://is3-ssl.mzstatic.com/image/thumb/PurpleSource113/v4/20/a7/40/20a740e7-76b7-d78a-867f-717b006350c7/4dbffd56-0d69-4371-a470-03bc9da555b6_1242x2208-1.jpg/576x1024.png",
"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource113/v4/65/8d/b3/658db34f-235d-7c23-298d-ec1bbd436091/78c4f3d8-fc7a-44ec-8e66-ae18146b98ae_1242x2208-2.jpg/576x1024.png",
"https://is2-ssl.mzstatic.com/image/thumb/PurpleSource113/v4/4b/a9/d8/4ba9d8fd-b138-377d-b41a-97c43863bc6b/b11c0469-584e-4241-b5cc-07367758f405_1242x2208-3.jpg/576x1024.png",
"https://is3-ssl.mzstatic.com/image/thumb/PurpleSource113/v4/bc/4b/e1/bc4be15b-618f-2b3a-e209-fac0cfc5e361/d9b3e780-edff-4430-a721-514007afd625_1242x2208-4.jpg/576x1024.png",
"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource113/v4/93/db/43/93db43cb-bf28-a35d-05de-4657ffb3ac69/522ca307-f7eb-4449-8c5c-06fc23e613fb_1242x2208-5.jpg/576x1024.png"
],
"videoList": [
"https://apptrailers.itunes.apple.com/itunes-assets/PurpleVideo113/v4/3e/e7/79/3ee77996-2c8f-eeac-fbb2-40dedc468600/P529682509_default.m3u8"
]
}
]
This endpoint allows users to search for CPPs (Custom Product Pages) by keyword and provides information on which apps are running campaigns for the keyword. It retrieves their screenshots, promotional texts, and videos. The endpoint provides information about the impression share of each CPP for that keyword and allows filtering by startDate and endDate.
GET /searchads-stats/cpps-by-keyword?keyword={KEYWORD}&startDate={START_DATE}&endDate={END_DATE}&country={COUNTRY}&page={PAGE)&token={YOUR_API_KEY}
Request Parameters
Field | Description |
---|---|
keyword: |
(required) keyword related with the CPPs |
startDate |
(required) Start date with ISO Date Format (yyyy-MM-dd) and max date range is 30 days. If date range exceed it, End Date automatically set 30 days from Start Date. |
endDate |
(required) End date of with ISO Date Format (yyyy-MM-dd) and max date range is 30 days. If date range exceed it, End Date automatically set 30 days from Start Date. |
country |
(optional) Two letter country code, if it's not specified, returns for all countries. |
page |
(required) Returns maximum 100 CPPs per request, use this parameter to iterate, defaults to 0 |
Response Fields
Field | Description |
---|---|
trackId |
APP_TRACK_ID(number) |
cppId |
CPP_ID(string or null) |
productPageType |
[DESCRIPTION,PROMOTION,IMAGE,VIDEO](enum or null) |
defaultProductPage |
true(boolean) |
firstSeenDate |
YYYY-MM-DD(date) |
lastSeenDate |
YYYY-MM-DD(date) |
impressionShare |
IMPRESSION_SHARE(float number) |
promotionalText |
TEXT(string) |
url |
CPP_URL(string) |
screenshotList |
[URL_1,URL_2](string array) |
videoList |
[URL_1,URL_2](string array) |
curl "https://api.mobileaction.co/searchads-stats/cpps-by-keyword?keyword=game&startDate=2023-02-01&endDate=2023-03-01&country=US&page=0&token=YOUR_API_KEY"
[
{
"trackId": 1596684882,
"cppId": null,
"productPageType": null,
"defaultProductPage": true,
"firstSeenDate": "2022-11-24",
"lastSeenDate": "2023-03-22",
"impressionShare": 43.18181818181818,
"promotionalText": "",
"url": "https://apps.apple.com/us/app/id1596684882?platform=iphone",
"screenshotList": [
"https://is4-ssl.mzstatic.com/image/thumb/PurpleSource112/v4/5f/db/c4/5fdbc437-3ce7-a41c-d279-d29b0ca84eb2/09b8116d-6692-45e0-ba25-9c379caa50b5_1.jpg/576x1024.png",
"https://is4-ssl.mzstatic.com/image/thumb/PurpleSource122/v4/ef/4f/0e/ef4f0ed7-9634-dbee-81a1-855cf2c4f8d0/dbe58fcc-0012-4d97-9f6d-85d6d95cfea3_2.jpg/576x1024.png",
"https://is3-ssl.mzstatic.com/image/thumb/PurpleSource122/v4/5e/78/bc/5e78bca3-df09-ec4a-5852-9bc8972677ae/842c154a-1028-4edd-aff6-1e838e131241_3.jpg/576x1024.png",
"https://is2-ssl.mzstatic.com/image/thumb/PurpleSource112/v4/ff/f9/c2/fff9c228-52e7-136d-c913-e7d95782a8dd/8ac396da-8ccc-4fcf-b003-5fa97ab43e7f_4.jpg/576x1024.png",
"https://is3-ssl.mzstatic.com/image/thumb/PurpleSource112/v4/55/91/50/559150f4-1f8b-4d35-f717-35fb0392cfab/213f39f4-e0e8-4f7b-b0a4-7231187f7a6c_5.jpg/576x1024.png"
],
"videoList": [
"https://apptrailers.itunes.apple.com/itunes-assets/PurpleVideo112/v4/f7/61/c6/f761c6b7-ba9a-d872-f9f1-476dd5ac0704/P471143396_default.m3u8"
]
},
{
"trackId": 1461037869,
"cppId": null,
"productPageType": null,
"defaultProductPage": true,
"firstSeenDate": "2023-01-05",
"lastSeenDate": "2023-02-21",
"impressionShare": 6.25,
"promotionalText": "",
"url": "https://apps.apple.com/us/app/id1461037869?platform=iphone",
"screenshotList": [
"https://is4-ssl.mzstatic.com/image/thumb/PurpleSource115/v4/7b/0e/43/7b0e4328-4f72-4426-c585-e4fbac5d2272/366bffa4-5131-4013-86e6-b951b88aff75_1.jpg/576x1024.png",
"https://is2-ssl.mzstatic.com/image/thumb/PurpleSource125/v4/87/7b/64/877b64a5-e2b0-a1aa-8ee2-a78530b95d41/67b2e41a-c88d-4df6-870c-302a1d988457_2.jpg/576x1024.png",
"https://is2-ssl.mzstatic.com/image/thumb/PurpleSource125/v4/71/83/15/71831520-b3b7-1b25-c25d-2cbca65a0209/559fbe2f-13c6-4706-bac6-a2056ae274a3_3.jpg/576x1024.png",
"https://is2-ssl.mzstatic.com/image/thumb/PurpleSource115/v4/42/97/1e/42971eb7-c5da-2ac3-5eb0-6c9b59c1210a/a5d425c0-1c25-4d26-b726-f24f7f45ec02_4.jpg/576x1024.png",
"https://is4-ssl.mzstatic.com/image/thumb/PurpleSource115/v4/f7/bf/93/f7bf9320-1e14-623b-9dfe-38eb553d30a7/95e4b3f1-4f0d-4458-9527-38597619d644_5.jpg/576x1024.png",
"https://is4-ssl.mzstatic.com/image/thumb/PurpleSource125/v4/cf/0a/fa/cf0afa5a-e6c4-0439-3860-4f6760948adb/be175dd2-bc61-44fd-b101-f42d777f37c0_6.jpg/576x1024.png"
],
"videoList": [
"https://apptrailers.itunes.apple.com/itunes-assets/PurpleVideo116/v4/2b/f9/61/2bf96143-92c2-140d-beca-da94a7c4bc91/P386003719_default.m3u8"
]
}
]
This endpoint allows users to search for CPPs (Custom Product Pages) by category and retrieves their screenshots, promotional texts, and videos. CPPs can be filtered by startDate and endDate.
GET /searchads-stats/cpps-by-category?categoryId={CATEGORY_ID}&startDate={START_DATE}&endDate={END_DATE}&country={COUNTRY}&page={PAGE)&token={YOUR_API_KEY}
Request Parameters
Field | Description |
---|---|
categoryId |
(required) Category id of app |
startDate |
(required) Start date with ISO Date Format (yyyy-MM-dd) and max date range is 30 days. If date range exceed it, End Date automatically set 30 days from Start Date. |
endDate |
(required) End date of with ISO Date Format (yyyy-MM-dd) and max date range is 30 days. If date range exceed it, End Date automatically set 30 days from Start Date. |
country |
(optional) Two letter country code, if it's not specified, returns for all countries. |
page |
(required) Returns maximum 100 CPPs per request, use this parameter to iterate, defaults to 0 |
Response Fields
Field | Description |
---|---|
trackId |
APP_TRACK_ID(number) |
cppId |
CPP_ID(string or null) |
productPageType |
[DESCRIPTION,PROMOTION,IMAGE,VIDEO](enum or null) |
defaultProductPage |
true(boolean) |
firstSeenDate |
YYYY-MM-DD(date) |
lastSeenDate |
YYYY-MM-DD(date) |
impressionShare |
IMPRESSION_SHARE(float number) |
promotionalText |
TEXT(string) |
url |
CPP_URL(string) |
screenshotList |
[URL_1,URL_2](string array) |
videoList |
[URL_1,URL_2](string array) |
curl "https://api.mobileaction.co/searchads-stats/cpps-by-category?categoryId=6014&startDate=2023-02-01&endDate=2023-03-01&country=US&page=0&token=YOUR_API_KEY"
[
{
"trackId": 1371565796,
"cppId": "3e5d6f05-7369-4d44-bdd5-d3c332f2bb04",
"productPageType": null,
"defaultProductPage": false,
"firstSeenDate": "2022-11-25",
"lastSeenDate": "2023-04-10",
"impressionShare": 0.0,
"promotionalText": "",
"url": "https://apps.apple.com/us/app/id1371565796?platform=iphone&ppid=3e5d6f05-7369-4d44-bdd5-d3c332f2bb04",
"screenshotList": [
"https://is1-ssl.mzstatic.com/image/thumb/Purple126/v4/86/a9/19/86a919e5-d678-5507-5f23-9b0fece895f7/6a1fa11b-0c4c-4abf-a706-0a0621e875d4_RAD_ASO_Screenshots_RPGtext_B123826_2208x1242_iOS_English_U0026IMG_U003d2NJM.jpg/1024x576.png",
"https://is2-ssl.mzstatic.com/image/thumb/Purple126/v4/e6/35/bf/e635bf79-580d-1232-48a9-eff97f681cdb/d1d5cc5b-d8d9-49c7-8f62-f3a360983df9_RAD_ASO_Screenshots_RPGtext_B123832_2208x1242_iOS_English_U0026IMG_U003d2NJS.jpg/1024x576.png",
"https://is1-ssl.mzstatic.com/image/thumb/Purple116/v4/2f/9e/cd/2f9ecd8f-878c-9a19-4b14-b03595c053b2/7cacc207-fdcc-4f1f-8ac9-3e31c44593f7_RAD_ASO_Screenshots_RPGtext_B123828_2208x1242_iOS_English_U0026IMG_U003d2NJO.jpg/1024x576.png",
"https://is4-ssl.mzstatic.com/image/thumb/Purple116/v4/81/fa/5e/81fa5edc-5ab3-5511-6ef7-ab9c9e91308d/92d18c39-5596-42e0-9d57-092c7db1c200_RAD_ASO_Screenshots_RPGtext_B123829_2208x1242_iOS_English_U0026IMG_U003d2NJP.jpg/1024x576.png",
"https://is4-ssl.mzstatic.com/image/thumb/Purple126/v4/2d/71/3a/2d713a49-3bd4-2996-d3b2-2de1ca90de3c/pr_source.jpg/1024x576.png",
"https://is1-ssl.mzstatic.com/image/thumb/Purple116/v4/9a/87/22/9a872262-dd94-b0ea-44e7-9fb7a5035fc8/c4b1e923-7096-4a2b-99bf-c6544802ac56_RAD_Viva_Hydra-Windowed-01_EN_2208x1242_6543.jpg/1024x576.png"
],
"videoList": [
"https://apptrailers.itunes.apple.com/itunes-assets/PurpleVideo122/v4/a9/8c/ea/a98cea7d-3edf-c28e-35b9-3cbdd3df0ba6/P472258760_default.m3u8"
]
},
{
"trackId": 1071310449,
"cppId": "f319e91c-272b-46df-a5a8-d51263d380fe",
"productPageType": null,
"defaultProductPage": false,
"firstSeenDate": "2022-11-25",
"lastSeenDate": "2023-04-01",
"impressionShare": 0.0,
"promotionalText": "",
"url": "https://apps.apple.com/us/app/id1071310449?platform=iphone&ppid=f319e91c-272b-46df-a5a8-d51263d380fe",
"screenshotList": [
"https://is4-ssl.mzstatic.com/image/thumb/PurpleSource116/v4/b1/10/68/b11068ed-4040-8b2f-ebfc-c8869d66f17a/e54e6e03-237d-4c81-856c-a3703bf6bf8b_CCP-ASA_1242x2208_LGBTQ_U0028Freshman_U0029.jpg/576x1024.png",
"https://is2-ssl.mzstatic.com/image/thumb/PurpleSource116/v4/ab/ac/23/abac2363-a847-a8b2-28e7-9e6d44242a6b/16ab437c-ce72-4103-80e1-9cec6da915d4_CCP-ASA_1242x2208_LGBTQ-Erotic_U0028Custom_U0029.jpg/576x1024.png",
"https://is3-ssl.mzstatic.com/image/thumb/PurpleSource126/v4/a8/d6/81/a8d68104-4f5b-d502-f536-fd1d5fdaaea1/4431cd11-2dbd-4faa-84a1-627d123059e1_CCP-ASA_1242x2208_Fantasy_U0028Elementalists_U0029.jpg/576x1024.png",
"https://is4-ssl.mzstatic.com/image/thumb/PurpleSource126/v4/76/c6/40/76c640ec-76d6-40f1-49ad-6aabbdbb682f/a2c7b371-8727-43f3-afc8-cd968f6f9c11_CCP-ASA_1242x2208_Adventure_U0028Blades_U0029.jpg/576x1024.png",
"https://is3-ssl.mzstatic.com/image/thumb/Purple126/v4/68/c1/1d/68c11df3-6cc2-8144-dcd1-cb924b8ce701/ed3672a5-0b9b-4bd3-9d59-8dd5c677321f_2020Oct_App-Screenshots_1242x2208_ChooseMagic.jpg/576x1024.png",
"https://is2-ssl.mzstatic.com/image/thumb/Purple126/v4/19/eb/0c/19eb0ca3-36fa-9395-23ed-09ec54da618c/tns.eellhjpw.jpg/576x1024.png",
"https://is2-ssl.mzstatic.com/image/thumb/Purple116/v4/35/92/f3/3592f39e-35e3-1952-f96d-5f4769d24b09/1e13e09c-e453-446a-9514-ce4c2e3793ad_2022Jan_App-Screenshots_1242x2208.jpg/576x1024.png"
],
"videoList": []
}
]
This endpoint allows users to retrieve searched apps’ paid keywords associated with their CPPs.
GET /searchads-stats/cpp-keywords/{APP_TRACK_ID}/{CPP_ID}&startDate={START_DATE}&endDate={END_DATE}&country={COUNTRY}&page={PAGE}&token={YOUR_API_KEY}
Request Parameters
Field | Description |
---|---|
categoryId |
(required) Category id of app |
cppId |
(required) CPP Id |
startDate |
(required) Start date with ISO Date Format (yyyy-MM-dd) and max date range is 30 days. If date range exceed it, End Date automatically set 30 days from Start Date. |
endDate |
(required) End date of with ISO Date Format (yyyy-MM-dd) and max date range is 30 days. If date range exceed it, End Date automatically set 30 days from Start Date. |
page |
(required) Returns maximum 100 CPPs per request, use this parameter to iterate, defaults to 0 |
country |
(optional) Two letter country code |
Response Fields
Field | Description |
---|---|
keyword |
KEYWORDS_OF_THE_CPP(string array) |
curl "https://api.mobileaction.co/searchads-stats/cpp-keywords/571800810/74b18c22-1be3-4c7e-9b7d-a0ebd59bb9fb?startDate=2023-02-01&endDate=2023-03-01&country=US&page=0&token=YOUR_API_KEY"
[
"abide bible & sleep meditation",
"abide bible sleep meditation",
"asrm",
"free sleep sounds app",
"help to sleep",
"sleep stories for adults",
"sleep story",
"sleep times",
"sounds rain",
"meditation music for sleep",
"meditations for sleep",
"moshi",
"sleep & meditation",
"sleep machine",
"sleep music",
"sleep story app",
"sleep white noise",
"sleeping app free",
"sleeping apps",
"sllep",
"smr",
"sounds for sleep",
"sounds to sleep",
"amsr",
"apps to help you sleep",
"baby sleep",
"baby's sleep",
"bed time story",
"free sleep apps",
"sleep & noise",
"sleep app free",
"sleep musics",
"sleepcycle",
"sleepy music",
"sound to sleep",
"bed time music",
"slee-p",
"sleep app",
"sleep meditation app",
"sleep stories",
"sleep++",
"sleeping sound",
"sleepiq",
"sleepy sounds",
"asmr",
"baby sleep +",
"free sleep sounds",
"machine sound",
"sleep apps free",
"sleep cycle",
"sleep sounds free",
"sleep timer",
"sleep+",
"white noise sleep",
"asm",
"bedtime",
"deep sleep",
"free sleep stories",
"help sleep",
"slee",
"sleep +",
"sleep ++",
"sleep meditation",
"sleeping apps free",
"sleeping music app",
"bedtime music",
"free sleeping app",
"sleep & music",
"sleep meditations free",
"adult bedtime stories",
"auto sleep",
"bedtime story",
"free sleeping apps",
"relax and sleep well",
"sleep",
"sleep aid",
"sleep better",
"sleep meditation free",
"sleep stories free",
"sleep time",
"sleepscore"
]