Mobile Action API Documentation

Ad Intelligence Services

This section describes Ad Intelligence based API services.

Get 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.

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

Pagination Parameters

Parameter Description
page dataset start cursor, default 1
size record count per page, default 20

Other Parameters

Parameter Description
startDate begin date for the query (YYYY-MM-DD) format
endDate end date for the query (YYYY-MM-DD) format
network network filter for the query
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
token (required) API key

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

{
    "data": {
        "currentPage": 1,
        "perPage": 1,
        "total": 5625,
        "totalPages": 5625,
        "data": [
            {
                "adCount": 106149,
                "creativeCount": 457,
                "platform": 1,
                "appId": 176,
                "iconUrl": "https://lh3.googleusercontent.com/QLWsdIWGli6a8Jo0kaoV8ip8-YyrCGd2FLeJ-kpD3HAjvrEne3Pk9GqzRwuRzwpGYHY3=s180",
                "fullName": "Empires & Puzzles: RPG Quest",
                "trackId": "com.smallgiantgames.empires",
                "developerName": "Small Giant Games",
                "category": "Game Puzzle",
                "categoryId": 38,
                "networkCount": 8
            }
        ]
    },
    "success": true
}

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.

!> 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/app/TRACK_ID/creatives?token=YOUR_API_KEY

Request Parameters

Parameter Description
token (required) API key
appId (required) Unique app id for each app. These are app ids used by ITunes Connect and Play Store see note above.

Pagination Parameters

Parameter Description
page dataset start cursor, default 1
size record count per page, default 20

Other Parameters

Parameter Description
startDate begin 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/app/571800810/creatives?token=YOUR_API_KEY&start=2018-01-01&end=2018-06-01&countryCode=US&page=1&size=1"

Example response

{
    "data": {
        "currentPage": 1,
        "perPage": 1,
        "total": 1728,
        "totalPages": 1728,
        "data": [
            {
                "total": "1",
                "countryCode": [
                    "US"
                ],
                "network": [
                    {
                        "title": "Applovin",
                        "id": 4,
                        "class": "Applovin"
                    }
                ],
                "mediaUrl": "https://s3.amazonaws.com/mobileaction.ad.public/v3/ios/Applovin/571800810/2020/1/15/20/11/8a8507b16fc39c30286b3a6cc683a7a4.mp4",
                "mediaOriginalUrl": "https://res1.applovin.com/o6bfc851/f50ea85f5e2e87f081720dfcee86d2ea1b2f7cfa_v23_phone.mp4",
                "previewUrl": "https://s3.amazonaws.com/mobileaction.ad.public/v3/ios/Applovin/571800810/thumbnails/8a8507b16fc39c30286b3a6cc683a7a4.jpg",
                "mediaType": 2,
                "mediaId": 3076005,
                "firstSeen": 2,
                "lastSeen": 2,
                "properties": {
                    "size": "876.1 kB",
                    "width": 360,
                    "height": 640,
                    "duration": 13.466666666666669
                },
                "platformId": 2,
                "appId": 11030,
                "title": "",
                "iconUrl": "https://is1-ssl.mzstatic.com/image/thumb/Purple123/v4/08/36/d4/0836d48b-3381-f1b3-57f9-672a623a65c1/source/60x60bb.jpg",
                "fullName": "Calm",
                "trackId": "571800810",
                "category": "Health & Fitness",
                "categoryId": 6013,
                "impression": "0.01",
                "duration": 1
            }
        ]
    },
    "success": true
}

Try MobileAction free for a week!

No credit card required.