Mobile Action API Documentation

Ad Intelligence Services

This section describes Ad Intelligence based API services.

Get Creatives

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.

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

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

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

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

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

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

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

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

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

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

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

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

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.

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

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

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
            }
        ]
    }
}

Try MobileAction free for a week!

No credit card required.