Get risk ratings and reputation for one mobile app

GET

https://api.pixalate.com/api/v2/mrt/apps/:appId

GET

/api/v2/mrt/apps/:appId

curl -G https://api.pixalate.com/api/v2/mrt/apps/1407852246 \
     -H "x-api-key: <apiKey>" \
     -d device=smartphone \
     -d region=APAC

{
  "status": "OK",
  "numFound": 1,
  "docs": [
    {
      "appId": "1407852246",
      "region": "APAC",
      "device": "smartphone",
      "appStore": "android",
      "appOverview": {
        "appTitle": "Example App",
        "screenshotUrls": [
          "https://example.com/image/screenshot-1.png",
          "https://example.com/image/screenshot-2.png"
        ],
        "description": "An example app.",
        "iabPrimaryCategory": [
          "Video Gaming"
        ],
        "iabSubCategory": [
          "Mobile Games"
        ],
        "appStoreCategories": [
          "Games"
        ],
        "delistedDate": "2021-10-30",
        "delistedApp": false,
        "hasDangerousPermissions": false
      },
      "appDetails": {
        "bundleId": "com.example.ios",
        "trackId": "1407852246",
        "appStoreUrl": "https://apps.apple.com/us/app/example/id1407852246?uo=4",
        "appLastUpdatedDate": "2021-10-30",
        "trustedSeller": "Example",
        "incentivizedActivity": true,
        "downloadRange": "500000000 - 1000000000",
        "averageUserRating": 4,
        "contentRating": "Everyone",
        "blocklisted": false,
        "blocklistedReasons": [
          "App is No Longer in Active Use",
          "The app is a VPN"
        ],
        "adCapabilities": {
          "topDevice": "Generic Android",
          "displayTopAdsize": "336x280",
          "videoTopAdsize": "768x1024",
          "displayContribution": 95.23,
          "videoContribution": 4.77,
          "hyperLocationAvailability": 98.78,
          "mraidVersion": "3.0",
          "adsDetected": true
        },
        "interactiveELements": [
          "Shares Location",
          "Users Interact"
        ]
      },
      "pixalateAdvisories": {
        "hasAppAdsTxt": false,
        "delistedApp": true,
        "delistedDate": "2021-10-30",
        "hasDangerousPermissions": false,
        "blocklisted": false,
        "privateDomain": false,
        "hasTermsAndConditions": true,
        "hasPrivacyPolicy": true
      },
      "appAdvisories": [
        "An example advisory",
        "Another advisory"
      ],
      "riskOverview": {
        "ivt": 10.12,
        "ivtRisk": "medium",
        "viewability": 66.05,
        "viewabilityRisk": "medium",
        "descriptionBrandSafetyRisk": "low",
        "contentBrandSafetyRisk": "low",
        "overallIvtPermissionRisk": "low",
        "risk": [
          {
            "region": "APAC",
            "device": "smartphone",
            "pixalateRisk": "medium",
            "pixalateRiskReasons": [
              "Significantly Elevated IVT Percentage",
              "Ad Traffic Shows Some Suspicious Characteristics"
            ]
          }
        ]
      },
      "developerOverview": {
        "developerName": "Acme Apps",
        "developerLocation": "J. Doe, Main Street, Anywhere USA",
        "developerEmail": "jdoe@example.org",
        "developerCountry": "US",
        "developerWebsite": "https://www.example.org",
        "developerTotalApps": 4,
        "privateDomain": false,
        "hasTermsAndConditions": true,
        "hasPrivacyPolicy": true,
        "facebookRisk": "low",
        "linkedInRisk": "low",
        "twitterRisk": "low"
      },
      "trafficOverview": {
        "spoofingRisk": "low",
        "locationMaskingRisk": "low",
        "advertisingIvtRisk": "low",
        "clickIvtRisk": "low",
        "viewabilityRisk": "low",
        "estimatedDailyActiveUsers": 1000000,
        "estimatedMonthlyActiveUsers": 20000000,
        "inventory": 22000000,
        "adSpend": 69000
      },
      "brandSafety": {
        "descriptionBrandSafety": {
          "descriptionBrandSafetyRisk": "medium",
          "advisoriesRisk": "medium",
          "adultContentRisk": "high",
          "drugContentRisk": "medium",
          "alcoholContentRisk": "medium",
          "hateSpeechRisk": "low",
          "offensiveContentRisk": "medium",
          "gamblingContentRisk": "medium",
          "violenceContentRisk": "low"
        },
        "contentBrandSafety": {
          "contentBrandSafetyRisk": "medium",
          "adultRisk": "low",
          "violenceRisk": "medium",
          "imageData": [
            {
              "url": "https://example.org/images/kxipXQ3huWkwsqokX66euP.png",
              "text": "Weather Radar",
              "violenceRisk": "low",
              "spoofRisk": "low",
              "medicalRisk": "low",
              "adultRisk": "low"
            }
          ]
        }
      },
      "appPermissions": {
        "ivtPermissionRisk": "medium",
        "permissions": [
          {
            "name": "ACCESS_BACKGROUND_LOCATION",
            "description": "Allows an app to access location in the background.",
            "isDangerous": "false;",
            "ivtPermissonRisk": "medium"
          }
        ]
      },
      "trafficOverlap": {
        "userOverlap": 8.7,
        "inventoryOverlap": 3.1
      },
      "authorizedSellers": [
        {
          "exchange": "Acme Exchange",
          "paymentType": "Direct",
          "inventory": 30039,
          "inventoryRatio": 12.87,
          "ivt": 0.9,
          "videoInventoryRatio": 1.4,
          "viewability": 79.28
        }
      ],
      "invalidTraffic": {
        "ivt": 7.76,
        "givt": 0.29,
        "sivt": 7.47,
        "givtTypes": [
          {
            "fraudType": "Data Center",
            "givt": 0.29
          }
        ],
        "sivtTypes": [
          {
            "fraudType": "AppSpoofing",
            "sivt": 2.78
          }
        ]
      },
      "viewability": {
        "viewability": 66.05,
        "viewabilityRisk": "medium",
        "byAdSizes": [
          {
            "adSize": "728x90",
            "inventory": 22360289,
            "inventoryRatio": 66.05,
            "viewability": 66.05
          }
        ]
      },
      "inventory": {
        "byDevice": [
          {
            "device": "Apple Iphone",
            "inventory": 1,
            "inventoryRatio": 81.04,
            "ivt": 8.02,
            "viewability": 73.3
          }
        ],
        "byRegion": [
          {
            "region": "APAC",
            "inventory": 1,
            "inventoryRatio": 6.39,
            "ivt": 2.93,
            "viewability": 92.52
          }
        ],
        "byCounty": [
          {
            "countryName": "UK",
            "inventory": 1,
            "inventoryRatio": 1.72,
            "ivt": 8.99,
            "viewability": 94.74
          }
        ],
        "byAdsize": [
          {
            "adSize": "320x50",
            "inventory": 1,
            "inventoryRatio": 3.47,
            "ivt": 12.25,
            "viewability": 98.08
          }
        ],
        "byDma": [
          {
            "dmaName": "NEW YORK",
            "inventory": 1,
            "inventoryRatio": 5.35,
            "ivt": 4.76,
            "viewability": 88.01
          }
        ]
      },
      "ctr": {
        "ctr": 6.03,
        "byAdSize": [
          {
            "adSize": "320x50",
            "ctr": 1.45
          }
        ]
      },
      "availableCountries": [
        "Germany"
      ],
      "rankings": {
        "regionRank": 6473,
        "categoryRank": 3677,
        "category": "Video Games",
        "final": {
          "grade": "C",
          "score": "38"
        },
        "ivt": {
          "grade": "B",
          "score": "62"
        },
        "adsTxt": {
          "grade": "B",
          "score": "62"
        },
        "brandSafety": {
          "grade": "A",
          "score": "99"
        },
        "viewability": {
          "grade": "A",
          "score": "99"
        },
        "permissions": {
          "grade": "N/A",
          "score": "N/A"
        },
        "popularity": {
          "grade": "C",
          "score": "44"
        },
        "globalPopularityRank": "3952"
      },
      "rankingsByCountry": {
        "reach": [
          {
            "countryCode": "ZA",
            "countryName": "South Africa",
            "mauRank": "637",
            "mauRankChange": "-372"
          }
        ],
        "marketShare": [
          {
            "countryCode": "GE",
            "countryName": "Georgia",
            "impressionRank": "359",
            "impsRankChange": "N/A"
          }
        ]
      },
      "coppa": {
        "coppaAudience": "General Audience",
        "coppaAudienceReason": [
          "This app is likely directed to children (including mixed audience) based on manual review"
        ],
        "storeCategory": [
          "All Apps"
        ],
        "storeSubCategory": [
          "Health & Fitness"
        ],
        "contentRating": "Everyone",
        "isApprovedByTeacher": false,
        "ageGroupApprovedByTeacher": "string",
        "coppaViolationRisk": "low",
        "coppaViolationRiskReason": [
          "The COPPA risk is low because the app is likely not directed to children under 13."
        ],
        "privacyPolicyDetected": true,
        "sensitivePermissions": true,
        "transmitsResidentialIP": true,
        "passesLocation": true,
        "permissions": [
          {
            "name": "READ_CONTACTS",
            "description": "Allows an application to read the user's contacts data."
          }
        ]
      },
      "mfa": {
        "mfaRisk": "low",
        "adRefreshRate": 1
      }
    }
  ]
}

The purpose of this API is to provide risk ratings and reputational data for mobile applications. The response is a JSON formatted object containing a list of app information partitioned by region and device.

Authentication

x-api-keystring

Authentication and authorization is achieved by supplying your Pixalate provided API key in the header of the request. An API key may be obtained by signing up for an account on the Pixalate developer website.

Path parameters

appIdstringRequired

The app's unique identifier. This is a package name on Google Play or a track id on Apple app Store.

Query parameters

regionenumOptional

Filter by region. All regions are returned by default. GLOBAL indicates aggregated traffic from all regions.

Allowed values:

deviceenumOptional

Filter by device. All devices are returned by default. GLOBAL indicates aggregated traffic from all devices.

Allowed values:

prettybooleanOptional

If true, return pretty JSON. Default is false.

Response

statusenumOptional

The returned status.

Allowed values:

numFoundintegerOptional

The total number of matching apps.

docslist of objectsOptional

A list of apps.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

5XX

Server Error