Get risk ratings and reputation for one website

{
  "status": "OK",
  "numFound": 1,
  "docs": [
    {
      "mfa": {
        "mfaRisk": "low",
        "adRefreshRate": 1,
        "adDensity": 5,
        "socialTrafficRate": 0.00024,
        "paidTrafficRate": 0
      },
      "AdDomain": "example.org",
      "region": "NA",
      "device": "desktop",
      "domainOverview": {
        "iabPrimaryCategory": [
          "News"
        ],
        "iabSubCategory": [
          "string"
        ],
        "hasAdsTxt": true
      },
      "riskOverview": {
        "ivt": 6.7,
        "ivtRisk": "medium",
        "viewability": 53.95,
        "viewabilityRisk": "medium",
        "brandSafetyRisk": "low",
        "risk": [
          {
            "region": "string",
            "device": "string",
            "pixalateRisk": "medium",
            "pixalateRiskReasons": [
              "Significantly Elevated IVT Percentage",
              "Ad Traffic Shows Some Suspicious Characteristics"
            ]
          }
        ]
      },
      "domainDetails": {
        "inventory": 892920,
        "desktopTrafficRatio": 94.13,
        "mobileTrafficRatio": 5.64,
        "videoTrafficRatio": 3.16,
        "ctr": 0.05,
        "familyOfSites": 36773,
        "pixalateRisk": "low",
        "bidPriceLow": "0",
        "bidPriceHigh": "0",
        "trustedSeller": "Example Ad Seller",
        "trueReach": "6602"
      },
      "trafficQualityRisk": {
        "ivtRisk": "medium",
        "clickFraudRisk": "medium",
        "viewabilityRisk": "low",
        "domainMaskingRisk": "low",
        "majorTrafficSource": "Direct"
      },
      "siteRisk": {
        "domainAge": 0,
        "hasPrivacyPolicy": true,
        "hasTermsAndConditions": true,
        "privateDomain": false,
        "corporateEmail": true,
        "adInjectionRisk": "low"
      },
      "siteInfo": {
        "owner": "Example, Inc.",
        "emailAddress": "jdoe@example.org",
        "contactNumber": "14085551212",
        "mailingAddress": "1234 Main Street, USA."
      },
      "brandSafetyRisk": {
        "adultContentRisk": "high",
        "alcoholContentRisk": "medium",
        "drugContentRisk": "medium",
        "hateSpeechRisk": "low",
        "phishingRisk": "medium",
        "malwareRisk": "medium"
      },
      "socialMediaRisk": {
        "facebookRisk": "medium",
        "linkedInRisk": "medium",
        "twitterRisk": "medium",
        "socialTrafficRatio": 0.11
      },
      "invalidTraffic": {
        "ivt": 7.76,
        "givt": 0.29,
        "sivt": 7.47,
        "givtTypes": [
          {
            "fraudType": "Data Center",
            "givt": 0.29
          }
        ],
        "sivtTypes": [
          {
            "fraudType": "AppSpoofing",
            "sivt": 2.78
          }
        ]
      },
      "inventory": {
        "byRegion": [
          {
            "region": "APAC",
            "inventory": 1,
            "inventoryRatio": 6.39,
            "ivt": 8.02,
            "viewability": 73.3
          }
        ],
        "byCountry": [
          {
            "countryName": "Romania",
            "inventory": 1,
            "inventoryRatio": 4.01,
            "ivt": 17.21,
            "viewability": 57.2
          }
        ],
        "byState": [
          {
            "stateName": "United States, California",
            "inventory": 1,
            "inventoryRatio": 15.62,
            "ivt": 5.94,
            "viewability": 53.38
          }
        ],
        "byAdsize": [
          {
            "adSize": "320x50",
            "inventory": 1,
            "inventoryRatio": 0.1,
            "ivt": 3.22,
            "viewability": 56.44
          }
        ],
        "byDma": [
          {
            "dma": "NEW YORK",
            "inventory": 1,
            "inventoryRatio": 6.39,
            "ivt": 5.45,
            "viewability": 54.79
          }
        ]
      },
      "authorizedSellers": [
        {
          "exchange": "Acme Exchange",
          "paymentType": "Direct",
          "inventory": 30039,
          "inventoryRatio": 12.87,
          "ivt": 0.9,
          "estBidLow": 0,
          "estBidHigh": 0,
          "viewability": 2.6
        }
      ],
      "viewability": {
        "viewability": 53.95,
        "byAdSize": [
          {
            "adSize": "728x90",
            "inventory": 7893,
            "inventoryRatio": 61.05,
            "viewability": 56.04
          }
        ]
      },
      "ctr": {
        "ctr": 6.03,
        "byAdSize": [
          {
            "adSize": "320x50",
            "ctr": 1.45
          }
        ]
      },
      "trafficSources": [
        {
          "trafficSource": "Discovery",
          "inventory": 1,
          "inventoryRatio": 6.39,
          "ivt": 8.02,
          "viewability": 73.3
        }
      ],
      "subDomains": [
        {
          "subDomain": "mail.example.org",
          "inventory": 1,
          "inventoryRatio": 52.39,
          "maskingRatio": 52.39,
          "ivt": 8.02,
          "viewability": 73.3
        }
      ],
      "deviceDistribution": {
        "byDevice": [
          {
            "device": "desktop",
            "inventory": 1,
            "inventoryRatio": 94.3,
            "maskingRatio": 52.39,
            "ivt": 8.02,
            "viewability": 73.3
          }
        ],
        "byDesktopOs": [
          {
            "os": "Windows 10",
            "inventory": 1,
            "inventoryRatio": 13.63
          }
        ],
        "byMobileOs": [
          {
            "os": "Android 1.x",
            "inventory": 1,
            "inventoryRatio": 9.29
          }
        ]
      }
    }
  ]
}

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

Authentication

x-api-keystring

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

Path parameters

adDomainstringRequired

The domain name.

Query parameters

regionenumOptional

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

Allowed values:

deviceenumOptional

Filter by device. All devices are returned by default.

Allowed values:

prettybooleanOptional

If true, return pretty JSON. Default is false.

Response

statusenumOptional

The returned status.

Allowed values:

numFoundintegerOptional

The total number of matching domains.

docslist of objectsOptional

A list of domains.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

5XX

Server Error