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

1{
2 "ad": {
3 "adomain": [
4 "andromaco.com"
5 ],
6 "audit": {
7 "status": "unknown"
8 },
9 "categories_and_brands": {
10 "domain": "andromaco.com",
11 "general_category": "/Health/Pharmacy/Drugs & Medications"
12 },
13 "creative_id": "231650031617711861",
14 "ext": {
15 "ad_format": "HTML5_DISPLAY",
16 "custom_account_ids": {
17 "bidder_id": "bidder_x",
18 "organization_id": "org_123"
19 },
20 "hs_aqp_ad_id": "675d7f1394fc3805746506cb"
21 },
22 "security": {
23 "is_ssl": true
24 }
25 },
26 "status": "in_progress"
27}

Creative is in progress during late analysis

1{
2 "ad": {
3 "adomain": [
4 "ellos.no"
5 ],
6 "audit": {
7 "feedback": [
8 {
9 "detected": "nudity",
10 "reason": "Nudity",
11 "status": "failed",
12 "time": 1734181035
13 },
14 {
15 "detected": "ad_large_size",
16 "reason": "Ad file size exceeds 339.95 Kb",
17 "status": "warning",
18 "time": 1734181035
19 }
20 ],
21 "status": "unknown"
22 },
23 "categories_and_brands": {
24 "detected_brands": [
25 "Ellos"
26 ],
27 "detected_content_categories": [
28 {
29 "cat_type": "HS Category",
30 "id": "1",
31 "name": "/Shopping/Apparel/Women's Clothing"
32 },
33 {
34 "cat_type": "IAB Tier 1",
35 "id": "552",
36 "name": "Style & Fashion"
37 },
38 {
39 "cat_type": "IAB Tier 2",
40 "id": "560",
41 "name": "Women's Fashion"
42 }
43 ],
44 "domain": "ellos.no",
45 "general_brand": "Ellos",
46 "general_category": "IAB Tier 2 560 Women's Fashion"
47 },
48 "creative_id": "489760109",
49 "destinations": [
50 {
51 "detected_content_categories": [
52 "/Shopping/Apparel/Other",
53 "/Shopping/Mass Merchants & Department Stores",
54 "/Home & Garden/Home Furnishings/Other"
55 ],
56 "general_category": "Ellos",
57 "http_redirects": [
58 "https://www.ellos.no/?utm_source=RTB&utm_medium=display&utm_campaign=display_retargeting",
59 "https://ams.creativecdn.com/clicks?id=20241214_980lbWL8IP2VeTqnH2N0&tk=..."
60 ],
61 "landing_page_url": "https://www.ellos.no/?utm_source=RTB&utm_medium=display&utm_campaign=display_retargeting",
62 "renderer": "crawler"
63 }
64 ],
65 "ext": {
66 "ad_format": "HTML5_DISPLAY",
67 "custom_account_ids": {
68 "bidder_id": "bidder_x",
69 "organization_id": "org_123"
70 },
71 "hs_aqp_ad_id": "675d6ea394fc380574650579",
72 "screenshot": "https://storage.googleapis.com/..."
73 },
74 "network_load": {
75 "html": 348111,
76 "image": 31348,
77 "javascript": 82830,
78 "load_time_fcp": 3274,
79 "total_size": 462289
80 },
81 "security": {
82 "is_ssl": true
83 }
84 },
85 "status": "in_progress"
86}

Display creative failed for alcohol policy

1{
2 "status": "processed",
3 "ad": {
4 "creative_id": "gkee73l9",
5 "adomain": [
6 "smirnoff.com"
7 ],
8 "categories_and_brands": {
9 "domain": "smirnoff.com",
10 "general_category": "IAB Tier 2 211 Alcoholic Beverages"
11 },
12 "ext": {
13 "hs_aqp_ad_id": "669c64a9b2d49b2a92859102",
14 "ad_format": "HTML5_DISPLAY",
15 "custom_account_ids": {
16 "bidder_id": "bidder_x"
17 },
18 "screenshot": "https://storage.googleapis.com/..."
19 },
20 "network_load": {
21 "total_size": 1105281,
22 "html": 591000,
23 "image": 77805,
24 "javascript": 436476,
25 "load_time_fcp": 1328
26 },
27 "security": {
28 "is_ssl": false
29 },
30 "destinations": [
31 {
32 "landing_page_url": "https://shop.mikmak.ai/social/667ca1fe04ca5e0f0efcbd7a?utm_source=programmatic",
33 "http_redirects": [
34 "https://shop.mikmak.ai/social/667ca1fe04ca5e0f0efcbd7a?utm_source=programmatic",
35 "https://ad.doubleclick.net/pcs/click?xai=AKAOjsuplIwhu640..."
36 ],
37 "renderer": "crawler",
38 "general_category": "IAB Tier 2 211 Alcoholic Beverages",
39 "detected_content_categories": [
40 "/Food & Drink/Beverages/Alcoholic Beverages",
41 "/Food & Drink/Cooking & Recipes/Desserts"
42 ]
43 }
44 ],
45 "audit": {
46 "status": "failed",
47 "feedback": [
48 {
49 "detected": "alcohol",
50 "status": "failed",
51 "reason": "Alcohol",
52 "time": 1734181035
53 }
54 ]
55 }
56 }
57}

Display creative failed for heavy ad policy

1{
2 "status": "processed",
3 "ad": {
4 "creative_id": "ahgkriu8",
5 "adomain": [
6 "cvs.com"
7 ],
8 "categories_and_brands": {
9 "domain": "cvs.com",
10 "general_category": "/Health/Pharmacy/Other"
11 },
12 "ext": {
13 "hs_aqp_ad_id": "66904ee4fdb5563a4493f578",
14 "ad_format": "HTML5_DISPLAY",
15 "custom_account_ids": {
16 "bidder_id": "bidder_x"
17 },
18 "screenshot": "https://storage.googleapis.com/..."
19 },
20 "network_load": {
21 "total_size": 11020049,
22 "html": 273624,
23 "image": 9611551,
24 "javascript": 1134874,
25 "load_time_fcp": 1693
26 },
27 "security": {
28 "is_ssl": false
29 },
30 "destinations": [
31 {
32 "landing_page_url": "https://www.cvs.com/shop/merch/tampax-advil-cvs?widgetID=39r1nq3j",
33 "http_redirects": [
34 "https://www.cvs.com/shop/merch/tampax-advil-cvs?widgetID=39r1nq3j",
35 "https://dts.innovid.com/clktru/action/htmlclk?placement_tag_id=0&r=800af8b8bfdc..."
36 ],
37 "renderer": "crawler"
38 }
39 ],
40 "audit": {
41 "status": "failed",
42 "feedback": [
43 {
44 "detected": "heavy_ad",
45 "status": "failed",
46 "reason": "Ad size exceeds 10762kb",
47 "time": 1734181035
48 }
49 ]
50 }
51 }
52}

Failed creative for malvertising

1{
2 "status": "processed",
3 "ad": {
4 "creative_id": "308_121432_4_17",
5 "audit": {
6 "status": "failed",
7 "feedback": [
8 {
9 "detected": "malvertising",
10 "status": "failed",
11 "reason": "TI-35",
12 "time": 1734098434,
13 "user_agent": "Chrome Mobile In-App",
14 "user_agent_os": "Android",
15 "device": "Samsung SM-S911U"
16 }
17 ]
18 }
19 }
20}

Display creative passed all policies

1{
2 "status": "processed",
3 "ad": {
4 "creative_id": "584270650",
5 "adomain": [
6 "peacocktv.com"
7 ],
8 "categories_and_brands": {
9 "domain": "peacocktv.com",
10 "general_category": "IAB Tier 2 521 Olympic Sports",
11 "detected_content_categories": [
12 {
13 "id": "1",
14 "cat_type": "HS Category",
15 "name": "/Sports/International Sports Competitions/Olympics"
16 },
17 {
18 "id": "483",
19 "cat_type": "IAB Tier 1",
20 "name": "Sports"
21 },
22 {
23 "id": "521",
24 "cat_type": "IAB Tier 2",
25 "name": "Olympic Sports"
26 }
27 ],
28 "general_brand": "Peacock",
29 "detected_brands": [
30 "Peacock",
31 "NBC"
32 ]
33 },
34 "ext": {
35 "hs_aqp_ad_id": "669fe8a67c25d83831ee7d89",
36 "ad_format": "HTML5_DISPLAY",
37 "custom_account_ids": {
38 "bidder_id": "bidder_x"
39 },
40 "screenshot": "https://storage.googleapis.com/..."
41 },
42 "network_load": {
43 "total_size": 631153,
44 "html": 616232,
45 "image": 14921,
46 "javascript": -1,
47 "load_time_fcp": 1324
48 },
49 "security": {
50 "is_ssl": true
51 },
52 "destinations": [
53 {
54 "landing_page_url": "https://www.peacocktv.com/sports/olympics?cid=2407olyparispfpkpddisp33953",
55 "http_redirects": [
56 "https://www.peacocktv.com/sports/olympics?cid=2407olyparispfpkpddisp33953",
57 "https://ad.doubleclick.net/pcs/click?xai=AKAOjst2c-5D4BQHFrurj4eQppTUdPywbRsKN..."
58 ],
59 "renderer": "crawler",
60 "general_category": "IAB Tier 2 521 Olympic Sports",
61 "detected_content_categories": [
62 "/Sports/International Sports Competitions/Olympics",
63 "/Arts & Entertainment/TV & Video/Online Video"
64 ]
65 }
66 ],
67 "audit": {
68 "status": "passed"
69 }
70 }
71}

Display creative passed all policies with minimal viable data

1{
2 "status": "processed",
3 "ad": {
4 "creative_id": "584270650",
5 "audit": {
6 "status": "passed"
7 }
8 }
9}