Skip to content
Gridlode
LiveSocial media and video1 credit / page

YouTube Search API

YouTube search results exactly as a signed-out visitor sees them: videos (title, link, channel, published date, views, duration, thumbnail, description snippet, badges), Shorts, channels and playlists or courses, with filters for result type, upload date, duration and sort order. Fetches as many result pages as your limit needs and hands back a next_page_token to continue later. Billed per results page fetched (up to about 20 results each; pages heavy with Shorts shelves hold fewer, and type=video gives the densest pages); verification pages, blocks and failures are free.

GEThttps://api.gridlode.com/v1/youtube/search
Get an API keyReference docs

Try it live

Try . Free, no account needed.

Parameters

NameTypeDescription
qrequiredstringSearch query, as typed into YouTube's search box.
typestringOnly return this kind of result (YouTube's own type filter).
Default: "all"
One of: all, video, short, channel, playlist
sortstringResult order.
Default: "relevance"
One of: relevance, popularity
upload_datestringOnly videos uploaded within this period.
Default: "any"
One of: any, today, week, month, year
durationstringOnly videos of this length.
Default: "any"
One of: any, under_3_min, 3_to_20_min, over_20_min
limitintegerMaximum results of the requested type (videos, channels and playlists for type=all; Shorts shelves come along, capped at the same number). Each results page fetched holds up to about 20 and costs 1 credit.
Default: 20
hlstringInterface language, e.g. en, de, pt-BR.
Default: "en"
glstringTwo-letter country code whose results to show.
Default: "us"
page_tokenstringnext_page_token from a previous response, to continue the same search where it stopped.
Default: null
max_ageintegerAccept a cached answer up to this many seconds old, billed at 50%. Default 0 (always fresh).

Response fields

    Code

    curl "https://api.gridlode.com/v1/youtube/search?q=python%20tutorial&limit=10" \
  -H "Authorization: Bearer $GRIDLODE_KEY"
    1 credit per page
    One credit is $0.001 on the smallest pack, from $0.0003 on enterprise plans.
    Half price for cached data
    Cached for up to 1 h. Pass max_age to use it.
    Failed requests are free
    Blocks, timeouts and target errors never cost credits.

    Market reference: SearchAPI YouTube $4.00 → $1.00 per 1k; Outscraper YouTube search $5 → $3 per 1k.

    Questions

    Part of these solutions
    How much does the YouTube Search API cost?

    1 credit per page. One credit costs $0.001 on the smallest pack and as little as $0.0003 on enterprise plans. Cached answers cost half and failed calls are free.

    Social media and video

    Related APIs in this category

    All 13 in Social media and video · 7 live
    Live

    YouTube Video Details

    Public metadata of one YouTube video from its watch page, as a signed-out visitor sees it

    1 credit / requestDocs
    Live

    TikTok Profile

    A public TikTok creator or brand profile exactly as a signed-out visitor sees it

    2 credits / requestTry freeDocs
    Live

    YouTube Comments

    Public comments on one YouTube video, in YouTube's Top or Newest order, exactly as a signed-out visitor can load them

    0.05 credits / commentDocs
    Soon

    Meta Ad Library

    Search Meta's public Ad Library (Facebook, Instagram, Messenger, Audience Network) by keyword or advertiser Page id for any country

    2 credits / pageDocs
    Soon

    Facebook Page

    A public Facebook Page (brand, business or organisation) as a logged-out visitor sees it

    2 credits / requestDocs