> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.pixalate.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.pixalate.com/_mcp/server. # Get risk ratings and reputation for one mobile app GET https://api.pixalate.com/api/v2/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. Reference: https://docs.pixalate.com/api-reference/enrichment-apps/get-mobile-app-data ## Authentication - `x-api-key` header (required) — 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](https://developer.pixalate.com). ## Request ### Path parameters - `appId` (string, required) — The app's unique identifier. This is a package name on Google Play or a track id on Apple app Store. ### Query parameters - `widget` (list of enum, optional) — Filter by comma-separated list of widgets to return. All widgets are returned by default. - Allowed values: `appOverview`, `appDetails`, `pixalateAdvisories`, `appAdvisories`, `riskOverview`, `developerOverview`, `trafficOverview`, `brandSafety`, `appPermissions`, `trafficOverlap`, `authorizedSellers`, `invalidTraffic`, `viewability`, `inventory`, `ctr`, `availableCountries`, `rankings`, `rankingsByCountry`, `coppa`, `mfa` - `region` (enum, optional) — Filter by region. All regions are returned by default. *GLOBAL* indicates aggregated traffic from all regions. - Allowed values: `GLOBAL`, `NA`, `EMEA`, `LATAM`, `APAC` - `device` (enum, optional) — Filter by device. All devices are returned by default. *GLOBAL* indicates aggregated traffic from all devices. - Allowed values: `GLOBAL`, `smartphone`, `tablet` - `pretty` (boolean, optional) — If true, return pretty JSON. Default is false. ## Response ### 200 OK - `status` (enum, optional) — The returned status. - Allowed values: `OK`, `ERR` - `numFound` (integer, optional) — The total number of matching apps. - `docs` (list of App, optional) — A list of apps. ## Errors ### 400 Bad Request Error Bad Request - Invalid parameters in request. - `any` ### 401 Unauthorized Error Unauthorized - Invalid API Key. - `any` ### 403 Forbidden Error Forbidden - Quota has been exhausted, Subscription expired or needs upgrade. - `any` ### 500 Server Error Server Error - The API experienced an internal error. Contact support. - `any` ## Types ### App An app. - `appId` (string, optional) — The app's unique identifier. *A package name on Google Play or a track id on Apple app Store.* - `region` (enum, optional) — A geographic region. *GLOBAL* indicates an aggregate of all regions. - Allowed values: `GLOBAL`, `NA`, `EMEA`, `LATAM`, `APAC` - `device` (enum, optional) — The device. *GLOBAL* indicates an aggregate of all devices. - Allowed values: `GLOBAL`, `smartphone`, `tablet` - `appStore` (enum, optional) — An app store identifier. - Allowed values: `ios`, `android` - `appOverview` (AppOverview, optional) — General information about the app. - `appDetails` (AppDetails, optional) — Detailed information about the app. - `pixalateAdvisories` (PixalateAdvisories, optional) — Pixalate app advisories. - `appAdvisories` (list of string, optional) — App advisories. - `riskOverview` (RiskOverview, optional) — An overview of risk for the app. - `developerOverview` (DeveloperOverview, optional) — An overview of app's developer information. - `trafficOverview` (TrafficOverview, optional) — An overview of the traffic risk. - `brandSafety` (BrandSafety, optional) — Brand safety information. - `appPermissions` (AppPermissions, optional) — App permissions. - `trafficOverlap` (TrafficOverlap, optional) — 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` (list of AuthorizedSellersItems, optional) — The contribution of various sell side platforms to programmatic ad impressions sold on the app. - `invalidTraffic` (InvalidTraffic, optional) — The percentage of invalid traffic associated with each Pixalate's taxonomy of GIVT and SIVT invalid traffic types. - `viewability` (Viewability, optional) — The average viewability, according the IAB standard of 50% in view for at least 1 second, for display advertisements in the app. - `inventory` (Inventory, optional) — The estimated volume of programmatic ad impressions broken down by device, region, country, DMA. - `ctr` (Ctr, optional) — Information about Click Through Rate for this app. - `availableCountries` (list of string, optional) — A list of available countries. - `rankings` (Rankings, optional) — Ranking information about the app. - `rankingsByCountry` (RankingsByCountry, optional) — The reach and market share of the app broken down by country. - `coppa` (Coppa, optional) — Children's Online Privacy Protection Act information. - `mfa` (Mfa, optional) — Made-for-advertising signals for the app. ### AppOverview General information about the app. - `appTitle` (string, optional) — The app title. - `screenshotUrls` (list of string, optional) — A list of app screenshot URLs. - `description` (string, optional) — App description. - `iabPrimaryCategory` (list of string, optional) — The IAB primary categories. - `iabSubCategory` (list of string, optional) — The IAB secondary categories. - `appStoreCategories` (list of string, optional) — App store categories. - `delistedDate` (date, optional) — 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, optional) — A *true* indicates that app has been delisted from the app store. - `hasDangerousPermissions` (boolean, optional) — A *true* indicates that the app requests a permission which is dangerous according to the protection level in the Google permission manifest. ### AppDetails Detailed information about the app. - `bundleId` (string, optional) — 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, optional) — The unique identifier for the app assigned by Apple. *App Store Only, otherwise null* - `appStoreUrl` (string, optional) — The app page on Google Play or App Store. - `appLastUpdatedDate` (date, optional) — The date the app information was last updated. Formatted as *YYYY-MM-DD*. - `trustedSeller` (string, optional) — The authorized trusted seller. - `incentivizedActivity` (boolean, optional) — A *true* indicates incentivized activity available in the app. - `downloadRange` (string, optional) — The estimated number of apps installed. *For Google Google Play only.* - `averageUserRating` (integer, optional) — The average user rating given by the app store. - `contentRating` (string, optional) — The recommended content rating defined by the app store. - `blocklisted` (boolean, optional) — A *true* indicates the app has been placed on Pixalate risk blocklist. - `blocklistedReasons` (list of enum, optional) — A list of reasons that the app is blocklisted. - Allowed values: `Ad Inventory from the app is Frequently Spoofed`, `App is No Longer in Active Use`, `Variety of Suspicious app Characteristics`, `High Volumes of Datacenter Traffic Detected`, `Limited History of Low Risk Advertising Traffic`, `The app is a VPN`, `Location Coordinates from the app are Commonly Inaccurate or Spoofed`, `An app that belongs to a developer that has created one or more blacklisted apps`, `App is No Longer in Active use`, `Significantly Elevated IVT Percentage` - `adCapabilities` (AppDetailsAdCapabilities, optional) — The ad capabilities of the app. - `interactiveELements` (list of enum, optional) — List of Interactive elements focus on what information the app has access to. - Allowed values: `Shares Info`, `Shares Location`, `Users Interact`, `Digital Purchases`, `Unrestricted Internet`, `In-app Purchases`, `In-Game Purchases` ### PixalateAdvisories Pixalate app advisories. - `hasAppAdsTxt` (boolean, optional) — A *true* indicates that AppAds.txt is enabled for the app's domain. - `delistedApp` (boolean, optional) — A *true* indicates that app has been delisted from the app store. - `delistedDate` (date, optional) — 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, optional) — A *true* indicates that the app requests a permission which is dangerous according to the protection level in the Google permission manifest. - `blocklisted` (boolean, optional) — A *true* indicates app has been placed on Pixalate risk blocklist. - `privateDomain` (boolean, optional) — A *true* indicates app's domain is privately registered. - `hasTermsAndConditions` (boolean, optional) — A *true* indicates app has terms and conditions. - `hasPrivacyPolicy` (boolean, optional) — A *true* indicates app has privacy policy. ### RiskOverview An overview of risk for the app. - `ivt` (double, optional) — Percentage of invalid traffic associated with advertising transactions for the app. - `ivtRisk` (enum, optional) — The invalid traffic risk. - Allowed values: `low`, `medium`, `high` - `viewability` (double, optional) — The average viewability for all display ad impressions in the app. - `viewabilityRisk` (enum, optional) — The risk of IAB viewability standards not being met for ad impressions on the app. - Allowed values: `low`, `medium`, `high` - `descriptionBrandSafetyRisk` (enum, optional) — The overall description risk to advertise brand safety from the app. - Allowed values: `low`, `medium`, `high` - `contentBrandSafetyRisk` (enum, optional) — The overall content risk to advertise brand safety from the app. - Allowed values: `low`, `medium`, `high` - `overallIvtPermissionRisk` (enum, optional) — The overall IVT risk to advertise brand safety from the app. - Allowed values: `low`, `medium`, `high` - `risk` (list of RiskOverviewRiskItems, optional) — 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. ### DeveloperOverview An overview of app's developer information. - `developerName` (string, optional) — The business name of the app's developer. - `developerLocation` (string, optional) — The business address of the app's developer - `developerEmail` (string, optional) — The contact email address of the app's developer. - `developerCountry` (string, optional) — The country name of the app's developer. - `developerWebsite` (string, optional) — The website of the app's developer. - `developerTotalApps` (integer, optional) — The total number of apps available from the developer. - `privateDomain` (boolean, optional) — A *true* indicates app's domain is privately registered. - `hasTermsAndConditions` (boolean, optional) — A *true* indicates app has terms and conditions. - `hasPrivacyPolicy` (boolean, optional) — A *true* indicates app has privacy policy. - `facebookRisk` (enum, optional) — The Facebook risk. Low social media engagement on Facebook can be a risk factor. - Allowed values: `low`, `medium`, `high` - `linkedInRisk` (enum, optional) — The LinkedIn risk. Low social media engagement on LinkedIn can be a risk factor. - Allowed values: `low`, `medium`, `high` - `twitterRisk` (enum, optional) — The Twitter risk. Low social media engagement on Twitter can be a risk factor. - Allowed values: `low`, `medium`, `high` ### TrafficOverview An overview of the traffic risk. - `spoofingRisk` (enum, optional) — The risk the app may be misrepresented in advertising transactions and ads delivered to a different app or site. - Allowed values: `low`, `medium`, `high` - `locationMaskingRisk` (enum, optional) — The risk that location data is inaccurate for advertising transactions involving the app. - Allowed values: `low`, `medium`, `high` - `advertisingIvtRisk` (enum, optional) — The risk of advertising impressions delivered to the app being due to invalid traffic. - Allowed values: `low`, `medium`, `high` - `clickIvtRisk` (enum, optional) — The risk of clicks originating from ads on the app being fraudluent. - Allowed values: `low`, `medium`, `high` - `viewabilityRisk` (enum, optional) — The risk of IAB viewability standards not being met for ad impressions on the app. - Allowed values: `low`, `medium`, `high` - `estimatedDailyActiveUsers` (integer, optional) — The estimated daily active users of the app. - `estimatedMonthlyActiveUsers` (integer, optional) — The estimated monthly active users of the app. - `inventory` (integer, optional) — The estimated number of monthly impressions this app makes available programmatically. - `adSpend` (double, optional) — Total estimated monthly ad spend on this app. ### BrandSafety Brand safety information. - `descriptionBrandSafety` (BrandSafetyDescriptionBrandSafety, optional) — App descriptive text is processed through natural language algorithms and comprehensive categorical dictionaries to predict the advertiser brand safety risk. - `contentBrandSafety` (BrandSafetyContentBrandSafety, optional) — In-app visual content is processed through an advanced machine learning algorithm and evaluated for risk to advertiser brand safety. ### AppPermissions App permissions. - `ivtPermissionRisk` (enum, optional) — The IVT Risk based on the combined risk of the permissions. - Allowed values: `low`, `medium`, `high` - `permissions` (list of AppPermissionsPermissionsItems, optional) — List of permissions. ### TrafficOverlap 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). - `userOverlap` (double, optional) — The percentage of users of the given app that also visit the app. - `inventoryOverlap` (double, optional) — The percentage of impressions of the given app that were generated by the users that visited the app. ### AuthorizedSellersItems - `exchange` (string, optional) — The name of the exchange. - `paymentType` (string, optional) — The payment type. - `inventory` (integer, optional) — The estimated number of monthly impressions this app makes available programmatically by this seller. - `inventoryRatio` (double, optional) — The average inventory ratio for ad impressions on the app by this seller. - `ivt` (double, optional) — The average IVT for ad impressions on the app by this seller. - `videoInventoryRatio` (double, optional) — The average video inventory ratio for ad impressions on the app by this seller. - `viewability` (double, optional) — The average viewability for ad impressions on the app by this seller. ### InvalidTraffic The percentage of invalid traffic associated with each Pixalate's taxonomy of GIVT and SIVT invalid traffic types. - `ivt` (double, optional) — The total percentage of non-human traffic measured on the app. - `givt` (double, optional) — GIVT refers to General Invalid Traffic - Deterministically judged to be non-human traffic; high to very high risk. - `sivt` (double, optional) — SIVT refers to Sophisticated Invalid Traffic - Probabilistically judged to be non-human traffic using advanced statistical detection methods; moderate to high risk traffic. - `givtTypes` (list of InvalidTrafficGivtTypesItems, optional) — The percentage of invalid traffic associated with each Pixalate's taxonomy of GIVT invalid traffic types. - `sivtTypes` (list of InvalidTrafficSivtTypesItems, optional) — The percentage of invalid traffic associated with each Pixalate's taxonomy of SIVT invalid traffic types. ### Viewability The average viewability, according the IAB standard of 50% in view for at least 1 second, for display advertisements in the app. - `viewability` (double, optional) — The average viewability for all display ad impressions in the app. - `viewabilityRisk` (enum, optional) — The risk of IAB viewability standards not being met for ad impressions on the app. - Allowed values: `low`, `medium`, `high` - `byAdSizes` (list of ViewabilityByAdSizesItems, optional) — The risk of IAB viewability standards not being met for ad impressions on the app by each ad size. ### Inventory The estimated volume of programmatic ad impressions broken down by device, region, country, DMA. - `byDevice` (list of InventoryByDeviceItems, optional) — The estimated volume of programmatic ad impressions broken down by device. - `byRegion` (list of InventoryByRegionItems, optional) — The estimated volume of programmatic ad impressions broken down by region. - `byCounty` (list of InventoryByCountyItems, optional) — The estimated volume of programmatic ad impressions broken down by country. - `byAdsize` (list of InventoryByAdsizeItems, optional) — The estimated volume of programmatic ad impressions broken down by ad size. - `byDma` (list of InventoryByDmaItems, optional) — The estimated volume of programmatic ad impressions broken down by DMA. ### Ctr Information about Click Through Rate for this app. - `ctr` (double, optional) — The overall average CTR for this app. - `byAdSize` (list of CtrByAdSizeItems, optional) — The CTR for this app broken down by ad size. ### Rankings Ranking information about the app. - `regionRank` (integer, optional) — The rank of the app within the requested region. - `categoryRank` (integer, optional) — The rank of the app within its category. - `category` (string, optional) — The category of the app. - `final` (RankingsFinal, optional) — The final grade and score for the app. - `ivt` (RankingsIvt, optional) — The IVT grade and score for the app. - `adsTxt` (RankingsAdsTxt, optional) — The ads.txt grade and score for the app. - `brandSafety` (RankingsBrandSafety, optional) — The brand safety grade and score for the app. - `viewability` (RankingsViewability, optional) — The viewability grade and score for the app. - `permissions` (RankingsPermissions, optional) — The permissions grade and score for the app. - `popularity` (RankingsPopularity, optional) — The popularity grade and score for the app. - `globalPopularityRank` (string, optional) — The overall global popularity ranking of the app. ### RankingsByCountry The reach and market share of the app broken down by country. - `reach` (list of RankingsByCountryReachItems, optional) — The reach of the app broken down by country. - `marketShare` (list of RankingsByCountryMarketShareItems, optional) — The market share of the app broken down by country. ### Coppa Children's Online Privacy Protection Act information. - `coppaAudience` (string, optional) — Assesses the likely intended audience of an app based on a variety of factors including app store categories, content ratings, and keywords, etc. - `coppaAudienceReason` (list of string, optional) — Describes the specific variables considered when making the audience assessment. - `storeCategory` (list of string, optional) — The associated category of an app according to the Google Play Store & Apple’s App Store. - `storeSubCategory` (list of string, optional) — The associated subcategory from Google Play Store & Apple’s App Store. - `contentRating` (string, optional) — The recommended age rating defined by the Apple's app store or the content rating provided by Google play store. - `isApprovedByTeacher` (boolean, optional) — Google Play’s program in which apps are evaluated by teachers and other specialists and for age and content appropriateness. - `ageGroupApprovedByTeacher` (string, optional) — The recommended age group as approved by teachers. - `coppaViolationRisk` (enum, optional) — Pixalate analyzes multiple signals and produces a risk score (low, medium, or high) that captures the potential COPPA risk. - Allowed values: `low`, `medium`, `high` - `coppaViolationRiskReason` (list of string, optional) — Describes the specific variables considered when making the overall COPPA risk rating assessment. - `privacyPolicyDetected` (boolean, optional) — 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, optional) — Detects mobile device permissions granted to the app such as camera, microphone, contacts, etc. which allow for sensitive personal information collection. - `transmitsResidentialIP` (boolean, optional) — 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, optional) — 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` (list of CoppaPermissionsItems, optional) — Lists the device permissions granted to the app, reports those considered sensitive permissions related to COPPA. ### Mfa Made-for-advertising signals for the app. - `mfaRisk` (enum, optional) — Pixalate's made-for-advertising risk rating for the app. - Allowed values: `low`, `medium`, `high` - `adRefreshRate` (double, optional, nullable) — The rate at which advertising slots are refreshed. Null when a refresh rate could not be determined. ### AppDetailsAdCapabilities The ad capabilities of the app. - `topDevice` (string, optional) — The most commonly reported device in use by the app. - `displayTopAdsize` (string, optional) — The display ad size most commonly trafficked in programmatic advertising. - `videoTopAdsize` (string, optional) — The video ad size most commonly trafficked in programmatic advertising. - `displayContribution` (double, optional) — The percentage of video ads trafficked on the app. - `videoContribution` (double, optional) — The percentage of display ads trafficked on the app. - `hyperLocationAvailability` (double, optional) — The percentage of advertising transactions containing the user's latitude and longitude. - `mraidVersion` (string, optional) — The most recent version of MRAID for which the app is compliant. - `adsDetected` (boolean, optional) — A *true* indicates that Ads detected in the app. Non ad-supported apps may be at risk of spoofing. ### RiskOverviewRiskItems - `region` (enum, optional) — A geographic region. *GLOBAL* indicates an aggregate of all regions. - Allowed values: `GLOBAL`, `NA`, `EMEA`, `LATAM`, `APAC` - `device` (enum, optional) — The device. *GLOBAL* indicates an aggregate of all devices. - Allowed values: `GLOBAL`, `smartphone`, `tablet` - `pixalateRisk` (enum, optional) — Pixalate's unique overall risk assessment for the app. - Allowed values: `low`, `medium`, `high` - `pixalateRiskReasons` (list of enum, optional) — A list of reasons that the app is at risk. - Allowed values: `Significantly Elevated IVT Percentage`, `Publisher Maintains Non-corporate Email Address`, `Moderately Elevated IVT Percentage`, `Publisher Does Not Publish a Privacy Policy`, `The Publisher Hides their Corporate Details in the Domain Registry`, `The Publisher's Email Address Doesn't Match Their Domain`, `Adult Content Has Been Detected in the app`, `The Publisher Does Not Publish Terms and Conditions`, `The Publisher Domain is Invalid`, `Gambling Content Has Been Detected in the app`, `Programmatic Ads Not Detected Leads to High Spoofing Risk`, `Violent Content Has Been Detected in the app`, `Alcohol Based Content Has Been Detected in the app`, `Ad Traffic Shows Some Suspicious Characteristics`, `Profanity and Offensive Language Has Been Detected in the app`, `App Description Uses Some Brand Unsafe Language`, `App Has a High Frequency of Invalid Clicks` ### BrandSafetyDescriptionBrandSafety App descriptive text is processed through natural language algorithms and comprehensive categorical dictionaries to predict the advertiser brand safety risk. - `descriptionBrandSafetyRisk` (enum, optional) — The overall description risk to advertise brand safety from the app. - Allowed values: `low`, `medium`, `high` - `advisoriesRisk` (enum, optional) — The risk to brand safety derived from the app's content advisories. - Allowed values: `low`, `medium`, `high` - `adultContentRisk` (enum, optional) — The risk to brand safety from adult themed content based on textual analysis of the app and its descriptive content. - Allowed values: `low`, `medium`, `high` - `drugContentRisk` (enum, optional) — The risk to brand safety from drug themed content based on textual analysis of the app and its descriptive content. - Allowed values: `low`, `medium`, `high` - `alcoholContentRisk` (enum, optional) — The risk to brand safety from Alcohol themed content based on textual analysis of the app and its descriptive content. - Allowed values: `low`, `medium`, `high` - `hateSpeechRisk` (enum, optional) — The risk to brand safety from hate speech content based on textual analysis of the app and its descriptive content. - Allowed values: `low`, `medium`, `high` - `offensiveContentRisk` (enum, optional) — The risk to brand safety from content with offensive language based on textual analysis of the app and its descriptive content . - Allowed values: `low`, `medium`, `high` - `gamblingContentRisk` (enum, optional) — The risk to brand safety from gambling focused content based on textual analysis of the app and its descriptive content. - Allowed values: `low`, `medium`, `high` - `violenceContentRisk` (enum, optional) — The risk to brand safety from Gambling focused content based on textual analysis of the app and its descriptive content. - Allowed values: `low`, `medium`, `high` ### BrandSafetyContentBrandSafety In-app visual content is processed through an advanced machine learning algorithm and evaluated for risk to advertiser brand safety. - `contentBrandSafetyRisk` (enum, optional) — The overall content risk to advertise brand safety from the app. - Allowed values: `low`, `medium`, `high` - `adultRisk` (enum, optional) — The risk to brand safety from potential adult images and content detected within the app. - Allowed values: `low`, `medium`, `high` - `violenceRisk` (enum, optional) — The risk to brand safety from potential violent imagery and content detected within the app. - Allowed values: `low`, `medium`, `high` - `imageData` (list of BrandSafetyContentBrandSafetyImageDataItems, optional) — The image by image breakdown of brand safety risk factors based on advanced image processing and machine learning. ### AppPermissionsPermissionsItems Permission information. - `name` (string, optional) — The permission name. - `description` (string, optional) — The permission description. - `isDangerous` (boolean, optional) — 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` (enum, optional) — The IVT Risk for the permission. - Allowed values: `low`, `medium`, `high` ### InvalidTrafficGivtTypesItems - `fraudType` (string, optional) — The type of SIVT fraud. - `givt` (double, optional) — GIVT refers to General Invalid Traffic - Deterministically judged to be non-human traffic; high to very high risk. ### InvalidTrafficSivtTypesItems - `fraudType` (string, optional) — The type of SIVT fraud. - `sivt` (double, optional) — SIVT refers to Sophisticated Invalid Traffic - Probabilistically judged to be non-human traffic using advanced statistical detection methods; moderate to high risk traffic. ### ViewabilityByAdSizesItems Viewability by add size. - `adSize` (string, optional) — The size of the ad. - `inventory` (integer, optional) — The estimated volume of programmatic ad impressions by ad size. - `inventoryRatio` (double, optional) — The estimated percentage of inventory by ad size. - `viewability` (double, optional) — The average viewability for impressions by ad size. ### InventoryByDeviceItems inventory by device. - `device` (string, optional) — The device. - `inventory` (integer, optional) — The estimated volume of programmatic ad impressions by device. - `inventoryRatio` (double, optional) — The estimated percentage of inventory by device. - `ivt` (double, optional) — The total percentage of non-human traffic measured on the app by device. - `viewability` (double, optional) — The average viewability for impressions by device. ### InventoryByRegionItems inventory by region. - `region` (string, optional) — The region. - `inventory` (integer, optional) — The estimated volume of programmatic ad impressions by region. - `inventoryRatio` (double, optional) — The estimated percentage of inventory by region. - `ivt` (double, optional) — The total percentage of non-human traffic measured on the app by region. - `viewability` (double, optional) — The average viewability for impressions by region. ### InventoryByCountyItems inventory by country. - `countryName` (string, optional) — The county name. - `inventory` (integer, optional) — The estimated volume of programmatic ad impressions by country. - `inventoryRatio` (double, optional) — The estimated percentage of inventory by country. - `ivt` (double, optional) — The total percentage of non-human traffic measured on the app by country. - `viewability` (double, optional) — The average viewability for impressions by country. ### InventoryByAdsizeItems inventory by ad size. - `adSize` (string, optional) — The ad size. - `inventory` (integer, optional) — The estimated volume of programmatic ad impressions by ad size. - `inventoryRatio` (double, optional) — The estimated percentage of inventory by ad size. - `ivt` (double, optional) — The total percentage of non-human traffic measured on the app by ad size. - `viewability` (double, optional) — The average viewability for impressions by ad size. ### InventoryByDmaItems inventory by DMA. - `dmaName` (string, optional) — The DMA name. - `inventory` (integer, optional) — The estimated volume of programmatic ad impressions by DMA. - `inventoryRatio` (double, optional) — The estimated percentage of inventory by DMA. - `ivt` (double, optional) — The total percentage of non-human traffic measured on the app by DMA. - `viewability` (double, optional) — The average viewability for impressions by DMA. ### CtrByAdSizeItems CTR by ad size. - `adSize` (string, optional) — The ad size. - `ctr` (double, optional) — The Click Through Rate. ### RankingsFinal The final grade and score for the app. - `grade` (string, optional) — The final grade for the app. - `score` (string, optional) — The final score for the app. ### RankingsIvt The IVT grade and score for the app. - `grade` (string, optional) — The IVT grade for the app. - `score` (string, optional) — The IVT score for the app. ### RankingsAdsTxt The ads.txt grade and score for the app. - `grade` (string, optional) — The ads.txt grade for the app. - `score` (string, optional) — The ads.txt score for the app. ### RankingsBrandSafety The brand safety grade and score for the app. - `grade` (string, optional) — The brand safety grade for the app. - `score` (string, optional) — The brand safety score for the app. ### RankingsViewability The viewability grade and score for the app. - `grade` (string, optional) — The viewability grade for the app. - `score` (string, optional) — The viewability score for the app. ### RankingsPermissions The permissions grade and score for the app. - `grade` (string, optional) — The permissions grade for the app. - `score` (string, optional) — The IVT score for the app. ### RankingsPopularity The popularity grade and score for the app. - `grade` (string, optional) — The popularity grade for the app. - `score` (string, optional) — The popularity score for the app. ### RankingsByCountryReachItems Reach by country. - `countryCode` (string, optional) — The ISO ALPHA-2 standard country code. - `countryName` (string, optional) — The country name. - `mauRank` (string, optional) — The current MAU ranking for the app for this country. - `mauRankChange` (string, optional) — The change in MAU rank since last assessment. ### RankingsByCountryMarketShareItems Market share by country. - `countryCode` (string, optional) — The ISO ALPHA-2 standard country code. - `countryName` (string, optional) — The country name. - `impressionRank` (string, optional) — The current impression ranking for the app for this country. - `impsRankChange` (string, optional) — The change in impression ranking since last assessment. ### CoppaPermissionsItems permission. - `name` (string, optional) — The name of the permission. - `description` (string, optional) — The permissions description. ### BrandSafetyContentBrandSafetyImageDataItems The image, extracted text, and brand safety risk factors associated with the image. - `url` (string, optional) — A URL to the image. - `text` (string, optional) — The extracted text. - `violenceRisk` (enum, optional) — The risk to brand safety from potential violence images and any extracted text. - Allowed values: `low`, `medium`, `high` - `spoofRisk` (enum, optional) — The risk to brand safety from potential spoofing based on images and any extracted text. - Allowed values: `low`, `medium`, `high` - `medicalRisk` (enum, optional) — The risk to brand safety from potential medical images and any extracted text. - Allowed values: `low`, `medium`, `high` - `adultRisk` (enum, optional) — The risk to brand safety from potential adult images images and any extracted text. - Allowed values: `low`, `medium`, `high` ## Examples **Response** ```json { "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 } } ] } ``` **SDK Code** ```python import requests url = "https://api.pixalate.com/api/v2/mrt/apps/1407852246" querystring = {"device":"smartphone","region":"APAC"} headers = {"x-api-key": ""} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript const url = 'https://api.pixalate.com/api/v2/mrt/apps/1407852246?device=smartphone®ion=APAC'; const options = {method: 'GET', headers: {'x-api-key': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.pixalate.com/api/v2/mrt/apps/1407852246?device=smartphone®ion=APAC" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("x-api-key", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.pixalate.com/api/v2/mrt/apps/1407852246?device=smartphone®ion=APAC") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["x-api-key"] = '' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.pixalate.com/api/v2/mrt/apps/1407852246?device=smartphone®ion=APAC") .header("x-api-key", "") .asString(); ``` ```php request('GET', 'https://api.pixalate.com/api/v2/mrt/apps/1407852246?device=smartphone®ion=APAC', [ 'headers' => [ 'x-api-key' => '', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.pixalate.com/api/v2/mrt/apps/1407852246?device=smartphone®ion=APAC"); var request = new RestRequest(Method.GET); request.AddHeader("x-api-key", ""); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["x-api-key": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://api.pixalate.com/api/v2/mrt/apps/1407852246?device=smartphone®ion=APAC")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```