This section describes Ad Intelligence based API services.
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 |
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"
{
"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 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 |
curl "https://api.mobileaction.co/ad-intelligence/check-badge?trackId=571800810&token=YOUR_API_KEY"
{
"data": {
"appAdvertiser": true,
"appPublisher": false
}
}
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 |
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"
{
"data": [
{
"name": "United States",
"code": "US",
"code3": "USA",
"percent": 100
}
]
}
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 |
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"
{
"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
}
]
}
}
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 |
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"
{
"data": {
"imagePercent": 28.4,
"videoPercent": 62.7,
"playablePercent": 4.9,
"htmlPercent": 3.9
}
}
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 |
curl "https://api.mobileaction.co/ad-intelligence/language_distribution?trackId=571800810&startDate=2020-07-01&endDate=2020-07-05&token=YOUR_API_KEY"
{
"data": [
{
"name": "English",
"percent": 96
},
{
"name": "Spanish",
"percent": 3
},
{
"name": "French",
"percent": 1
}
]
}
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 |
curl "https://api.mobileaction.co/ad-intelligence/network_distribution?trackId=571800810&startDate=2020-07-01&endDate=2020-07-05&token=YOUR_API_KEY"
{
"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
}
]
}
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 |
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"
{
"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
}
]
}
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 |
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"
{
"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
}
]
}
}