Contact |Login| Go to SearchAds
Blog
Pricing
Schedule a demo Sign up free

Mobile Action API Documentation

Introduction
Dashboard Services
App Store Services
Google Play Store Services
Ad Intelligence Services
Search Ads
CPP Intelligence Services
Other Services

Ad Intelligence Services

This section describes Ad Intelligence based API services.

Get Creatives ( 200 Credits / Request )

This endpoint provides list of creatives belong to an app. They can be filtered by fields like startDate, endDate, network and category. Every field for this endpoint should be placed as query parameter. Max 30 days data allowed for a single request.

!> Note: This endpoint uses unique trackId provided by ITunes Connect and Play Store e.g. For Facebook iOS: 284882215 and for Facebook Android: com.facebook.katana

GET /ad-intelligence/get-creatives-by-track-id?trackId={trackId}&token=YOUR_API_KEY

Request Parameters





Parameter
Description






trackId
(required) Track id of the app




token
(required) API key

Other Parameters





Parameter
Description






page
dataset start cursor, default 1, 50 items per page




startDate
start date for the query (YYYY-MM-DD) format




endDate
end date for the query (YYYY-MM-DD) format




countryCode
2 letter country code




network
network name




mediaType
media type id

Response Fields





Field
Description






status
Status of the request




data
JSON object contains the data

Example request

curl "https://api.mobileaction.co/ad-intelligence/get-creatives-by-track-id?trackId=571800810&start=2018-01-01&end=2018-06-01&countryCode=US&page=1&size=1&token=YOUR_API_KEY"

Example response

{
    "currentPage": 1,
    "perPage": 10,
    "total": 390,
    "totalPages": 39,
    "data": [
        {
            "countryCode": [
                "US"
            ],
            "network": [
                {
                    "title": "Facebook",
                    "id": 1,
                    "class": "Facebook"
                }
            ],
            "mediaUrl": "https://s3.amazonaws.com/mobileaction.ad.public/v4/ios/Facebook/571800810/2020/7/6/22/13/30db2957e7c6f930e192969b3243c44e.jpg",
            "mediaOriginalUrl": "https://scontent-dfw5-2.xx.fbcdn.net/v/t15.5256-10/s417x417/104062576_606866926855108_1595389129282194913_n.jpg?_nc_cat=108&_nc_sid=ad6a45&_nc_ohc=jS8_-In6f2MAX_S6GsO&_nc_ht=scontent-dfw5-2.xx&oh=6d5242c5e4bbc67685896d90b0a36776&oe=5F2A8429",
            "previewUrl": "https://s3.amazonaws.com/mobileaction.ad.public/v4/ios/Facebook/571800810/2020/7/6/22/13/30db2957e7c6f930e192969b3243c44e.jpg",
            "resourceMedia": 7787109,
            "resourceMediaUrl": null,
            "mediaType": 1,
            "mediaId": 7787109,
            "tagType": "Image,Interstitial",
            "firstSeen": 2,
            "lastSeen": 2,
            "properties": {
                "size": "22.18 kB",
                "width": 333,
                "height": 417
            },
            "platformId": 2,
            "appId": 11030,
            "title": "Calm",
            "subtitle": "The most relaxing app in the world",
            "action": "Install Now",
            "iconUrl": "https://is3-ssl.mzstatic.com/image/thumb/Purple113/v4/2a/4d/e1/2a4de13c-83e2-492b-1bc0-0945c4eb35fd/AppIcon-0-0-1x_U007emarketing-0-0-0-10-0-0-sRGB-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/60x60bb.png",
            "fullName": "Calm",
            "trackId": "571800810",
            "category": "Health & Fitness",
            "categoryId": 6013,
            "impression": 0.01,
            "mediaFormat": [
                2,
                3
            ],
            "duration": 1,
            "lastSeenDate": "2020-07-06T00:00:00.000Z",
            "firstSeenDate": "2020-07-06T00:00:00.000Z",
            "hashedMediaId": "wpzklj9v"
        }
    ]
}

Check Badge ( 5 Credits / Request )

Check if the given app is an advertiser or a publisher.

GET /ad-intelligence/check-badge?trackId={trackId}&token=YOUR_API_KEY

Request Parameters





Parameter
Description






trackId
(required) Track id of the app




token
(required) API key

Response Parameters





Field
Description






appAdvertiser
Boolean value for if the app is an advertiser




appPublisher
Boolean value for if the app is an publisher

Example request

curl "https://api.mobileaction.co/ad-intelligence/check-badge?trackId=571800810&token=YOUR_API_KEY"

Example response

{
    "data": {
        "appAdvertiser": true,
        "appPublisher": false
    }
}

Country Distribution ( 10 Credits / Request )

Provides country distribution data for the given app. Max 30 days of data allowed for a single request.

GET /ad-intelligence/country_distribution?trackId={trackId}&startDate={startDate}&endDate={endDate}&token=YOUR_API_KEY

Request Parameters





Parameter
Description






token
(required) API key




trackId
(required) Track id of the app




startDate
(required) YYYY-MM-DD formatted start date




endDate
(required) YYYY-MM-DD formatted end date




mediaType
Media type (1 = Creatives, 2 = Impressions)




countryCode
Two letter country code

Response Parameters





Field
Description






name
Country name




code
Alpha 2 country code




code3
Alpha 3 country code




percent
Country distribution rate

Example request

curl "https://api.mobileaction.co/ad-intelligence/country_distribution?trackId=571800810&startDate=2020-07-01&endDate=2020-07-05&countryCode=US&token=YOUR_API_KEY"

Example response

{
    "data": [
        {
            "name": "United States",
            "code": "US",
            "code3": "USA",
            "percent": 100
        }
    ]
}

Creative Dimension Distribution ( 20 Credits / Request )

Provides creative dimension distribution data for the given parameters. Max 30 days of data allowed for a single request.

GET /ad-intelligence/creative_dimension_distribution?trackId={trackId}&countryCode={countryCode}&mediaType={mediaType}&network={network}&startDate={startDate}&endDate={endDate}&token=YOUR_API_KEY

Request Parameters





Parameter
Description






token
(required) API key




trackId
(required) Track id of the app




startDate
(required) YYYY-MM-DD formatted start date




endDate
(required) YYYY-MM-DD formatted end date




mediaType
Media type (1 = Creatives, 2 = Impressions)




countryCode
Two letter country code




network
network name filter

Response Parameters





Field
Description






imageCreative
Image creative data, contains name and percentage of creatives




videoCreative
Video creative data, contains name and percentage of creatives




htmlCreative
HTML creative data, contains name and percentage of creatives

Example request

curl "https://api.mobileaction.co/ad-intelligence/creative_dimension_distribution?trackId=571800810&startDate=2020-07-01&endDate=2020-07-03&countryCode=US&network=twitter&token=YOUR_API_KEY"

Example response

{
    "data": {
        "imageCreative": [
            {
                "name": "333x417",
                "percent": 47
            },
            {
                "name": "392x696",
                "percent": 21
            }
        ],
        "videoCreative": [
            {
                "name": "320x400",
                "percent": 33
            },
            {
                "name": "1024x1280",
                "percent": 13
            }
        ],
        "htmlCreative": [
            {
                "name": "375x50",
                "percent": 50
            },
            {
                "name": "320x568",
                "percent": 25
            }
        ]
    }
}

Creative Type Distribution ( 20 Credits / Request )

Provides creative type distribution data for the given parameters. Max 30 days of data allowed for a single request.

GET /ad-intelligence/creative_type_distribution?trackId={trackId}&countryCode={countryCode}&mediaType={mediaType}&network={network}&startDate={startDate}&endDate={endDate}&token=YOUR_API_KEY

Request Parameters





Parameter
Description






token
(required) API key




trackId
(required) Track id of the app




startDate
(required) YYYY-MM-DD formatted start date




endDate
(required) YYYY-MM-DD formatted end date




mediaType
Media type (1 = Creatives, 2 = Impressions)




countryCode
Two letter country code




network
network name filter

Response Parameters





Field
Description






imagePercent
Percentage of Image creative data




videoPercent
Percentage of Video creative data




htmlPercent
Percentage of HTML creative data




playablePercent
Percentage of Playable creative data

Example request

curl "https://api.mobileaction.co/ad-intelligence/creative_type_distribution?trackId=571800810&startDate=2020-07-01&endDate=2020-07-03&countryCode=US&token=YOUR_API_KEY"

Example response

{
    "data": {
        "imagePercent": 28.4,
        "videoPercent": 62.7,
        "playablePercent": 4.9,
        "htmlPercent": 3.9
    }
}

Language Distribution ( 10 Credits / Request )

Provides language distribution data for the given app. Max 30 days of data allowed for a single request.

GET /ad-intelligence/language_distribution?trackId={trackId}&startDate={startDate}&endDate={endDate}&token=YOUR_API_KEY

Request Parameters





Parameter
Description






token
(required) API key




trackId
(required) Track id of the app




startDate
(required) YYYY-MM-DD formatted start date




endDate
(required) YYYY-MM-DD formatted end date




countryCode
Two letter country code

Response Parameters





Field
Description






name
Language name




percentage
Language percentage

Example request

curl "https://api.mobileaction.co/ad-intelligence/language_distribution?trackId=571800810&startDate=2020-07-01&endDate=2020-07-05&token=YOUR_API_KEY"

Example response

{
    "data": [
        {
            "name": "English",
            "percent": 96
        },
        {
            "name": "Spanish",
            "percent": 3
        },
        {
            "name": "French",
            "percent": 1
        }
    ]
}

Network Distribution ( 10 Credits / Request )

Provides network distribution data for the given app. Max 30 days of data allowed for a single request.

GET /ad-intelligence/network_distribution?trackId={trackId}&startDate={startDate}&endDate={endDate}&token=YOUR_API_KEY

Request Parameters





Parameter
Description






token
(required) API key




trackId
(required) Track id of the app




startDate
(required) YYYY-MM-DD formatted start date




endDate
(required) YYYY-MM-DD formatted end date




mediaType
Media type (1 = Creatives, 2 = Impressions)




countryCode
Two letter country code

Response Parameters





Field
Description






title
Network name




percent
Network percentage

Example request

curl "https://api.mobileaction.co/ad-intelligence/network_distribution?trackId=571800810&startDate=2020-07-01&endDate=2020-07-05&token=YOUR_API_KEY"

Example response

{
    "data": [
        {
            "title": "facebook",
            "percent": 42
        },
        {
            "title": "Instagram",
            "percent": 15
        },
        {
            "title": "Facebook Native",
            "percent": 15
        },
        {
            "title": "Messenger",
            "percent": 12
        },
        {
            "title": "tapjoy",
            "percent": 6
        },
        {
            "title": "admob",
            "percent": 4
        },
        {
            "title": "ironsource",
            "percent": 2
        },
        {
            "title": "applovin",
            "percent": 2
        },
        {
            "title": "unity",
            "percent": 0.806451612903226
        },
        {
            "title": "tiktok",
            "percent": 0.6048387096774194
        },
        {
            "title": "mopub",
            "percent": 0.403225806451613
        }
    ]
}

Top Advertisers ( 150 Credits / Request )

This endpoint provides list of top advertisers. They can be filtered by fields like startDate, endDate, network and category. Every field for this endpoint should be placed as query parameter. Max 30 days data allowed for a single request.

GET /ad-intelligence/top-advertisers?token=YOUR_API_KEY

Request Parameters





Parameter
Description






token
(required) API key




page
dataset start cursor, default 1, 50 items per page




startDate
begin date for the query (YYYY-MM-DD) format




endDate
end date for the query (YYYY-MM-DD) format




countryCode
two letter country code




platformId
store platform id (1 = PlayStore, 2 = AppStore)




category
category filter for the query




network
network name filter




firstSeen
first seen date of apps found as advertisers

Response Fields





Field
Description






currentPage
Current page




perPage
Number of items per page




total
Total number of items




totalPages
Total number of pages




data
An array of requested data

Example request

curl "https://api.mobileaction.co/ad-intelligence/top-advertisers?token=YOUR_API_KEY&startDate=2019-12-01&endDate=2019-12-08&page=1&size=1"

Example response

{
    "currentPage": 1,
    "perPage": 30,
    "total": 4454,
    "totalPages": 149,
    "data": [
        {
            "isAdvertiser": true,
            "isPublisher": false,
            "adCount": 189563,
            "creativeCount": 1308,
            "networks": [
                {
                    "title": "Facebook",
                    "class": "Facebook"
                },
                {
                    "title": "Vungle",
                    "class": "Vungle"
                },
                {
                    "title": "Unity",
                    "class": "Unity"
                },
                {
                    "title": "AdMob",
                    "class": "Admob"
                },
                {
                    "title": "AdColony",
                    "class": "Adcolony"
                },
                {
                    "title": "Mopub",
                    "class": "Mopub"
                },
                {
                    "title": "Tapjoy",
                    "class": "Tapjoy"
                },
                {
                    "title": "Youtube",
                    "class": "Youtube"
                }
            ],
            "countries": [
                {
                    "title": "United States",
                    "countryCode": "US"
                }
            ],
            "platform": 1,
            "appId": 172,
            "iconUrl": "https://lh3.googleusercontent.com/z5nin1RdQ4UZhv6fa1FNG7VE33imGqPgC4kKZIUjgf_up7E-Pj3AaojlMPwNNXaeGA=s180",
            "fullName": "TikTok - Make Your Day",
            "trackId": "com.zhiliaoapp.musically",
            "developerName": "TikTok Inc.",
            "developerId": null,
            "category": "Social",
            "categoryId": 19,
            "networkCount": 8
        }
    ]
}

Ad Publisher Creative Dimension Distribution ( 50 Credits / Request )

This endpoint provides ad publishers' media type and dimension of the given creative with dimension percentages. Max 30 days data allowed for a single request.

GET /ad-intelligence/ad-publisher/creative_dimension_distribution?trackId={trackId}&startDate={startDate}&endDate={endDate}&token={YOUR_API_TOKEN}

Request Parameters





Parameter
Description






token
(required) API Key




trackId
(required) Application track id




startDate
(required) Start date in YYYY-MM-DD format




endDate
(required) End date in YYYY-MM-DD format

Response Fields





Field
Description






mediaType
Creative media type




dimensions
Creative media dimension




percentage
Creative media dimension percentage

Example request

curl "https://api.mobileaction.co/ad-intelligence/ad-publisher/creative_dimension_distribution?trackId=1195621598&startDate=2020-08-30&endDate=2020-08-31&token=YOUR_API_KEY"

Example Response

{
    "data": {
        "Video": [
            {
                "mediaType": "Video",
                "dimensions": "360x640",
                "percentage": 8.85
            },
            {
                "mediaType": "Video",
                "dimensions": "720x1280",
                "percentage": 5.87
            }
        ],
        "Rewarded": [
            {
                "mediaType": "Rewarded",
                "dimensions": "360x640",
                "percentage": 3.04
            },
            {
                "mediaType": "Rewarded",
                "dimensions": "375x667",
                "percentage": 1.41
            }
        ],
        "Interstitial": [
            {
                "mediaType": "Interstitial",
                "dimensions": "360x640",
                "percentage": 0.87
            },
            {
                "mediaType": "Interstitial",
                "dimensions": "375x667",
                "percentage": 0.65
            }
        ]
    }
}

Start for free - upgrade anytime!

No credit card required.

Company

Products

Resources

Recent Blog Posts

| Go to SearchAds.com
Company
Products
Resources
Recent Blog Posts