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

bash

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

bash

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

json

{
  "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.

bash

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

bash

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

Example response

json

{
  "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.

bash

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

bash

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

json

{
  "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.

bash

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

bash

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

json

{
  "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.

bash

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

bash

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

json

{
  "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.

bash

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

bash

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

json

{
  "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.

bash

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

bash

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

json

{
  "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.

bash

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

bash

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

json

{
  "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.

bash

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

bash

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

json

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

Ad Intelligence Services ​

Get Creatives ( 200 Credits / Request ) ​

Check Badge ( 5 Credits / Request ) ​

Country Distribution ( 10 Credits / Request ) ​

Creative Dimension Distribution ( 20 Credits / Request ) ​

Creative Type Distribution ( 20 Credits / Request ) ​

Language Distribution ( 10 Credits / Request ) ​

Network Distribution ( 10 Credits / Request ) ​

Top Advertisers ( 150 Credits / Request ) ​

Ad Publisher Creative Dimension Distribution ( 50 Credits / Request ) ​

Ad Intelligence Services

Get Creatives ( 200 Credits / Request )

Check Badge ( 5 Credits / Request )

Country Distribution ( 10 Credits / Request )

Creative Dimension Distribution ( 20 Credits / Request )

Creative Type Distribution ( 20 Credits / Request )

Language Distribution ( 10 Credits / Request )

Network Distribution ( 10 Credits / Request )

Top Advertisers ( 150 Credits / Request )

Ad Publisher Creative Dimension Distribution ( 50 Credits / Request )