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
}
]
}
}Grow your app on the App Store and Google Play Store with our solutions now
