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.

Results for: video ads

JSON Example

{
  ...
  "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

Results for: video ads with website

JSON Example

{
  ...
  "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.

Results for: horizontal ads

JSON Example

{
  ...
  "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%3Frefid%3DGX433582254857-HGIE1095%26device%3Dc%26ptid%3D904401529115%26network%3Dytv%26targetid%3D%26channel%3DGooglePLA%26ireid%3D78482171%26fdid%3D1817&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%3Frefid%3DGX441953803630-W003457116_2126498775%26device%3Dc%26ptid%3D938012031065%26network%3Dytv%26targetid%3D%26channel%3DGooglePLA%26ireid%3D65695175%26fdid%3D1817%26PiID%255B%255D%3D2126498775&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%3Fmr:trackingCode%3D030A247D-F8DA-E511-80FA-0050569475F3%26mr:referralID%3DNA%26mr:device%3Dc%26mr:adType%3Dplaonline%26mr:ad%3D327012155409%26mr:keyword%3D%26mr:match%3D%26mr:tid%3D%26mr:ploc%3D2840%26mr:iloc%3D2840%26mr:store%3D%26mr:filter%3D644630460627%26cm_mmc%3DCSE-_-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%3Frefid%3DGX441953803630-W003457385%26device%3Dc%26ptid%3D938012033185%26network%3Dytv%26targetid%3D%26channel%3DGooglePLA%26ireid%3D36029272%26fdid%3D1817&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%3Flid%3D92700051622320706%26ds_s_kwgid%3D58700005670538335%26ds_s_inventory_feed_id%3D97700000002890301%26ds_a_cid%3D4726899%26ds_a_caid%3D340159119%26ds_a_agid%3D95676785438%26ds_a_fiid%3D%26ds_a_lid%3D%26%26ds_e_adid%3D418420145023%26ds_e_matchtype%3Dcontent%26ds_e_device%3Dc%26ds_e_network%3Dytv%26ds_e_product_group_id%3D321733762702%26ds_e_product_id%3D6344511%26ds_e_product_merchant_id%3D1311674%26ds_e_product_country%3DUS%26ds_e_product_language%3Den%26ds_e_product_channel%3Donline%26ds_e_product_store_id%3D%26ds_url_v%3D2%26ds_dest_url%3Dhttps://t.myvisualiq.net/click_pixel%3Fet%3Dc%26ago%3D212%26ao%3D546%26aca%3D71700000032867262%26si%3D-2%26ci%3D-2%26pi%3D-2%26ad%3D58700005670538335%26sv1%3D92700051622320706%26advt%3D-2%26chnl%3D-2%26vndr%3D1195%26sz%3D6583%26u%3D%7Bgclid%7D%26red%3Dhttps://www.bestbuy.com/site/avengers-endgame-includes-digital-copy-4k-ultra-hd-blu-ray-blu-ray-2019/6344511.p%3FskuId%3D6344511%26ref%3D212%26loc%3D1%26ref%3D212%26loc%3DBM01%26gclsrc%3Daw.ds%26&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%3Frefid%3DGX434330092280-W002046081%26device%3Dc%26ptid%3D822702404629%26network%3Dytv%26targetid%3D%26channel%3DGooglePLA%26ireid%3D32626185%26fdid%3D1817&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.

Results for: text ads

JSON Example

{
  ...
  "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.",
    },
    ...
  ],
  ...
}