Malvertising Defense & Ad Quality APIPulling API

Pulling API request and response examples

Below are extended response examples for the Pulling API endpoints:

The examples on this page show the structure of one creative result object. The GET Bulk creative result endpoint returns an array of those objects.

Creative is in progress during early analysis

{
  "ad": {
    "adomain": [
      "andromaco.com"
    ],
    "audit": {
      "status": "unknown"
    },
    "categories_and_brands": {
      "domain": "andromaco.com",
      "general_category": "/Health/Pharmacy/Drugs & Medications"
    },
    "creative_id": "231650031617711861",
    "ext": {
      "ad_format": "HTML5_DISPLAY",
      "custom_account_ids": {
        "bidder_id": "bidder_x",
        "organization_id": "org_123"
      },
      "hs_aqp_ad_id": "675d7f1394fc3805746506cb"
    },
    "security": {
      "is_ssl": true
    }
  },
  "status": "in_progress"
}

Creative is in progress during late analysis

{
  "ad": {
    "adomain": [
      "ellos.no"
    ],
    "audit": {
      "feedback": [
        {
          "detected": "nudity",
          "reason": "Nudity",
          "status": "failed",
          "time": 1734181035
        },
        {
          "detected": "ad_large_size",
          "reason": "Ad file size exceeds 339.95 Kb",
          "status": "warning",
          "time": 1734181035
        }
      ],
      "status": "unknown"
    },
    "categories_and_brands": {
      "detected_brands": [
        "Ellos"
      ],
      "detected_content_categories": [
        {
          "cat_type": "HS Category",
          "id": "1",
          "name": "/Shopping/Apparel/Women's Clothing"
        },
        {
          "cat_type": "IAB Tier 1",
          "id": "552",
          "name": "Style & Fashion"
        },
        {
          "cat_type": "IAB Tier 2",
          "id": "560",
          "name": "Women's Fashion"
        }
      ],
      "domain": "ellos.no",
      "general_brand": "Ellos",
      "general_category": "IAB Tier 2 560 Women's Fashion"
    },
    "creative_id": "489760109",
    "destinations": [
      {
        "detected_content_categories": [
          "/Shopping/Apparel/Other",
          "/Shopping/Mass Merchants & Department Stores",
          "/Home & Garden/Home Furnishings/Other"
        ],
        "general_category": "Ellos",
        "http_redirects": [
          "https://www.ellos.no/?utm_source=RTB&utm_medium=display&utm_campaign=display_retargeting",
          "https://ams.creativecdn.com/clicks?id=20241214_980lbWL8IP2VeTqnH2N0&tk=..."
        ],
        "landing_page_url": "https://www.ellos.no/?utm_source=RTB&utm_medium=display&utm_campaign=display_retargeting",
        "renderer": "crawler"
      }
    ],
    "ext": {
      "ad_format": "HTML5_DISPLAY",
      "custom_account_ids": {
        "bidder_id": "bidder_x",
        "organization_id": "org_123"
      },
      "hs_aqp_ad_id": "675d6ea394fc380574650579",
      "screenshot": "https://storage.googleapis.com/..."
    },
    "network_load": {
      "html": 348111,
      "image": 31348,
      "javascript": 82830,
      "load_time_fcp": 3274,
      "total_size": 462289
    },
    "security": {
      "is_ssl": true
    }
  },
  "status": "in_progress"
}

Display creative failed for alcohol policy

{
  "status": "processed",
  "ad": {
    "creative_id": "gkee73l9",
    "adomain": [
      "smirnoff.com"
    ],
    "categories_and_brands": {
      "domain": "smirnoff.com",
      "general_category": "IAB Tier 2 211 Alcoholic Beverages"
    },
    "ext": {
      "hs_aqp_ad_id": "669c64a9b2d49b2a92859102",
      "ad_format": "HTML5_DISPLAY",
      "custom_account_ids": {
        "bidder_id": "bidder_x"
      },
      "screenshot": "https://storage.googleapis.com/..."
    },
    "network_load": {
      "total_size": 1105281,
      "html": 591000,
      "image": 77805,
      "javascript": 436476,
      "load_time_fcp": 1328
    },
    "security": {
      "is_ssl": false
    },
    "destinations": [
      {
        "landing_page_url": "https://shop.mikmak.ai/social/667ca1fe04ca5e0f0efcbd7a?utm_source=programmatic",
        "http_redirects": [
          "https://shop.mikmak.ai/social/667ca1fe04ca5e0f0efcbd7a?utm_source=programmatic",
          "https://ad.doubleclick.net/pcs/click?xai=AKAOjsuplIwhu640..."
        ],
        "renderer": "crawler",
        "general_category": "IAB Tier 2 211 Alcoholic Beverages",
        "detected_content_categories": [
          "/Food & Drink/Beverages/Alcoholic Beverages",
          "/Food & Drink/Cooking & Recipes/Desserts"
        ]
      }
    ],
    "audit": {
      "status": "failed",
      "feedback": [
        {
          "detected": "alcohol",
          "status": "failed",
          "reason": "Alcohol",
          "time": 1734181035
        }
      ]
    }
  }
}

Display creative failed for heavy ad policy

{
  "status": "processed",
  "ad": {
    "creative_id": "ahgkriu8",
    "adomain": [
      "cvs.com"
    ],
    "categories_and_brands": {
      "domain": "cvs.com",
      "general_category": "/Health/Pharmacy/Other"
    },
    "ext": {
      "hs_aqp_ad_id": "66904ee4fdb5563a4493f578",
      "ad_format": "HTML5_DISPLAY",
      "custom_account_ids": {
        "bidder_id": "bidder_x"
      },
      "screenshot": "https://storage.googleapis.com/..."
    },
    "network_load": {
      "total_size": 11020049,
      "html": 273624,
      "image": 9611551,
      "javascript": 1134874,
      "load_time_fcp": 1693
    },
    "security": {
      "is_ssl": false
    },
    "destinations": [
      {
        "landing_page_url": "https://www.cvs.com/shop/merch/tampax-advil-cvs?widgetID=39r1nq3j",
        "http_redirects": [
          "https://www.cvs.com/shop/merch/tampax-advil-cvs?widgetID=39r1nq3j",
          "https://dts.innovid.com/clktru/action/htmlclk?placement_tag_id=0&r=800af8b8bfdc..."
        ],
        "renderer": "crawler"
      }
    ],
    "audit": {
      "status": "failed",
      "feedback": [
        {
          "detected": "heavy_ad",
          "status": "failed",
          "reason": "Ad size exceeds 10762kb",
          "time": 1734181035
        }
      ]
    }
  }
}

Failed creative for malvertising

{
  "status": "processed",
  "ad": {
    "creative_id": "308_121432_4_17",
    "audit": {
      "status": "failed",
      "feedback": [
        {
          "detected": "malvertising",
          "status": "failed",
          "reason": "TI-35",
          "time": 1734098434,
          "user_agent": "Chrome Mobile In-App",
          "user_agent_os": "Android",
          "device": "Samsung SM-S911U"
        }
      ]
    }
  }
}

Display creative passed all policies

{
  "status": "processed",
  "ad": {
    "creative_id": "584270650",
    "adomain": [
      "peacocktv.com"
    ],
    "categories_and_brands": {
      "domain": "peacocktv.com",
      "general_category": "IAB Tier 2 521 Olympic Sports",
      "detected_content_categories": [
        {
          "id": "1",
          "cat_type": "HS Category",
          "name": "/Sports/International Sports Competitions/Olympics"
        },
        {
          "id": "483",
          "cat_type": "IAB Tier 1",
          "name": "Sports"
        },
        {
          "id": "521",
          "cat_type": "IAB Tier 2",
          "name": "Olympic Sports"
        }
      ],
      "general_brand": "Peacock",
      "detected_brands": [
        "Peacock",
        "NBC"
      ]
    },
    "ext": {
      "hs_aqp_ad_id": "669fe8a67c25d83831ee7d89",
      "ad_format": "HTML5_DISPLAY",
      "custom_account_ids": {
        "bidder_id": "bidder_x"
      },
      "screenshot": "https://storage.googleapis.com/..."
    },
    "network_load": {
      "total_size": 631153,
      "html": 616232,
      "image": 14921,
      "javascript": -1,
      "load_time_fcp": 1324
    },
    "security": {
      "is_ssl": true
    },
    "destinations": [
      {
        "landing_page_url": "https://www.peacocktv.com/sports/olympics?cid=2407olyparispfpkpddisp33953",
        "http_redirects": [
          "https://www.peacocktv.com/sports/olympics?cid=2407olyparispfpkpddisp33953",
          "https://ad.doubleclick.net/pcs/click?xai=AKAOjst2c-5D4BQHFrurj4eQppTUdPywbRsKN..."
        ],
        "renderer": "crawler",
        "general_category": "IAB Tier 2 521 Olympic Sports",
        "detected_content_categories": [
          "/Sports/International Sports Competitions/Olympics",
          "/Arts & Entertainment/TV & Video/Online Video"
        ]
      }
    ],
    "audit": {
      "status": "passed"
    }
  }
}

Display creative passed all policies with minimal viable data

{
  "status": "processed",
  "ad": {
    "creative_id": "584270650",
    "audit": {
      "status": "passed"
    }
  }
}