For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
HUMAN DashboardHUMAN WebsiteRequest a Demo
Media SecurityMalvertising DefenseAPI Reference
Media SecurityMalvertising DefenseAPI Reference
  • Reporting API
    • About the Reporting API
  • MediaGuard API
    • About the MediaGuard API
  • Malvertising API
    • POSTSubmit a creative for ad quality review
    • Push Result API overview
      • GETBulk creative result
      • GETSingle creative result
LogoLogo
Login
Login
HUMAN DashboardHUMAN WebsiteRequest a Demo
Malvertising APIPulling API

Bulk creative result

GET
https://{human-api-url}/api-v2/creative_adqp/all
GET
/api-v2/creative_adqp/all
$curl -G https://{human-api-url}/api-v2/creative_adqp/all \
>     -H "X-API-KEY: <apiKey>" \
>     -d adFormat=HTML5_DISPLAY \
>     -d updated=updated \
>     -d offset=1 \
>     -d limit=1
1{
2  "status": "in_progress",
3  "ad": {
4    "creative_id": "506584300",
5    "adomain": [
6      "adomain.com"
7    ],
8    "cat": [
9      "IAB-1"
10    ],
11    "cattax": 5,
12    "iurl": "http://iurl.com",
13    "ext": {
14      "hs_aqp_ad_id": "672cde741783bebd1cb6a1ad",
15      "landing_page": "https://example.com/landing-page",
16      "brand": "ExampleBrand",
17      "ad_format": "HTML5_DISPLAY",
18      "custom_account_ids": {
19        "seat_id": "seat42",
20        "organization_id": "org123",
21        "agency_id": "agency123",
22        "advertiser_id": "adv456",
23        "publisher_id": "pub789",
24        "site_id": "site101",
25        "campaign_id": "camp112",
26        "bidder_id": "testbidder"
27      },
28      "screenshot": "https://storage.googleapis.com/..."
29    },
30    "categories_and_brands": {
31      "detected_brands": [
32        "Boiron"
33      ],
34      "detected_content_categories": [
35        {
36          "cat_type": "HS Category",
37          "id": "1",
38          "name": "/Health/Health Conditions/Infectious Diseases/Other"
39        }
40      ],
41      "domain": "igtb.com",
42      "general_brand": "Boiron",
43      "general_category": "IAB Tier 2 287 Diseases and Conditions"
44    },
45    "destinations": [
46      {
47        "landing_page_url": "https://us.budweiser.com/",
48        "general_category": "IAB Tier 2 211 Alcoholic Beverages",
49        "general_brand": "Budweiser",
50        "http_redirects": [
51          "https://ad.doubleclick.net/pcs/click?xai=AKAOjsuplIwhu640",
52          "https://shop.mikmak.ai/social/click?ct=665334455"
53        ],
54        "detected_content_categories": [
55          "/Food & Drink/Beverages/Alcoholic Beverages",
56          "Food & Drink/Cooking & Recipes/Desserts"
57        ],
58        "detected_brands": [
59          "Budweiser",
60          "NBC",
61          "Olympus Corporation"
62        ]
63      }
64    ],
65    "network_load": {
66      "html": 555815,
67      "image": 101206,
68      "javascript": 82880,
69      "load_time_fcp": 1450,
70      "total_sie": 739901
71    },
72    "security": {
73      "is_ssl": false,
74      "ssl_error": true,
75      "cookies": false,
76      "flash_content": false
77    },
78    "audit": {
79      "status": "passed",
80      "feedback": [
81        {
82          "detected": "cat_missing",
83          "status": "failed",
84          "reason": "Declared IAB Category is empty",
85          "geo": [
86            "UK"
87          ],
88          "device": "Samsung SM-S918U",
89          "user_agent": "Chrome Mobile In-App",
90          "user_agent_os": "Android"
91        }
92      ]
93    }
94  }
95}
<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 end 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> Provides results for bulk creatives submitted via the [Creative Submission API](/advertising/reference/submit-request). A successful response depends on whether HUMAN finished our analysis. * 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.
Was this page helpful?
Previous

Single creative result

Next
Built with

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 end 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.

Provides results for bulk creatives submitted via the Creative Submission API. A successful response depends on whether HUMAN finished our analysis.

  • 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.

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
statusenum

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

Allowed values:
adobject

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

Errors

400
Bad Request Error
401
Unauthorized Error