GET request: search

Executes a search on youtube for video's

Request parameters:

Parameter	Required	Type	Description
q	Yes	string	What to search for
max_results	No	integer	Set maximum results

Success response (status 200)

Parameter	Type	Description
error	boolean, false	Whether or not an error occured
message	string	Will be null
results	array	An array with objects and properties: id, channel, title, full_link

Example response

{
    "error": false,
    "message": null,
    "results": [{
        "id": "_niUTAxvVHY",
        "channel": "TechGumbo",
        "title": "Top 10 Best TV Shows to Watch Now!",
        "full_link": "https://youtube.com/watch?v=_niUTAxvVHY"
    }, {
        "id": "nHN55BirRSE",
        "channel": "WatchMojo.com",
        "title": "Top 10 Best TV Shows of the Decade",
        "full_link": "https://youtube.com/watch?v=nHN55BirRSE"
    }, {
        "id": "OsnSHP9Wcvo",
        "channel": "TechGumbo",
        "title": "Top 10 Best Netflix Original Series to Watch Now! 2020",
        "full_link": "https://youtube.com/watch?v=OsnSHP9Wcvo"
    }, {
        "id": "tsR1EtAya-Q",
        "channel": "ABHI KA REVIEW",
        "title": "Top 10 Best TV/Web Series in World that are Emotions",
        "full_link": "https://youtube.com/watch?v=tsR1EtAya-Q"
    }, {
        "id": "N8YxPstuK_c",
        "channel": "ABHI KA REVIEW",
        "title": "Top 10 Best Indian Web Series(2020) in Hindi | With Unique Concept",
        "full_link": "https://youtube.com/watch?v=N8YxPstuK_c"
    }, {
        "id": "sjzFnEDbDo4",
        "channel": "TechGumbo",
        "title": "Top 10 Best Netflix Original Series to Watch Now! 2019",
        "full_link": "https://youtube.com/watch?v=sjzFnEDbDo4"
    }, {
        "id": "Jzq_c7iQbl4",
        "channel": "Moss",
        "title": "Top 10 Series you MUST Have Watched - 2019 Netflix TV Shows",
        "full_link": "https://youtube.com/watch?v=Jzq_c7iQbl4"
    }, {
        "id": "qvJXAAT-BU4",
        "channel": "TechGumbo",
        "title": "Top 20 Greatest Modern TV Shows of All Time!",
        "full_link": "https://youtube.com/watch?v=qvJXAAT-BU4"
    }, {
        "id": "bDbceVD6Pz0",
        "channel": "ASMR VIEWS",
        "title": "TOP 10 BEST TV SERIES OF ALL TIME",
        "full_link": "https://youtube.com/watch?v=bDbceVD6Pz0"
    }, {
        "id": "io_DrpierEc",
        "channel": "watchme",
        "title": "Top 10 teenage tv series(2020):best new teenage tv shows",
        "full_link": "https://youtube.com/watch?v=io_DrpierEc"
    }, {
        "id": "WM6TPcxOTqs",
        "channel": "TCT-TopChanelTube",
        "title": "!TOP 10 MEJORES SERIES DEL MUNDO! (MÁS EXITOSAS) (HASTA 2020) (DE TODOS LOS TIEMPOS)",
        "full_link": "https://youtube.com/watch?v=WM6TPcxOTqs"
    }, {
        "id": "t8TAKpbRvH8",
        "channel": "WatchMojo.com",
        "title": "Top 10 TV Shows of All Time",
        "full_link": "https://youtube.com/watch?v=t8TAKpbRvH8"
    }, {
        "id": "RbtX6hqbML0",
        "channel": "TechGumbo",
        "title": "Top 10 Best NEW TV SHOWS To Watch Now!",
        "full_link": "https://youtube.com/watch?v=RbtX6hqbML0"
    }, {
        "id": "_ef1y6ZqIXY",
        "channel": "WatchMojo.com",
        "title": "Top 10 Shows to Binge in 2020",
        "full_link": "https://youtube.com/watch?v=_ef1y6ZqIXY"
    }, {
        "id": "TY5W1dE_njM",
        "channel": "MsMojo",
        "title": "Top 10 Animated Disney Channel Series of the Last Decade",
        "full_link": "https://youtube.com/watch?v=TY5W1dE_njM"
    }]
}

Error response (status 400)

Parameter	Type	Description
error	boolean, true	Whether or not an error occured
message	string	A description of the error
OR
error_messages	object	An object with arrays according to which field has an validation error