API Documentation

Enrichment API - Mobile Apps v2.0.0

Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.

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. Any fields included in the response, but not documented herein are subject to change without notice.

Base URLs:

Email: Pixalate, Inc. Web: Pixalate, Inc.

Authentication

  • API Key (ApiKey)
    • Parameter Name: x-api-key, in: header. 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.

Mobile Apps

Get Mobile Apps Metadata

Code samples

# You can also use wget
        curl -X GET https://api.pixalate.com/api/v2/mrt/apps \
          -H 'Accept: application/json' \
          -H 'x-api-key: API_KEY'
        
        

GET /mrt/apps

The purpose of this API is to provide metadata information for mobile applications in general. The response is a JSON formatted object containing the current user's quota state and the date the mobile applications database was last updated.

Parameters

Name In Type Required Description
pretty query boolean false If true, return pretty JSON. Default is false.

Example responses

200 Response

{
          "database": {
            "lastUpdated": "2022-04-30"
          },
          "quota": {
            "available": 480,
            "used": 520,
            "expiry": "2022-05-01T12:45:23.234Z",
            "limit": 1000,
            "interval": 1000,
            "timeUnit": "month"
          }
        }
        

Responses

Status Meaning Description Schema
200 OK OK Metadata
400 Bad Request Bad Request - Invalid parameters in request. None
401 Unauthorized Unauthorized - Invalid API Key. None
403 Forbidden Forbidden - Quota has been exhausted, Subscription expired or needs upgrade. None
5XX Unknown Server Error - The API experienced an internal error. Contact support. None

Batch Get Mobile Apps Data

Code samples

# You can also use wget
        curl -X POST https://api.pixalate.com/api/v2/mrt/apps \
          -H 'Accept: application/json' \
          -H 'x-api-key: API_KEY'
        
        

POST /mrt/apps

The purpose of this API is to provide risk ratings and reputational data across thousands of mobile applications in a batch mode.

Posted data should be in CSV format where each line consists of a single field which is the Bundle ID or Track ID. The request MIME type should be text/plain.

Once request data is submitted, a URL to a newline-delimited JSON formatted report is provided as a response. While the resulting resource is public, the URL contains a randomly generated identifier that ensures the data is relatively secure unless the URL itself is made public by the user.

The report will not be available for download at the returned URL location until processing has been completed. While creating the report, a request to retrieve the report using the response URL will return an HTTP status code Not Found (404). Once asynchronous processing has completed, the report is returned as normal. If asynchronous processing of a report fails because of an invalid query the request to retrieve the report using the response URL will return an HTTP status code Bad Request (400). Or, if the submitted file contained more than 5000 Bundle ID or Track IDs, then an HTTP status code Request Entity Too Large (413) is returned. Or, if the account's quota limit has been exceeded, then an HTTP status code Forbidden (403) is returned. For all other errors, a request to retrieve the report using the response URL will return an HTTP status code Internal Service Error (500). Client systems should poll the response URL until the report is available, or a non 404 HTTP status code is returned.

This operation requires an Enterprise subscription. Please reach out to us at support@pixalate.com for details on how to enable this for your account.

Parameters

Name In Type Required Description
pretty query boolean false If true, return pretty JSON. Default is false.

Example responses

200 Response

"https://dashboardcdn.pixalate.com/www/exported/Client/2022-04-12/qprdbkr9dfeoostip8ltqgmecd/apps_2022-04-12"
        

Responses

Status Meaning Description Schema
200 OK OK string
400 Bad Request Bad Request - Invalid parameters in request. None
401 Unauthorized Unauthorized - Invalid API Key. None
403 Forbidden Forbidden - Quota has been exhausted, Subscription expired or needs upgrade. None
5XX Unknown Server Error - The API experienced an internal error. Contact support. None

Get Mobile App Data

Code samples

# You can also use wget
        curl -X GET https://api.pixalate.com/api/v2/mrt/apps/{appId} \
          -H 'Accept: application/json' \
          -H 'x-api-key: API_KEY'
        
        

GET /mrt/apps/{appId}

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.

Parameters

Name In Type Required Description
appId path string true The app's unique identifier. This is a package name on Google Play or a track id on Apple app Store.
widget query array[string] false Filter by comma-separated list of widgets to return. All widgets are returned by default.
region query Region false Filter by region. All regions are returned by default. GLOBAL indicates aggregated traffic from all regions.
device query Device false Filter by device. All devices are returned by default. GLOBAL indicates aggregated traffic from all devices.
pretty query boolean false If true, return pretty JSON. Default is false.

Enumerated Values

Parameter Value
widget appOverview
widget appDetails
widget pixalateAdvisories
widget appAdvisories
widget riskOverview
widget developerOverview
widget trafficOverview
widget brandSafety
widget appPermissions
widget trafficOverlap
widget authorizedSellers
widget invalidTraffic
widget viewability
widget inventory
widget ctr
widget availableCountries
widget rankings
widget rankingsByCountry
widget coppa
region GLOBAL
region NA
region EMEA
region LATAM
region APAC
device GLOBAL
device smartphone
device tablet

Example responses

200 Response

{
          "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": null,
                    "inventoryRatio": 81.04,
                    "ivt": 8.02,
                    "viewability": 73.3
                  }
                ],
                "byRegion": [
                  {
                    "region": "APAC",
                    "inventory": null,
                    "inventoryRatio": 6.39,
                    "ivt": 2.93,
                    "viewability": 92.52
                  }
                ],
                "byCounty": [
                  {
                    "countryName": "UK",
                    "inventory": null,
                    "inventoryRatio": 1.72,
                    "ivt": 8.99,
                    "viewability": 94.74
                  }
                ],
                "byAdsize": [
                  {
                    "adSize": "320x50",
                    "inventory": null,
                    "inventoryRatio": 3.47,
                    "ivt": 12.25,
                    "viewability": 98.08
                  }
                ],
                "byDma": [
                  {
                    "dmaName": "NEW YORK",
                    "inventory": null,
                    "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": null,
                "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."
                  }
                ]
              }
            }
          ]
        }
        

Responses

Status Meaning Description Schema
200 OK OK AppList
400 Bad Request Bad Request - Invalid parameters in request. None
401 Unauthorized Unauthorized - Invalid API Key. None
403 Forbidden Forbidden - Quota has been exhausted, Subscription expired or needs upgrade. None
5XX Unknown Server Error - The API experienced an internal error. Contact support. None

Schemas

Metadata

{
          "database": {
            "lastUpdated": "2022-04-30"
          },
          "quota": {
            "available": 480,
            "used": 520,
            "expiry": "2022-05-01T12:45:23.234Z",
            "limit": 1000,
            "interval": 1000,
            "timeUnit": "month"
          }
        }
        
        

Apps metadata information.

Properties

Name Type Required Restrictions Description
database object false none The Mobile Apps database state information.
» lastUpdated string(date) false none The date when the Mobile Apps database was last updated. The date format is YYYY-MM-DD.
quota object false none Quota state information.
» available integer false none The amount of quota available for use.
» used integer false none The amount of quota used.
» expiry string(date) false none The datetime when the quota will be refreshed back to the limit. The datetime format is YYYY-MM-DDTHH:MM:SS.SSSZ.
» limit integer false none The amount of quota to be made available for use when the quota is refreshed.
» interval integer false none The number of time units used in calculating the quota refresh datetime.
» timeUnit string false none The time unit used in calculating the quota refresh datetime.

Enumerated Values

Property Value
timeUnit minute
timeUnit hour
timeUnit day
timeUnit week
timeUnit month

AppList

{
          "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": null,
                    "inventoryRatio": 81.04,
                    "ivt": 8.02,
                    "viewability": 73.3
                  }
                ],
                "byRegion": [
                  {
                    "region": "APAC",
                    "inventory": null,
                    "inventoryRatio": 6.39,
                    "ivt": 2.93,
                    "viewability": 92.52
                  }
                ],
                "byCounty": [
                  {
                    "countryName": "UK",
                    "inventory": null,
                    "inventoryRatio": 1.72,
                    "ivt": 8.99,
                    "viewability": 94.74
                  }
                ],
                "byAdsize": [
                  {
                    "adSize": "320x50",
                    "inventory": null,
                    "inventoryRatio": 3.47,
                    "ivt": 12.25,
                    "viewability": 98.08
                  }
                ],
                "byDma": [
                  {
                    "dmaName": "NEW YORK",
                    "inventory": null,
                    "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": null,
                "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."
                  }
                ]
              }
            }
          ]
        }
        
        

A list of apps.

Properties

Name Type Required Restrictions Description
status Status false none The returned status.
numFound integer false none The total number of matching apps.
docs [App] false none A list of apps.

App

{
          "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": null,
                "inventoryRatio": 81.04,
                "ivt": 8.02,
                "viewability": 73.3
              }
            ],
            "byRegion": [
              {
                "region": "APAC",
                "inventory": null,
                "inventoryRatio": 6.39,
                "ivt": 2.93,
                "viewability": 92.52
              }
            ],
            "byCounty": [
              {
                "countryName": "UK",
                "inventory": null,
                "inventoryRatio": 1.72,
                "ivt": 8.99,
                "viewability": 94.74
              }
            ],
            "byAdsize": [
              {
                "adSize": "320x50",
                "inventory": null,
                "inventoryRatio": 3.47,
                "ivt": 12.25,
                "viewability": 98.08
              }
            ],
            "byDma": [
              {
                "dmaName": "NEW YORK",
                "inventory": null,
                "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": null,
            "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."
              }
            ]
          }
        }
        
        

An app.

Properties

Name Type Required Restrictions Description
appId string false none The app's unique identifier. A package name on Google Play or a track id on Apple app Store.
region Region false none A geographic region. GLOBAL indicates an aggregate of all regions.
device Device false none The device. GLOBAL indicates an aggregate of all devices.
appStore AppStore false none An app store identifier.
appOverview AppOverview false none General information about the app.
appDetails AppDetails false none Detailed information about the app.
pixalateAdvisories PixalateAdvisories false none Pixalate app advisories.
appAdvisories AppAdvisories false none App advisories.
riskOverview RiskOverview false none An overview of risk for the app.
developerOverview DeveloperOverview false none An overview of app's developer information.
trafficOverview TrafficOverview false none An overview of the traffic risk.
brandSafety BrandSafety false none Brand safety information.
appPermissions AppPermissions false none App permissions.
trafficOverlap TrafficOverlap false none Overlap traffic illustrates the most common user journeys from app to app. It leverages shared users to not only connect apps together but also to create relationships between a series of apps. List of apps provided based on overall traffic (byOveralTraffic) and invalid traffic (byIvt).
authorizedSellers AuthorizedSellers false none The contribution of various sell side platforms to programmatic ad impressions sold on the app.
invalidTraffic InvalidTraffic false none The percentage of invalid traffic associated with each Pixalate's taxonomy of GIVT and SIVT invalid traffic types.
viewability Viewability false none The average viewability, according the IAB standard of 50% in view for at least 1 second, for display advertisements in the app.
inventory Inventory false none The estimated volume of programmatic ad impressions broken down by device, region, country, DMA.
ctr Ctr false none Information about Click Through Rate for this app.
availableCountries AvailableCountries false none A list of available countries.
rankings Rankings false none Ranking information about the app.
rankingsByCountry RankingsByCountry false none The reach and market share of the app broken down by country.
coppa Coppa false none Children's Online Privacy Protection Act information.

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
        }
        
        

General information about the app.

Properties

Name Type Required Restrictions Description
appTitle string false none The app title.
screenshotUrls [string] false none A list of app screenshot URLs.
description string false none App description.
iabPrimaryCategory [string] false none The IAB primary categories.
iabSubCategory [string] false none The IAB secondary categories.
appStoreCategories [string] false none App store categories.
delistedDate string(date) false none If app has been delisted from the app store, then this property is the date when delisted. The date format is YYYY-MM-DD.
delistedApp boolean false none A true indicates that app has been delisted from the app store.
hasDangerousPermissions boolean false none A true indicates that the app requests a permission which is dangerous according to the protection level in the Google permission manifest.

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

Detailed information about the app.

Properties

Name Type Required Restrictions Description
bundleId string false none The App bundle identifier. For Google Play it is package name & For app Store it is Unique identifier for the app assigned by apple developer.
trackId string false none The unique identifier for the app assigned by Apple. App Store Only, otherwise null
appStoreUrl string false none The app page on Google Play or App Store.
appLastUpdatedDate string(date) false none The date the app information was last updated. Formatted as YYYY-MM-DD.
trustedSeller string false none The authorized trusted seller.
incentivizedActivity boolean false none A true indicates incentivized activity available in the app.
downloadRange string false none The estimated number of apps installed. For Google Google Play only.
averageUserRating integer false none The average user rating given by the app store.
contentRating string false none The recommended content rating defined by the app store.
blocklisted boolean false none A true indicates the app has been placed on Pixalate risk blocklist.
blocklistedReasons BlocklistedReasons false none A list of reasons that the app is blocklisted.
adCapabilities object false none The ad capabilities of the app.
» topDevice string false none The most commonly reported device in use by the app.
» displayTopAdsize string false none The display ad size most commonly trafficked in programmatic advertising.
» videoTopAdsize string false none The video ad size most commonly trafficked in programmatic advertising.
» displayContribution number false none The percentage of video ads trafficked on the app.
» videoContribution number false none The percentage of display ads trafficked on the app.
» hyperLocationAvailability number false none The percentage of advertising transactions containing the user's latitude and longitude.
» mraidVersion string false none The most recent version of MRAID for which the app is compliant.
» adsDetected boolean false none A true indicates that Ads detected in the app. Non ad-supported apps may be at risk of spoofing.
interactiveELements InteractiveElements false none List of Interactive elements focus on what information the app has access to.

PixalateAdvisories

{
          "hasAppAdsTxt": false,
          "delistedApp": true,
          "delistedDate": "2021-10-30",
          "hasDangerousPermissions": false,
          "blocklisted": false,
          "privateDomain": false,
          "hasTermsAndConditions": true,
          "hasPrivacyPolicy": true
        }
        
        

Pixalate app advisories.

Properties

Name Type Required Restrictions Description
hasAppAdsTxt boolean false none A true indicates that AppAds.txt is enabled for the app's domain.
delistedApp boolean false none A true indicates that app has been delisted from the app store.
delistedDate string(date) false none If app has been delisted from the app store, then this property is the date when delisted. The date format is YYYY-MM-DD.
hasDangerousPermissions boolean false none A true indicates that the app requests a permission which is dangerous according to the protection level in the Google permission manifest.
blocklisted boolean false none A true indicates app has been placed on Pixalate risk blocklist.
privateDomain boolean false none A true indicates app's domain is privately registered.
hasTermsAndConditions boolean false none A true indicates app has terms and conditions.
hasPrivacyPolicy boolean false none A true indicates app has privacy policy.

AppAdvisories

[
          "An example advisory",
          "Another advisory"
        ]
        
        

App advisories.

Properties

None

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

An overview of risk for the app.

Properties

Name Type Required Restrictions Description
ivt number false none Percentage of invalid traffic associated with advertising transactions for the app.
ivtRisk string false none The invalid traffic risk.
viewability number false none The average viewability for all display ad impressions in the app.
viewabilityRisk string false none The risk of IAB viewability standards not being met for ad impressions on the app.
descriptionBrandSafetyRisk string false none The overall description risk to advertise brand safety from the app.
contentBrandSafetyRisk string false none The overall content risk to advertise brand safety from the app.
overallIvtPermissionRisk string false none The overall IVT risk to advertise brand safety from the app.
risk [object] false none Pixalate's unique overall advertising risk assessment based on blended risk factors including brand safety, invalid traffic and inventory for all regions and devices. It includes risk reasons. And list of possible risk reasons.
» region Region false none A geographic region. GLOBAL indicates an aggregate of all regions.
» device Device false none The device. GLOBAL indicates an aggregate of all devices.
» pixalateRisk string false none Pixalate's unique overall risk assessment for the app.
» pixalateRiskReasons RiskReasons false none A list of reasons that the app is at risk.

Enumerated Values

Property Value
ivtRisk low
ivtRisk medium
ivtRisk high
viewabilityRisk low
viewabilityRisk medium
viewabilityRisk high
descriptionBrandSafetyRisk low
descriptionBrandSafetyRisk medium
descriptionBrandSafetyRisk high
contentBrandSafetyRisk low
contentBrandSafetyRisk medium
contentBrandSafetyRisk high
overallIvtPermissionRisk low
overallIvtPermissionRisk medium
overallIvtPermissionRisk high
pixalateRisk low
pixalateRisk medium
pixalateRisk high

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

An overview of app's developer information.

Properties

Name Type Required Restrictions Description
developerName string false none The business name of the app's developer.
developerLocation string false none The business address of the app's developer
developerEmail string false none The contact email address of the app's developer.
developerCountry string false none The country name of the app's developer.
developerWebsite string false none The website of the app's developer.
developerTotalApps integer false none The total number of apps available from the developer.
privateDomain boolean false none A true indicates app's domain is privately registered.
hasTermsAndConditions boolean false none A true indicates app has terms and conditions.
hasPrivacyPolicy boolean false none A true indicates app has privacy policy.
facebookRisk string false none The Facebook risk. Low social media engagement on Facebook can be a risk factor.
linkedInRisk string false none The LinkedIn risk. Low social media engagement on LinkedIn can be a risk factor.
twitterRisk string false none The Twitter risk. Low social media engagement on Twitter can be a risk factor.

Enumerated Values

Property Value
facebookRisk low
facebookRisk medium
facebookRisk high
linkedInRisk low
linkedInRisk medium
linkedInRisk high
twitterRisk low
twitterRisk medium
twitterRisk high

TrafficOverview

{
          "spoofingRisk": "low",
          "locationMaskingRisk": "low",
          "advertisingIvtRisk": "low",
          "clickIvtRisk": "low",
          "viewabilityRisk": "low",
          "estimatedDailyActiveUsers": 1000000,
          "estimatedMonthlyActiveUsers": 20000000,
          "inventory": 22000000,
          "adSpend": 69000
        }
        
        

An overview of the traffic risk.

Properties

Name Type Required Restrictions Description
spoofingRisk string false none The risk the app may be misrepresented in advertising transactions and ads delivered to a different app or site.
locationMaskingRisk string false none The risk that location data is inaccurate for advertising transactions involving the app.
advertisingIvtRisk string false none The risk of advertising impressions delivered to the app being due to invalid traffic.
clickIvtRisk string false none The risk of clicks originating from ads on the app being fraudluent.
viewabilityRisk string false none The risk of IAB viewability standards not being met for ad impressions on the app.
estimatedDailyActiveUsers integer false none The estimated daily active users of the app.
estimatedMonthlyActiveUsers integer false none The estimated monthly active users of the app.
inventory integer false none The estimated number of monthly impressions this app makes available programmatically.
adSpend number false none Total estimated monthly ad spend on this app.

Enumerated Values

Property Value
spoofingRisk low
spoofingRisk medium
spoofingRisk high
locationMaskingRisk low
locationMaskingRisk medium
locationMaskingRisk high
advertisingIvtRisk low
advertisingIvtRisk medium
advertisingIvtRisk high
clickIvtRisk low
clickIvtRisk medium
clickIvtRisk high
viewabilityRisk low
viewabilityRisk medium
viewabilityRisk high

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

Brand safety information.

Properties

Name Type Required Restrictions Description
descriptionBrandSafety object false none App descriptive text is processed through natural language algorithms and comprehensive categorical dictionaries to predict the advertiser brand safety risk.
» descriptionBrandSafetyRisk string false none The overall description risk to advertise brand safety from the app.
» advisoriesRisk string false none The risk to brand safety derived from the app's content advisories.
» adultContentRisk string false none The risk to brand safety from adult themed content based on textual analysis of the app and its descriptive content.
» drugContentRisk string false none The risk to brand safety from drug themed content based on textual analysis of the app and its descriptive content.
» alcoholContentRisk string false none The risk to brand safety from Alcohol themed content based on textual analysis of the app and its descriptive content.
» hateSpeechRisk string false none The risk to brand safety from hate speech content based on textual analysis of the app and its descriptive content.
» offensiveContentRisk string false none The risk to brand safety from content with offensive language based on textual analysis of the app and its descriptive content .
» gamblingContentRisk string false none The risk to brand safety from gambling focused content based on textual analysis of the app and its descriptive content.
» violenceContentRisk string false none The risk to brand safety from Gambling focused content based on textual analysis of the app and its descriptive content.
contentBrandSafety object false none In-app visual content is processed through an advanced machine learning algorithm and evaluated for risk to advertiser brand safety.
» contentBrandSafetyRisk string false none The overall content risk to advertise brand safety from the app.
» adultRisk string false none The risk to brand safety from potential adult images and content detected within the app.
» violenceRisk string false none The risk to brand safety from potential violent imagery and content detected within the app.
» imageData [object] false none The image by image breakdown of brand safety risk factors based on advanced image processing and machine learning.
»» url string false none A URL to the image.
»» text string false none The extracted text.
»» violenceRisk string false none The risk to brand safety from potential violence images and any extracted text.
»» spoofRisk string false none The risk to brand safety from potential spoofing based on images and any extracted text.
»» medicalRisk string false none The risk to brand safety from potential medical images and any extracted text.
»» adultRisk string false none The risk to brand safety from potential adult images images and any extracted text.

Enumerated Values

Property Value
descriptionBrandSafetyRisk low
descriptionBrandSafetyRisk medium
descriptionBrandSafetyRisk high
advisoriesRisk low
advisoriesRisk medium
advisoriesRisk high
adultContentRisk low
adultContentRisk medium
adultContentRisk high
drugContentRisk low
drugContentRisk medium
drugContentRisk high
alcoholContentRisk low
alcoholContentRisk medium
alcoholContentRisk high
hateSpeechRisk low
hateSpeechRisk medium
hateSpeechRisk high
offensiveContentRisk low
offensiveContentRisk medium
offensiveContentRisk high
gamblingContentRisk low
gamblingContentRisk medium
gamblingContentRisk high
violenceContentRisk low
violenceContentRisk medium
violenceContentRisk high
contentBrandSafetyRisk low
contentBrandSafetyRisk medium
contentBrandSafetyRisk high
adultRisk low
adultRisk medium
adultRisk high
violenceRisk low
violenceRisk medium
violenceRisk high
violenceRisk low
violenceRisk medium
violenceRisk high
spoofRisk low
spoofRisk medium
spoofRisk high
medicalRisk low
medicalRisk medium
medicalRisk high
adultRisk low
adultRisk medium
adultRisk high

AppPermissions

{
          "ivtPermissionRisk": "medium",
          "permissions": [
            {
              "name": "ACCESS_BACKGROUND_LOCATION",
              "description": "Allows an app to access location in the background.",
              "isDangerous": "false;",
              "ivtPermissonRisk": "medium"
            }
          ]
        }
        
        

App permissions.

Properties

Name Type Required Restrictions Description
ivtPermissionRisk string false none The IVT Risk based on the combined risk of the permissions.
permissions [object] false none List of permissions.
» name string false none The permission name.
» description string false none The permission description.
» isDangerous boolean false none A true indicates a dangerous permission.

Normal permissions - Normal permissions cover areas where your app needs to access data or resources outside the app's sandbox,
but where there's very little risk to the user's privacy or the operation of other apps.
For example, permission to set the time zone is a normal permission.
If an app declares in its manifest that it needs a normal permission, the system automatically grants the app that permission at install time.

Dangerous permissions - Dangerous permissions cover areas where the app wants data or resources that involve the user's private information,
or could potentially affect the user's stored data or the operation of other apps.
For example, the ability to read the user's contacts is a dangerous permission.
If an app declares that it needs a dangerous permission, the user has to explicitly grant the permission to the app.
Until the user approves the permission, the app cannot provide functionality that depends on that permission.
» ivtPermissonRisk string false none The IVT Risk for the permission.

Enumerated Values

Property Value
ivtPermissionRisk low
ivtPermissionRisk medium
ivtPermissionRisk high
ivtPermissonRisk low
ivtPermissonRisk medium
ivtPermissonRisk high

TrafficOverlap

{
          "userOverlap": 8.7,
          "inventoryOverlap": 3.1
        }
        
        

Overlap traffic illustrates the most common user journeys from app to app. It leverages shared users to not only connect apps together but also to create relationships between a series of apps. List of apps provided based on overall traffic (byOveralTraffic) and invalid traffic (byIvt).

Properties

Name Type Required Restrictions Description
userOverlap number false none The percentage of users of the given app that also visit the app.
inventoryOverlap number false none The percentage of impressions of the given app that were generated by the users that visited the app.

AuthorizedSellers

[
          {
            "exchange": "Acme Exchange",
            "paymentType": "Direct",
            "inventory": 30039,
            "inventoryRatio": 12.87,
            "ivt": 0.9,
            "videoInventoryRatio": 1.4,
            "viewability": 79.28
          }
        ]
        
        

The contribution of various sell side platforms to programmatic ad impressions sold on the app.

Properties

Name Type Required Restrictions Description
exchange string false none The name of the exchange.
paymentType string false none The payment type.
inventory integer false none The estimated number of monthly impressions this app makes available programmatically by this seller.
inventoryRatio number false none The average inventory ratio for ad impressions on the app by this seller.
ivt number false none The average IVT for ad impressions on the app by this seller.
videoInventoryRatio number false none The average video inventory ratio for ad impressions on the app by this seller.
viewability number false none The average viewability for ad impressions on the app by this seller.

InvalidTraffic

{
          "ivt": 7.76,
          "givt": 0.29,
          "sivt": 7.47,
          "givtTypes": [
            {
              "fraudType": "Data Center",
              "givt": 0.29
            }
          ],
          "sivtTypes": [
            {
              "fraudType": "AppSpoofing",
              "sivt": 2.78
            }
          ]
        }
        
        

The percentage of invalid traffic associated with each Pixalate's taxonomy of GIVT and SIVT invalid traffic types.

Properties

Name Type Required Restrictions Description
ivt number false none The total percentage of non-human traffic measured on the app.
givt number false none GIVT refers to General Invalid Traffic - Deterministically judged to be non-human traffic; high to very high risk.
sivt number false none SIVT refers to Sophisticated Invalid Traffic - Probabilistically judged to be non-human traffic using advanced statistical detection methods; moderate to high risk traffic.
givtTypes [object] false none The percentage of invalid traffic associated with each Pixalate's taxonomy of GIVT invalid traffic types.
» fraudType string false none The type of SIVT fraud.
» givt number false none GIVT refers to General Invalid Traffic - Deterministically judged to be non-human traffic; high to very high risk.
sivtTypes [object] false none The percentage of invalid traffic associated with each Pixalate's taxonomy of SIVT invalid traffic types.
» fraudType string false none The type of SIVT fraud.
» sivt number false none SIVT refers to Sophisticated Invalid Traffic - Probabilistically judged to be non-human traffic using advanced statistical detection methods; moderate to high risk traffic.

Viewability

{
          "viewability": 66.05,
          "viewabilityRisk": "medium",
          "byAdSizes": [
            {
              "adSize": "728x90",
              "inventory": 22360289,
              "inventoryRatio": 66.05,
              "viewability": 66.05
            }
          ]
        }
        
        

The average viewability, according the IAB standard of 50% in view for at least 1 second, for display advertisements in the app.

Properties

Name Type Required Restrictions Description
viewability number false none The average viewability for all display ad impressions in the app.
viewabilityRisk string false none The risk of IAB viewability standards not being met for ad impressions on the app.
byAdSizes [object] false none The risk of IAB viewability standards not being met for ad impressions on the app by each ad size.
» adSize string false none The size of the ad.
» inventory integer false none The estimated volume of programmatic ad impressions by ad size.
» inventoryRatio number false none The estimated percentage of inventory by ad size.
» viewability number false none The average viewability for impressions by ad size.

Enumerated Values

Property Value
viewabilityRisk low
viewabilityRisk medium
viewabilityRisk high

Inventory

{
          "byDevice": [
            {
              "device": "Apple Iphone",
              "inventory": null,
              "inventoryRatio": 81.04,
              "ivt": 8.02,
              "viewability": 73.3
            }
          ],
          "byRegion": [
            {
              "region": "APAC",
              "inventory": null,
              "inventoryRatio": 6.39,
              "ivt": 2.93,
              "viewability": 92.52
            }
          ],
          "byCounty": [
            {
              "countryName": "UK",
              "inventory": null,
              "inventoryRatio": 1.72,
              "ivt": 8.99,
              "viewability": 94.74
            }
          ],
          "byAdsize": [
            {
              "adSize": "320x50",
              "inventory": null,
              "inventoryRatio": 3.47,
              "ivt": 12.25,
              "viewability": 98.08
            }
          ],
          "byDma": [
            {
              "dmaName": "NEW YORK",
              "inventory": null,
              "inventoryRatio": 5.35,
              "ivt": 4.76,
              "viewability": 88.01
            }
          ]
        }
        
        

The estimated volume of programmatic ad impressions broken down by device, region, country, DMA.

Properties

Name Type Required Restrictions Description
byDevice [object] false none The estimated volume of programmatic ad impressions broken down by device.
» device string false none The device.
» inventory integer false none The estimated volume of programmatic ad impressions by device.
» inventoryRatio number false none The estimated percentage of inventory by device.
» ivt number false none The total percentage of non-human traffic measured on the app by device.
» viewability number false none The average viewability for impressions by device.
byRegion [object] false none The estimated volume of programmatic ad impressions broken down by region.
» region string false none The region.
» inventory integer false none The estimated volume of programmatic ad impressions by region.
» inventoryRatio number false none The estimated percentage of inventory by region.
» ivt number false none The total percentage of non-human traffic measured on the app by region.
» viewability number false none The average viewability for impressions by region.
byCounty [object] false none The estimated volume of programmatic ad impressions broken down by country.
» countryName string false none The county name.
» inventory integer false none The estimated volume of programmatic ad impressions by country.
» inventoryRatio number false none The estimated percentage of inventory by country.
» ivt number false none The total percentage of non-human traffic measured on the app by country.
» viewability number false none The average viewability for impressions by country.
byAdsize [object] false none The estimated volume of programmatic ad impressions broken down by ad size.
» adSize string false none The ad size.
» inventory integer false none The estimated volume of programmatic ad impressions by ad size.
» inventoryRatio number false none The estimated percentage of inventory by ad size.
» ivt number false none The total percentage of non-human traffic measured on the app by ad size.
» viewability number false none The average viewability for impressions by ad size.
byDma [object] false none The estimated volume of programmatic ad impressions broken down by DMA.
» dmaName string false none The DMA name.
» inventory integer false none The estimated volume of programmatic ad impressions by DMA.
» inventoryRatio number false none The estimated percentage of inventory by DMA.
» ivt number false none The total percentage of non-human traffic measured on the app by DMA.
» viewability number false none The average viewability for impressions by DMA.

Ctr

{
          "ctr": 6.03,
          "byAdSize": [
            {
              "adSize": "320x50",
              "ctr": 1.45
            }
          ]
        }
        
        

Information about Click Through Rate for this app.

Properties

Name Type Required Restrictions Description
ctr number false none The overall average CTR for this app.
byAdSize [object] false none The CTR for this app broken down by ad size.
» adSize string false none The ad size.
» ctr number false none The Click Through Rate.

AvailableCountries

[
          "Germany"
        ]
        
        

A list of available countries.

Properties

None

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

Ranking information about the app.

Properties

Name Type Required Restrictions Description
regionRank integer false none The rank of the app within the requested region.
categoryRank integer false none The rank of the app within its category.
category string false none The category of the app.
final object false none The final grade and score for the app.
» grade string false none The final grade for the app.
» score string false none The final score for the app.
ivt object false none The IVT grade and score for the app.
» grade string false none The IVT grade for the app.
» score string false none The IVT score for the app.
adsTxt object false none The ads.txt grade and score for the app.
» grade string false none The ads.txt grade for the app.
» score string false none The ads.txt score for the app.
brandSafety object false none The brand safety grade and score for the app.
» grade string false none The brand safety grade for the app.
» score string false none The brand safety score for the app.
viewability object false none The viewability grade and score for the app.
» grade string false none The viewability grade for the app.
» score string false none The viewability score for the app.
permissions object false none The permissions grade and score for the app.
» grade string false none The permissions grade for the app.
» score string false none The IVT score for the app.
popularity object false none The popularity grade and score for the app.
» grade string false none The popularity grade for the app.
» score string false none The popularity score for the app.
globalPopularityRank string false none The overall global popularity ranking of the app.

RankingsByCountry

{
          "reach": [
            {
              "countryCode": "ZA",
              "countryName": "South Africa",
              "mauRank": "637",
              "mauRankChange": "-372"
            }
          ],
          "marketShare": [
            {
              "countryCode": "GE",
              "countryName": "Georgia",
              "impressionRank": "359",
              "impsRankChange": "N/A"
            }
          ]
        }
        
        

The reach and market share of the app broken down by country.

Properties

Name Type Required Restrictions Description
reach [object] false none The reach of the app broken down by country.
» countryCode string false none The ISO ALPHA-2 standard country code.
» countryName string false none The country name.
» mauRank string false none The current MAU ranking for the app for this country.
» mauRankChange string false none The change in MAU rank since last assessment.
marketShare [object] false none The market share of the app broken down by country.
» countryCode string false none The ISO ALPHA-2 standard country code.
» countryName string false none The country name.
» impressionRank string false none The current impression ranking for the app for this country.
» impsRankChange string false none The change in impression ranking since last assessment.

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": null,
          "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."
            }
          ]
        }
        
        

Children's Online Privacy Protection Act information.

Properties

Name Type Required Restrictions Description
coppaAudience string false none Assesses the likely intended audience of an app based on a variety of factors including app store categories, content ratings, and keywords, etc.
coppaAudienceReason [string] false none Describes the specific variables considered when making the audience assessment.
storeCategory [string] false none The associated category of an app according to the Google Play Store & Apple’s App Store.
storeSubCategory [string] false none The associated subcategory from Google Play Store & Apple’s App Store.
contentRating string false none The recommended age rating defined by the Apple's app store or the content rating provided by Google play store.
isApprovedByTeacher boolean false none Google Play’s program in which apps are evaluated by teachers and other specialists and for age and content appropriateness.
ageGroupApprovedByTeacher string false none The recommended age group as approved by teachers.
coppaViolationRisk string false none Pixalate analyzes multiple signals and produces a risk score (low, medium, or high) that captures the potential COPPA risk.
coppaViolationRiskReason [string] false none Describes the specific variables considered when making the overall COPPA risk rating assessment.
privacyPolicyDetected boolean false none Pixalate determines whether an app has a privacy policy based on information provided in the app stores. Additionally, Pixalate uses crawlers to scan developer websites for privacy policies.
sensitivePermissions boolean false none Detects mobile device permissions granted to the app such as camera, microphone, contacts, etc. which allow for sensitive personal information collection.
transmitsResidentialIP boolean false none Pixalate examines the traffic associated with an app and determines if the end-user IP is transmitted through the advertising pipeline that can expose granular information about the user’s location.
passesLocation boolean false none Pixalate examines the traffic associated with an app and determines if the end-users’ GPS coordinates are being transmitted through the advertising pipeline that exposes granular information about the user’s location.
permissions [object] false none Lists the device permissions granted to the app, reports those considered sensitive permissions related to COPPA.
» name string false none The name of the permission.
» description string false none The permissions description.

Enumerated Values

Property Value
coppaViolationRisk low
coppaViolationRisk medium
coppaViolationRisk high

AppStore

"android"
        
        

An app store identifier.

Properties

Name Type Required Restrictions Description
anonymous string false none An app store identifier.

Enumerated Values

Property Value
anonymous ios
anonymous android

Device

"smartphone"
        
        

The device. GLOBAL indicates an aggregate of all devices.

Properties

Name Type Required Restrictions Description
anonymous string false none The device. GLOBAL indicates an aggregate of all devices.

Enumerated Values

Property Value
anonymous GLOBAL
anonymous smartphone
anonymous tablet

Region

"APAC"
        
        

A geographic region. GLOBAL indicates an aggregate of all regions.

Properties

Name Type Required Restrictions Description
anonymous string false none A geographic region. GLOBAL indicates an aggregate of all regions.

Enumerated Values

Property Value
anonymous GLOBAL
anonymous NA
anonymous EMEA
anonymous LATAM
anonymous APAC

Status

"OK"
        
        

The returned status.

Properties

Name Type Required Restrictions Description
anonymous string false none The returned status.

Enumerated Values

Property Value
anonymous OK
anonymous ERR

Widget

"appOverview"
        
        

The identifier for a predefined subset of all the app information available. If not supplied, usually indicates all widgets.

Properties

Name Type Required Restrictions Description
anonymous string false none The identifier for a predefined subset of all the app information available. If not supplied, usually indicates all widgets.

Enumerated Values

Property Value
anonymous appOverview
anonymous appDetails
anonymous pixalateAdvisories
anonymous appAdvisories
anonymous riskOverview
anonymous developerOverview
anonymous trafficOverview
anonymous brandSafety
anonymous appPermissions
anonymous trafficOverlap
anonymous authorizedSellers
anonymous invalidTraffic
anonymous viewability
anonymous inventory
anonymous ctr
anonymous availableCountries
anonymous rankings
anonymous rankingsByCountry
anonymous coppa

BlocklistedReasons

[
          "App is No Longer in Active Use",
          "The app is a VPN"
        ]
        
        

A list of reasons that the app is blocklisted.

Properties

None

RiskReasons

[
          "Significantly Elevated IVT Percentage",
          "Ad Traffic Shows Some Suspicious Characteristics"
        ]
        
        

A list of reasons that the app is at risk.

Properties

None

InteractiveElements

[
          "Shares Location",
          "Users Interact"
        ]
        
        

List of Interactive elements focus on what information the app has access to.

Properties

None