YouTube Search API

Api Details

Endpoint GET https://serpapi.abcproxy.com/search

Description Retrieve comprehensive user profile including basic info, account status and optional permission sets.

---

Source	Description
youtube_search	Up to 20 search results for a search term of your choice.
youtube_search_max	Up to 700 search results for a search term of your choice.

Request

HTTP Request

cURL

curl -X GET "https://serpapi.abcproxy.com/search" \
  -d "engine=youtube" \
  -d "q=coffee" \
  -d "no_cache=false" \
  -d "api_key=YOUR_API_KEY"

Python

import requests

params = {
    "engine": "youtube",
    "q": "coffee",
    "no_cache": "false",
    "api_key": "YOUR_API_KEY"
}
response = requests.get("https://serpapi.abcproxy.com/search", params=params)
print(response.json())

Node.js

const axios = require('axios');

const params = {
  engine: "youtube",
  q: "coffee",
  no_cache: "false",
  api_key: "YOUR_API_KEY"
};

axios.get("https://serpapi.abcproxy.com/search", { params })
  .then(response => console.log(response.data));

HTTP

GET /search?engine=youtube&q=abc&no_cache=false&api_key=YOUR_API_KEY HTTP/1.1
Host: serpapi.abcproxy.com

PHP

<?php
$client = new \GuzzleHttp\Client();
$response = $client->get('https://serpapi.abcproxy.com/search', [
    'query' => [
        'engine' => 'youtube',
        'q' => 'coffee',
        'no_cache' => 'false',
        'api_key' => 'YOUR_API_KEY'
    ]
]);
echo $response->getBody();

Golang

package main

import (
    "net/http"
    "io/ioutil"
    "log"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://serpapi.abcproxy.com/search", nil)
    
    q := req.URL.Query()
    q.Add("engine", "youtube")
    q.Add("q", "coffee")
    q.Add("no_cache", "false")
    q.Add("api_key", "YOUR_API_KEY")
    req.URL.RawQuery = q.Encode()

    resp, _ := client.Do(req)
    body, _ := ioutil.ReadAll(resp.Body)
    log.Println(string(body))
}

C#

using System;
using System.Net.Http;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        var query = System.Web.HttpUtility.ParseQueryString(string.Empty);
        query["engine"] = "youtube";
        query["q"] = "coffee";
        query["no_cache"] = "false";
        query["api_key"] = "YOUR_API_KEY";
        
        var response = await client.GetAsync(
            $"https://serpapi.abcproxy.com/search?{query}"
        );
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

Java

import java.net.*;
import java.io.*;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://serpapi.abcproxy.com/search" +
            "?engine=youtube" +
            "&q=coffee" +
            "&no_cache=false" +
            "&api_key=YOUR_API_KEY";
        
        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("GET");
        
        BufferedReader in = new BufferedReader(
            new InputStreamReader(conn.getInputStream())
        );
        String response = in.lines().collect(Collectors.joining());
        System.out.println(response);
    }
}

---

API Parameters

Search Query

Name	Type	Required	Description	Example
search_query	string	Yes	Parameter defines the search query. You can use anything that you would use in a regular YouTube search.	coffee

Localization

Name	Type	Required	Description	Example
gl	string	No	Parameter defines the country to use for the Google search. It's a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France) Head to the Google countries page for a full list of supported Google countries.	us
hl	string	No	Parameter defines the language to use for the Youtube search. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French). Head to the Google languages page for a full list of supported Google languages.	en

Filters Parameters

Name	Type	Required	Description	Example
upload_date	string	No	Filters videos by when they were uploaded. Available values are: today, last_hour, this_week, this_month, this_year.	today
type	string	No	Returns results by content type. Available values are: video, channel, playlist, movie.	video
duration	string	No	Content duration in minutes. Available values are	>4
sort_by	string	No	Determines how search results are ordered. Available values are rating, relevance, view_count,upload_date.	relevance
is360	boolean	No	Returns 360-degree videos in search results.	false
is3d	boolean	No	Returns 3D videos in search results.	false
is4k	boolean	No	Returns 4K resolution videos in search results.	false
creative_commons	boolean	No	Returns only videos with Creative Commons licenses.	false
hd	boolean	No	Returns high-definition videos in search results.	false
hdr	boolean	No	Returns HDR (High Dynamic Range) videos in search results.	false
live	boolean	No	Returns live streams in search results.	false
area	boolean	No	Returns videos with location information.	false
purchased	boolean	No	Returns purchased content in search results.	false
subtitles	boolean	No	Returns videos with subtitles or closed captions.	false
vr180	boolean	No	Returns VR180 format videos in search results.	false

Advanced Google Play Parameters

Name	Type	Required	Description	Example
sp	string	No	Parameter can be used for pagination. Youtube uses continous pagination and the next page token can be found in the SerpApi JSON responseserpapi_pagination -> next_page_token and pagination -> next_page_token fields. Parameter can also be used to filter the search results: by Upload date, you need to set the sp parameter to CAI%3D by 4K, you need to set the sp parameter to EgJwAQ%3D%3D ... It can also be used for forcing the exact search query spelling by setting the sp value to QgIIAQ%3D%3D. If you are interested in passing other filters, you can visit the YouTube website, set filters you want and simply copy sp value from their URL to SerpApi URL.	-

Serpapi Parameters

Name	Type	Required	Description	Example
engine	string	Yes	Set parameter to youtube to use the YouTube API engine.	google_play
no_cache	boolean	No	Parameter will force SerpApi to fetch the YouTube results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache.	trueorfalse
api_key	string	Yes	Parameter defines the SerpApi private key to use.	-

---

Response

Success 200

Response Body

{
  "search_metadata": {
    "id": "b940f394-34b5-4aaa-9c91-aa1d7bfd3c7a",
    "json_endpoint": "https://webserp.abcproxy.com/files/1a80eeed8d480492/b940f394-34b5-4aaa-9c91-aa1d7bfd3c7a.json",
    "created_at": "2025-04-14 17:19:11",
    "youtube_url": "https://www.youtube.com/results?search_query=Coffee",
    "raw_html_file": "https://webserp.abcproxy.com/files/1a80eeed8d480492/b940f394-34b5-4aaa-9c91-aa1d7bfd3c7a.html",
    "xray_html_file": "https://webserp.abcproxy.com/files/1a80eeed8d480492/b940f394-34b5-4aaa-9c91-aa1d7bfd3c7a.xray",
    "total_time_taken": "8.3667"
  },
  "search_parameters": {
    "engine": "youtube",
    "no_cache": true,
    "api_key": "YOUR_API_KEY",
    "fetch_mode": "dynamic",
    "search_query": "Coffee"
  },
  "latest_from_results": [
    {
      "published_date": "12daysago",
      "views": 369000,
      "length": "5:02",
      "description": "Patreon:https://www.patreon.com/jameshoffmannLimitedEditionMerch:https://geni.us/TensHundredsThousandsInstagram:https...",
      "extensions": [
        "4KSubtitles"
      ],
      "title": "The Secrets Of My Daily Coffee Routine",
      "link": "https://www.youtube.com/watch?v=epIgulaBryA&pp=ygUGQ29mZmVl",
      "channel": {
        "name": "JamesHoffmann",
        "link": "https://www.youtube.com/@JamesHoffmann",
        "verified": true
      }
    },
    {
      "channel": {
        "name": "a!ka",
        "link": "https://www.youtube.com/@a!ka"
      },
      "published_date": "1.8Mviews",
      "length": "3:05",
      "description": "ProvidedtoYouTubebyDistroKidCoffee·a!kaCoffee℗a!kaReleasedon:2024-10-25Auto-generatedbyYouTube.",
      "title": "Coffee",
      "link": "https://www.youtube.com/watch?v=D9B_RkMQVGY&pp=ygUGQ29mZmVl"
    },
    "..."
  ],
  "video_results": [
    {
      "description": "Herearethelinkstothetopbestcoffeebeansof2025featuredinourreviewvideotoday:DiscoverthePerfectCoffeeBeansfor ...",
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/5TKAWkWlgck/hq720.jpg?sqp=-oaymwEnCNAFEJQDSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLCMZteq_TOtaLGl6TcUt0Sj1AtWYg"
      },
      "title": "Top 10 Best Coffee Beans of 2025 || A Coffee Lover’s Dream!",
      "link": "https://www.youtube.com/watch?v=5TKAWkWlgck&pp=ygUGQ29mZmVl",
      "channel": {
        "name": "TheCoffeeDelight",
        "link": "https://www.youtube.com/watch?v=5TKAWkWlgck&t=429s",
        "thumbnail": "https://yt3.ggpht.com/3E6BUW6nfDoDirR5ZQXgtEz2rIgRZEIGlM0KDmhHeJmCpDrhnYgwcuVe-tW6GyZ9dkU6lkr1vQ=s68-c-k-c0x00ffffff-no-rj"
      },
      "published_date": "9monthsago",
      "views": 54000,
      "length": "7:43"
    },
    {
      "title": "Rainy Jazz Cafe - Slow Jazz Music in Coffee Shop Ambience for Work, Study and Relaxation",
      "link": "https://www.youtube.com/watch?v=NJuSStkIZBg&pp=ygUGQ29mZmVl",
      "channel": {
        "name": "CoffeeShopVibes",
        "link": "https://www.youtube.com/@CoffeeShopVibes",
        "verified": true
      },
      "published_date": "2yearsago",
      "views": 41000000,
      "length": "3:34:00",
      "description": "Welcometothiscityrainycafeambiencewithcozyjazzmusicforwork,studyingandrelaxation.ThisisaASMRCoffeeshop ..."
    },
    "..."
  ],
  "shorts_results": [
    {
      "shorts": [
        {
          "title": "Differentwaystomakewhippedcoffee",
          "link": "https://www.youtube.com/shorts/nAJ_eXIwwgk",
          "thumbnail": "https://i.ytimg.com/vi/nAJ_eXIwwgk/oardefault.jpg?sqp=-oaymwEoCJUDENAFSFqQAgHyq4qpAxcIARUAAIhC2AEB4gEKCBgQAhgGOAFAAQ==&rs=AOn4CLA8nTHzJuQb2R_99nqt0HIpErvliQ",
          "views_original": "6.9Mviews",
          "video_id": "nAJ_eXIwwgk"
        },
        {
          "link": "https://www.youtube.com/shorts/wxFI24dkCSQ",
          "views_original": "9.2Mviews",
          "video_id": "wxFI24dkCSQ",
          "title": "ShouldYouDrinkCoffeeforStudying?"
        }
        "..."
      ]
    }
  ]
}
          

Response Fields

Field	Type	Description
search_metadata	object	Contains timing and status information
search_parameters	object	Contains query parameters and search context
organic_results	object[]	OrganicResults
latest_from_results	object	LatestfromRes
video_results	object	VideoResults
shorts_results	object	ShortsResults

---

Error Responses

Common Errors

HTTP Status	Error Code	Description
200	400	API Key can not be empty
200	401	Param error
200	402	Api key error
200	403	Insufficient Balance
200	404	Deduction failed
200	405	Failed to record usage count
200	406	Unsupported engine
200	407	Network error
200	408	File not found
200	409	Limit param error
200	410	Build url error
200	411	Failed to QueryRecentRecord
200	412	Failed to find json
200	413	Get html error
200	414	HTML is empty
200	429	Too many request

Error Example

{
  "code": 400,
  "message": "API Key can not be empty"
}

---