Bulk creative result | HUMAN Documentation

[
  {
    "status": "in_progress",
    "ad": {
      "creative_id": "506584300",
      "adomain": [
        "adomain.com"
      ],
      "cat": [
        "IAB-1"
      ],
      "cattax": 5,
      "iurl": "http://iurl.com",
      "ext": {
        "hs_aqp_ad_id": "672cde741783bebd1cb6a1ad",
        "landing_page": "https://example.com/landing-page",
        "brand": "ExampleBrand",
        "ad_format": "HTML5_DISPLAY",
        "custom_account_ids": {
          "seat_id": "seat42",
          "organization_id": "org123",
          "agency_id": "agency123",
          "advertiser_id": "adv456",
          "publisher_id": "pub789",
          "site_id": "site101",
          "campaign_id": "camp112",
          "bidder_id": "testbidder"
        },
        "screenshot": "https://storage.googleapis.com/..."
      },
      "categories_and_brands": {
        "detected_brands": [
          "Boiron"
        ],
        "detected_content_categories": [
          {
            "cat_type": "HS Category",
            "id": "1",
            "name": "/Health/Health Conditions/Infectious Diseases/Other"
          }
        ],
        "domain": "igtb.com",
        "general_brand": "Boiron",
        "general_category": "IAB Tier 2 287 Diseases and Conditions"
      },
      "destinations": [
        {
          "landing_page_url": "https://us.budweiser.com/",
          "general_category": "IAB Tier 2 211 Alcoholic Beverages",
          "general_brand": "Budweiser",
          "http_redirects": [
            "https://ad.doubleclick.net/pcs/click?xai=AKAOjsuplIwhu640",
            "https://shop.mikmak.ai/social/click?ct=665334455"
          ],
          "renderer": "crawler",
          "detected_content_categories": [
            "/Food & Drink/Beverages/Alcoholic Beverages",
            "Food & Drink/Cooking & Recipes/Desserts"
          ],
          "detected_brands": [
            "Budweiser",
            "NBC",
            "Olympus Corporation"
          ]
        }
      ],
      "network_load": {
        "html": 555815,
        "image": 101206,
        "javascript": 82880,
        "load_time_fcp": 1450,
        "total_size": 739901
      },
      "security": {
        "is_ssl": false,
        "ssl_error": true,
        "cookies": false,
        "flash_content": false
      },
      "audit": {
        "status": "passed",
        "feedback": [
          {
            "detected": "malvertising",
            "status": "failed",
            "reason": "TI-35",
            "geo": [
              "UK"
            ],
            "device": "Samsung SM-S918U",
            "user_agent": "Chrome Mobile In-App",
            "user_agent_os": "Android",
            "time": 1743849600
          }
        ]
      }
    }
  }
]

We recommend using the Push Result API to let HUMAN push results to your webhook endpoint instead of the Pulling API whenever possible. This is because the Push Result API:

Lets HUMAN send you results in close to real time
Lets you receive both Ad Quality results as soon as they are ready
Lets you receive Malvertising threats as soon as HUMAN flags them

However, if your organization cannot use the Push Result API, you can use the Pulling API as an alternative to receive analysis results.

HUMAN will provide the HUMAN-API-URL and X-API-KEY during the integration process.

Checks whether HUMAN has finished scanning creatives and, if so, returns the results of HUMAN’s analysis for a specific list of creative IDs.

If we’ve finished analyzing: The response will include the full results of our analysis.
If we haven’t finished analyzing: The response will only include basic information about the creative’s status.

This endpoint returns an array of creative result objects. Each object uses the same structure as the Single creative result endpoint.

<Note> We recommend using the [Push Result API](/advertising/reference/push-result-api-overview) to let HUMAN push results to your webhook endpoint instead of the Pulling API whenever possible. This is because the Push Result API: * Lets HUMAN send you results in close to real time * Lets you receive both Ad Quality results as soon as they are ready * Lets you receive Malvertising threats as soon as HUMAN flags them However, if your organization cannot use the Push Result API, you can use the Pulling API as an alternative to receive analysis results. HUMAN will provide the `HUMAN-API-URL` and `X-API-KEY` during the integration process. </Note> Checks whether HUMAN has finished scanning creatives and, if so, returns the results of HUMAN’s analysis for a specific list of creative IDs. * If we've finished analyzing: The response will include the full results of our analysis. * If we haven't finished analyzing: The response will only include basic information about the creative's status. This endpoint returns an array of creative result objects. Each object uses the same structure as the [Single creative result](/advertising/reference/get-creative-by-id) endpoint.

Authentication

X-API-KEYstring

Your unique Ad Quality API key.

Query parameters

adFormatenumRequired

Allowed values:

updatedstringRequired

Date last changed.

offsetintegerRequired

Parameter controlling the starting point within the collection of results.

limitintegerRequired

Limit number of results returned from the request.

Response

Request submitted properly

statusenumOptional

Creative processing status - the creative’s status in HUMAN’s processing queue. Hover over each status for details.

adobjectOptional

An IAB-compliant object that follows the structure outlined in the IAB’s AdCom specification.

If HUMAN discovers this creative through the HUMAN Security Network, values in the ad and ad.ext objects may be populated from their standard OpenRTB representation (used in bid requests and Prebid Server) and from their native mapping in the Prebid.js response object.

Errors

400

Bad Request Error

401

Unauthorized Error