Mobile Action API Documentation

CPP Intelligence Services

This section describes CPP Intelligence based API services.

CPP by App ( 200 Credit / Request )

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)

Example request

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"

Example response

[
    {
        "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"
        ]
    }
]

CPP by Keyword ( 200 Credit / Request )

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)

Example request

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"

Example response

[
    {
        "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"
        ]
    }
]

CPP by Category ( 200 Credit / Request )

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)

Example request

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"

Example response

[
    {
        "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": []
    }
]

CPP Keywords ( 200 Credit / Request )

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)

Example request

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"

Example response

[
    "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"
]

Start for free - upgrade anytime!

No credit card required.