YouTube Ad Results API
When a YouTube search contains advertisements, they are parsed and exist within the ads_results
array in the JSON output.
API Examples
Results for: video ads
When SerpApi encounters video ads results, we add them to our JSON output as the array ads_results
. For each ads result, we are able to extract its title
, link
, channel
, views
, thumbnail
and more.
{
...
"ads_results": [
{
"position_on_page": 1,
"title": "LEGO® Star Wars™ Ahch-To Porg™ Pandemonium",
"link": "https://www.youtube.com/watch?v=eV7aLkblQys",
"serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=eV7aLkblQys",
"channel": {
"name": "LEGO",
"link": "https://www.youtube.com/user/LEGO"
},
"views": 1300000.0,
"description": "Watch Luke and Rey get interrupted by a determined group of Porgs!",
"length": "1:26",
"thumbnail": {
"static": "https://i4.ytimg.com/vi/eV7aLkblQys/0.jpg",
"rich": "https://i.ytimg.com/an_webp/eV7aLkblQys/mqdefault_6s.webp?du=3000&sqp=CM6W9fwF&rs=AOn4CLCGK-XJOEnYo_iNGtkkbLNarYFLSA"
}
}
],
...
}
Results for: video ads
with website
For some ads, there is a website link (as highlighted in the image). SerpApi is able to make sense of this information and extract its as website
{
...
"ads_results": [
{
"position_on_page": 1,
"title": "Marvel Studios' Thor: Love and Thunder | Now Streaming on Disney ",
"link": "https://www.youtube.com/watch?v=sNh1V4A4oPU",
"serpapi_link": "https://serpapi.com/search.json?engine=youtube_video&v=sNh1V4A4oPU",
"website": "https://www.disneyplus.com/?cid=DSS-ProgVideo-DBM-28385008-344844788-536362859-176949190",
"channel": {
"name": "Disney Plus",
"link": "https://www.youtube.com/channel/UCIrgJInjLS2BhlHOMDW7v0g"
},
"description": "Get the popcorn out and witness the story of a legendary space viking.",
"length": "0:42",
"thumbnail": {
"static": "https://i3.ytimg.com/vi/sNh1V4A4oPU/0.jpg",
"rich": "https://i.ytimg.com/an_webp/sNh1V4A4oPU/mqdefault_6s.webp?du=3000&sqp=CNS3ypwG&rs=AOn4CLBQKZtliliATEz-E7qZe1dWM50Axg"
}
}
],
...
}
Results for: horizontal ads
When SerpApi encounters horizontal ads results, we add them to our JSON output as the array ads_results
. For each ads result, we are able to extract its title
, link
, source
, extensions
and thumbnail
.
{
...
"ads_results": [
{
"position_on_page": 1,
"items": [
{
"title": "42\" 4 - Blade Flush Mount Ceiling Fan with Pull Chain and Light Kit Included 888 Cool Fans",
"link": "https://www.googleadservices.com/pagead/aclk?sa=L&ai=CIYezFl2dX6ilDd_b-LYP8Me2cIyo7upcscS56doLABABIAAoKGDJBoIBF2NhLXB1Yi02MjE5ODExNzQ3MDQ5MzcxoAGukKH6A7ACm9KglKkaqAMEqgT6AU_QUxklGoTtMj8dllKaWGoqFsd8otUJWa5oXWw3xclzlIjMj5gxXGtc9l5o3cjX4WPgeUnoem0BProLbZBXnx5II3i5t33OkcmvVaNAvC-nKtnXP6yEf0oa4a6MwgU2etPym16d_s06o1lcQaARIn3fvZ4elDOh3B-BnWIP7sgD2SjxhLfAQrH2AWhmkWy6twnhDd7hAsUlGQDsM7qlZeI2KLH37fgRaD-ifOnUU8vVYqzDYjscoxLTNwF80l8qjP-MbOsNmUnGvT_vLeqJp4bfszajaDInCB7YqYfDkqTVg5LbdEV0VzWTAtgVOvyjN2141mNcT-Y9W0SSBQIIEsAFBaAGJoAHgpPzQpAHBKgHqNIbqAe2B6gH4M8bqAfp1BuoB7bXG6gHjM0bqAex3BuoB_DZG6gHwtob0ggFCIBBEAHICQSYCwG6CxkIAxADGAogDCgHMAVAAUgAYABoAHAoiAEA0AsT4BK66pTLnrSc3SWwFAPAFYGAgEA&num=1&cid=CAASFeRoTp-es8mZP2i0x2TW2GBUybCftw&sig=AOD64_0I6zlqNku3onJuW8BK56dJDz3GMw&adurl=https://www.wayfair.com/888-Cool-Fans--42-4-Blade-Flush-Mount-Ceiling-Fan-with-Pull-Chain-and-Light-Kit-Included-F420001064-L230-K~HGIE1095.html?refid=GX433582254857-HGIE1095&device=c&ptid=904401529115&network=ytv&targetid=&channel=GooglePLA&ireid=78482171&fdid=1817&ctype=5",
"source": "Wayfair",
"extensions": [
"$175.99"
],
"thumbnail": "https://yt3.ggpht.com/proxy/b-8aAZaN_hV1yHcNvPMXYgM8qg42W9bIJTfBor6rlPSXz_ndJba1D_ayuHzFlyVTdy59D5ZS9nCP_Qn-zO-SSbbkZ9ySJJ8bHyym9qaGP6hghyelLGdvw7FYAVCjoGzRqWYFgbneAEUddoiQADNUrChzMpAczjtJjM1duhUEggPKRGs=w138-h138-c0xffffffff-nd-pd"
},
{
"title": "Tyron Avengers Team Room Darkening Curtain Panels Zoomie Kids Size per Panel: 63\" x 42\"",
"link": "https://www.googleadservices.com/pagead/aclk?sa=L&ai=CCujXFl2dX6ilDd_b-LYP8Me2cNWO9pBdueTqjuALABACIAAoKGDJBoIBF2NhLXB1Yi02MjE5ODExNzQ3MDQ5MzcxoAGukKH6A7AC2fD-rqYbqAMEqgT5AU_Qc3UnGoTtMj8dllKaWGoqFsd8otUJWa5oXWw3xclzlIjMj5gxXGtc9l5o3cjX4WPgeUnoem0BProLbZBXnx5II3i5t33OkcmvVaNAvC-nKtnXP6yEf0oa4a6MwgU2etPym16d_s06o1lcQaARIn3fvZ4elDOh3B-BnWIP7sgD2SjxhLfAQrH2AWhmkWy6twnhDd7hAsUlGQDsM7qlZeI2KLH37fgRaD-ifOnUU8vVYqzDYjscoxLTNwF80l8qjP-MbOsNmUnGvT_vLeqJp4bfszajaDInCB6hy8zNkqSJdnM9iWte5qxDCECFPPgXaBw1e3ndQcxelZIFAggSwAUFoAYmgAf7yIlFkAcEqAeo0huoB7YHqAfgzxuoB-nUG6gHttcbqAeMzRuoB7HcG6gH8NkbqAfC2hvSCAUIgEEQAcgJBJgLAboLGQgDEAMYCiAMKAcwBUABSABgAGgAcCiIAQDQCxPgEt7CwOmRiMTgebAUA8AVgYCAQA&num=2&cid=CAASFeRoTp-es8mZP2i0x2TW2GBUybCftw&sig=AOD64_3DdMpGNNoaqCq1p-LDaw8QqSU70w&adurl=https://www.wayfair.com/Zoomie-Kids--Tyron-Avengers-Team-Room-Darkening-Curtain-Panels-X114568227-L6260-K~W003457116.html?refid=GX441953803630-W003457116_2126498775&device=c&ptid=938012031065&network=ytv&targetid=&channel=GooglePLA&ireid=65695175&fdid=1817&PiID%5B%5D=2126498775&ctype=5",
"source": "Wayfair",
"extensions": [
"$34.99"
],
"thumbnail": "https://yt3.ggpht.com/proxy/7qpEsO_iFqERMkNgFBBM7uocnC_FXMN4z4DFB3WIUBFVGgmPAfbkvSUQkYOMc4ygod7ykT8dZxLzxOQa3uy7WaXLr7ag-MuBi9rd5H_wSOhKuPUTWjdAQbOU7j3xwPSJVA-KjWWt7kbW6HV5FIMS9Gs_AZooqGacK_g7w8HhuaQIgQ=w138-h138-c0xffffffff-nd-pd"
},
{
"title": "Marvel Avengers Loki Scepter Necklace",
"link": "https://www.googleadservices.com/pagead/aclk?sa=L&ai=CTzYdFl2dX6ilDd_b-LYP8Me2cMbll9xf3fjo_sMIABADIAAoKGDJBoIBF2NhLXB1Yi02MjE5ODExNzQ3MDQ5MzcxoAGDqKv8ArAC0_Hgt-ESqAMEqgT5AU_QE1EgGoTtMj8dllKaWGoqFsd8otUJWa5oXWw3xclzlIjMj5gxXGtc9l5o3cjX4WPgeUnoem0BProLbZBXnx5II3i5t33OkcmvVaNAvC-nKtnXP6yEf0oa4a6MwgU2etPym16d_s06o1lcQaARIn3fvZ4elDOh3B-BnWIP7sgD2SjxhLfAQrH2AWhmkWy6twnhDd7hAsUlGQDsM7qlZeI2KLH37fgRaD-ifOnUU8vVYqzDYjscoxLTNwF80l8qjP-MbOsNmUnGvT_vLeqJp4bfszajaDInCB7w0o2TkqS9b3M9oFANiKxDCECFPPhtITRYe3nvVtIdm5IFAggSwAUFoAYmgAeq_aYukAcEqAeo0huoB7YHqAfgzxuoB-nUG6gHttcbqAeMzRuoB7HcG6gH8NkbqAfC2hvSCAUIgEEQAcgJBJgLAboLGQgDEAMYCiAMKAcwBUABSABgAGgAcCiIAQDQCxPgEo_qrouJwu--c7AUA8AVgYCAQA&num=3&cid=CAASFeRoTp-es8mZP2i0x2TW2GBUybCftw&sig=AOD64_28BTDyK3dHBylCYrL2vhwhReCVVw&adurl=https://www.hottopic.com/product/marvel-avengers-loki-scepter-necklace/10528127.html?mr:trackingCode=030A247D-F8DA-E511-80FA-0050569475F3&mr:referralID=NA&mr:device=c&mr:adType=plaonline&mr:ad=327012155409&mr:keyword=&mr:match=&mr:tid=&mr:ploc=2840&mr:iloc=2840&mr:store=&mr:filter=644630460627&cm_mmc=CSE-_-GGL-_-PLA-_-DMY-_-Everything&ctype=5",
"source": "Hot Topic",
"extensions": [
"$10.50"
],
"thumbnail": "https://yt3.ggpht.com/proxy/65XV_Qn7-86U1AJu1GBgpKUZDzMzNNejvhFXk9QIsH9j8F0m3pAGP14Q_vc7_2Nw4B8KSBXArP6mwYFe7uj-are4D15ILXy3MYWnnC5HkhCCuIHqI-eQlE6ijb5-fSweGPAkA1P5PIOAjpHVaLGX-8Bb6FZMIo4L07zCc3t6gum0ECs=w138-h138-c0xffffffff-nd-pd"
},
{
"title": "Alayziah Patton 'Blue Circle' Graphic Print & Text Light Filtering Rod Pocket Curtain Panels Zoomie Kids",
"link": "https://www.googleadservices.com/pagead/aclk?sa=L&ai=CSWPSFl2dX6ilDd_b-LYP8Me2cNWO9pBdueTqjuALABAEIAAoKGDJBoIBF2NhLXB1Yi02MjE5ODExNzQ3MDQ5MzcxoAGukKH6A7ACoYH_rqYbqAMEqgT5AU_QE1EgGoTtMj8dllKaWGoqFsd8otUJWa5oXWw3xclzlIjMj5gxXGtc9l5o3cjX4WPgeUnoem0BProLbZBXnx5II3i5t33OkcmvVaNAvC-nKtnXP6yEf0oa4a6MwgU2etPym16d_s06o1lcQaARIn3fvZ4elDOh3B-BnWIP7sgD2SjxhLfAQrH2AWhmkWy6twnhDd7hAsUlGQDsM7qlZeI2KLH37fgRaD-ifOnUU8vVYqzDYjscoxLTNwF80l8qjP-MbOsNmUnGvT_vLeqJp4bfszajaDInCB6hy8zNkqSzMHM9iWte5qxDCECFPPgXaBw1e3ndQcxelZIFAggSwAUFoAYmgAf7yIlFkAcEqAeo0huoB7YHqAfgzxuoB-nUG6gHttcbqAeMzRuoB7HcG6gH8NkbqAfC2hvSCAUIgEEQAcgJBJgLAboLGQgDEAMYCiAMKAcwBUABSABgAGgAcCiIAQDQCxPgEoDkx8360Z_UBLAUA8AVgYCAQA&num=4&cid=CAASFeRoTp-es8mZP2i0x2TW2GBUybCftw&sig=AOD64_0viwB_YahvcgY6TWp8B2nGfr652w&adurl=https://www.wayfair.com/Zoomie-Kids--Alayziah-Patton-Blue-Circle-Graphic-Print-and-Text-Light-Filtering-Rod-Pocket-Curtain-Panels-X114568496-L6260-K~W003457385.html?refid=GX441953803630-W003457385&device=c&ptid=938012033185&network=ytv&targetid=&channel=GooglePLA&ireid=36029272&fdid=1817&ctype=5",
"source": "Wayfair",
"extensions": [
"$32.99"
],
"thumbnail": "https://yt3.ggpht.com/proxy/KvqwirB2AEsBjB4W12YH0w14dT8agOs1cW77f1NrYAz7r_l8op1eP0YyoXq2RLgQkFjhNJcVdVCzXuuFHRQvV9ZD5BqQgBLIcYjkauEZZh_w_9okmXpy74BjgawMuRzEsx2FDah3rXKl906oLvOElrtTiFUIQrT662OI7YQ-2DFi0c0=w138-h138-c0xffffffff-nd-pd"
},
{
"title": "Avengers: Endgame [Includes Digital Copy] [4K Ultra HD Blu-ray/Blu-ray] [2019]",
"link": "https://www.googleadservices.com/pagead/aclk?sa=L&ai=Cz-lqFl2dX6ilDd_b-LYP8Me2cMTQl_tfqtmp1pgLABAFIAAoKGDJBoIBF2NhLXB1Yi02MjE5ODExNzQ3MDQ5MzcxoAGIibn8A7ACjr3Oxq4JqAMEqgT5AU_QQysmGoTtMj8dllKaWGoqFsd8otUJWa5oXWw3xclzlIjMj5gxXGtc9l5o3cjX4WPgeUnoem0BProLbZBXnx5II3i5t33OkcmvVaNAvC-nKtnXP6yEf0oa4a6MwgU2etPym16d_s06o1lcQaARIn3fvZ4elDOh3B-BnWIP7sgD2SjxhLfAQrH2AWhmkWy6twnhDd7hAsUlGQDsM7qlZeI2KLH37fgRaD-ifOnUU8vVYqzDYjscoxLTNwF80l8qjP-MbOsNmUnGvT_vLeqJp4bfszajaDInCB718t7-kqTjJXM9gV8Lp6xDCECFPPhlOi5me3mWD55xm5IFAggSwAUFoAYmgAfL1ucCkAcEqAeo0huoB7YHqAfgzxuoB-nUG6gHttcbqAeMzRuoB7HcG6gH8NkbqAfC2hvSCAUIgEEQAZoJbmh0dHBzOi8vd3d3LmJlc3RidXkuY29tL3NpdGUvYXZlbmdlcnMtZW5kZ2FtZS1pbmNsdWRlcy1kaWdpdGFsLWNvcHktNGstdWx0cmEtaGQtYmx1LXJheS1ibHUtcmF5LTIwMTkvNjM0NDUxMS5wyAkEugsZCAMQAxgKIAwoBzAFQAFIAGAAaABwKIgBANALE-ALAeASjsW3u5njmZpPsBQDwBWBgIBA&num=5&cid=CAASFeRoTp-es8mZP2i0x2TW2GBUybCftw&sig=AOD64_0JBWE4putFkc1R2hlWCtPJe_nkNQ&adurl=http://clickserve.dartsearch.net/link/click?lid=92700051622320706&ds_s_kwgid=58700005670538335&ds_s_inventory_feed_id=97700000002890301&ds_a_cid=4726899&ds_a_caid=340159119&ds_a_agid=95676785438&ds_a_fiid=&ds_a_lid=&&ds_e_adid=418420145023&ds_e_matchtype=content&ds_e_device=c&ds_e_network=ytv&ds_e_product_group_id=321733762702&ds_e_product_id=6344511&ds_e_product_merchant_id=1311674&ds_e_product_country=US&ds_e_product_language=en&ds_e_product_channel=online&ds_e_product_store_id=&ds_url_v=2&ds_dest_url=https://t.myvisualiq.net/click_pixel?et=c&ago=212&ao=546&aca=71700000032867262&si=-2&ci=-2&pi=-2&ad=58700005670538335&sv1=92700051622320706&advt=-2&chnl=-2&vndr=1195&sz=6583&u={gclid}&red=https://www.bestbuy.com/site/avengers-endgame-includes-digital-copy-4k-ultra-hd-blu-ray-blu-ray-2019/6344511.p?skuId=6344511&ref=212&loc=1&ref=212&loc=BM01&gclsrc=aw.ds&&ctype=5",
"source": "Best Buy",
"extensions": [
"$24.99"
],
"thumbnail": "https://yt3.ggpht.com/proxy/QV3xJcXuo_qUJ-FyZ5C4qCqMFjE6B8JxeAUfcOjE4pdOhlqXo2DKlyb4LP0zDaC4NhD9hre-jmkfEUphxH5DBH_XUP8Bb78KsRIY7uxxc96PraMfC_PZwDRdlgtjWZsz5JhsxM-av0ZC-b5LYXXP8cU-8hFlYqeLS14mwFNzNjlO3qU=w138-h138-c0xffffffff-nd-pd"
},
{
"title": "Patton 'Heroic Age' Sheet Set Zoomie Kids",
"link": "https://www.googleadservices.com/pagead/aclk?sa=L&ai=C9FWsFl2dX6ilDd_b-LYP8Me2cNWO9pBd9LLAsZILABAGIAAoKGDJBoIBF2NhLXB1Yi02MjE5ODExNzQ3MDQ5MzcxoAGukKH6A7ACleiJ5_gXqAMEqgT5AU_QI38iGoTtMj8dllKaWGoqFsd8otUJWa5oXWw3xclzlIjMj5gxXGtc9l5o3cjX4WPgeUnoem0BProLbZBXnx5II3i5t33OkcmvVaNAvC-nKtnXP6yEf0oa4a6MwgU2etPym16d_s06o1lcQaARIn3fvZ4elDOh3B-BnWIP7sgD2SjxhLfAQrH2AWhmkWy6twnhDd7hAsUlGQDsM7qlZeI2KLH37fgRaD-ifOnUU8vVYqzDYjscoxLTNwF80l8qjP-MbOsNmUnGvT_vLeqJp4bfszajaDInCB6hy8zNkqTYdXM9iWte5qxDCECFPPgXaBw1e3ndQcxelZIFAggSwAUFoAYmgAf7yIlFkAcEqAeo0huoB7YHqAfgzxuoB-nUG6gHttcbqAeMzRuoB7HcG6gH8NkbqAfC2hvSCAUIgEEQAcgJBJgLAboLGQgDEAMYCiAMKAcwBUABSABgAGgAcCiIAQDQCxPgErT8k6rSq6WifLAUA8AVgYCAQA&num=6&cid=CAASFeRoTp-es8mZP2i0x2TW2GBUybCftw&sig=AOD64_3zReQIq96SsNDLd3UbjwaigvRi_g&adurl=https://www.wayfair.com/Zoomie-Kids--Patton-Heroic-Age-Sheet-Set-KG33192DE-L1224-K~W002046081.html?refid=GX434330092280-W002046081&device=c&ptid=822702404629&network=ytv&targetid=&channel=GooglePLA&ireid=32626185&fdid=1817&ctype=5",
"source": "Wayfair",
"extensions": [
"$40.99"
],
"thumbnail": "https://yt3.ggpht.com/proxy/IHirQBEx9V8JARDjOaahiKh22CHlBRiE3VlfI2UMSU98Z80SxaI5YjFyKDqB8Qx8kkOLBo-k3aN1mc7IaCKF_dnyZqplE4uKZ98F952RoZTnwehS6NAk_VVMHwmA5looy37fbnlnw4d4rwpYGYqXzKzg1w4sZw92PYLgDHBEPrFyesY=w138-h138-c0xffffffff-nd-pd"
},
...
]
},
...
],
...
}
Results for: text ads
When SerpApi encounters text ads results, we add them to our JSON output as the array ads_results
. For each ads result, we are able to extract its title
, link
and description
.
{
...
"ads_results": [
{
"position_on_page": 1,
"title": "Top 5 Tax Relief Attorneys - End Your IRS Tax Problems",
"link": "www.lendstart.com/tax-relief/attorneys",
"description": "You Don't Have to Face the IRS Alone. Get the Help You Need from Top Tax Relief Attorneys. 5 Best Tax Relief Companies of 2020. End Your Tax Nightmare Now. 100% Free Consultation. Tax Relief Help. Tax Relief Experts 2020. Top Brands Comparison. Tax Relief Brands. 2020's Top Ranks.",
},
{
"position_on_page": 2,
"title": "No Money To Pay IRS Back Taxes - Qualify for IRS Fresh Start",
"link": "www.taxreliefcenter.org/bbb-a rated/irs-fresh-start",
"description": "(Owe IRS $10K-$110K Back Taxes?) Check Eligibility. No Attorney Retainer Fees. Get 100% Free Tax Review. Serving All 50 States. Qualify - Hardship Relief. Highlights: BBB Accredited Business, No IRS Documents Required, Free Online Assessment Available.",
},
{
"position_on_page": 3,
"title": "Professional Tax Lawyers - Your Case Is Our Priority",
"link": "lp.federaltaxlawgroup.com/tax_lawyers/--",
"description": "We’ll Find a Resolution Plan or 100% Money Back Guarantee. Get Your Free Consultation! We’ll Work Directly With the IRS to Handle Your Tax So You Don’t Have to. Quick Tax Resolutions. Free Tax Relief Consult. Experienced Tax Attorney. Steps: Get Personalized Help, Call Us.",
},
...
],
...
}