Get Results
Retrieve scraped data from YouTube Search Scraper
https://api.lobstr.io/v1/resultsRetrieve scraped data from your YouTube Search Scraper runs.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY.
Query Parameters
squidstringqueryrequiredHash of the squid to get results from.
pageintegerqueryPage number (default: 1).
Result Fields
Export Results
result_typestringWhat this row represents: 'video', 'channel', 'short', 'stream', or 'playlist'. Example: video
content_idstringYouTube's own identifier for this video, channel, or playlist -- unique on its own since video/channel/playlist id formats never collide. Example: dQw4w9WgXcQ
titlestringVideo title, or channel display name for a channel row. Example: Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)
urlstringDirect URL to the video or channel. Example: https://www.youtube.com/watch?v=dQw4w9WgXcQ
thumbnail_urlstringVideo thumbnail, or channel avatar for a channel row. Example: https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg
descriptiontextFull video description, or full channel About text for a channel row. Example: The official video for “Never Gonna Give You Up” by Rick Astley.
hashtagsjsonHashtags found on the video. Empty for a channel row or a search-listing video row (only populated when the video itself was fetched directly). Example: ["#RickAstley", "#NeverGonnaGiveYouUp"]
published_atdatetimeExact publish date. Only populated when the video itself was fetched directly -- a search-listing row only has published_time_text (see below). Example: 2009-10-24T23:57:33-07:00
published_time_textstringApproximate, relative publish time as shown on a search-listing row. Only populated for search-listing video rows. Example: 14 years ago
duration_secondsintegerExact video duration in seconds. Only populated when the video itself was fetched directly. Example: 213
duration_textstringVideo duration as shown on a search-listing row (e.g. "3:32"). Only populated for search-listing video rows. Example: 3:32
view_countbigintExact view count when the video was fetched directly; parsed from listing text otherwise. bigint -- some videos already exceed the ~2.147B int32 range. Example: 1805080053
view_count_textstringView count as shown on a search-listing row. Only populated for search-listing video rows. Example: 48,467,121 views
like_countbigintExact like count. Only populated when the video itself was fetched directly -- not available on a search-listing row at all. bigint -- some videos already exceed the ~2.147B int32 range. Example: 19337903
comment_count_textstringApproximate comment count text. YouTube exposes no exact comment count anywhere. Only populated when the video itself was fetched directly. Example: 2.4M
channel_idstringChannel identifier -- the video's channel, or the channel itself for a channel row. Example: UCuAXFkgsw1L7xaCfnd5JJOw
channel_namestringChannel display name. Example: Rick Astley
channel_urlstringDirect URL to the channel. Example: https://www.youtube.com/@RickAstleyYT
channel_avatar_urlstringChannel avatar. On a video row this is the small avatar shown next to the video; on a channel row it's the same as thumbnail_url. Example: https://yt3.ggpht.com/example=s88-c-k-c0x00ffffff-no-rj
channel_verifiedbooleanWhether the channel has YouTube's verified (or Official Artist Channel) badge. Example: True
channel_subscriber_count_textstringApproximate subscriber count text -- YouTube exposes no exact subscriber count anywhere. Example: 4.53M subscribers
channel_banner_urlstringChannel banner image. Only populated for a channel row. Example: https://yt3.googleusercontent.com/example=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj
channel_handlestringChannel handle. Only populated for a channel row. Example: @MrBeast
channel_video_count_textstringApproximate total video count text. Only populated for a channel row. Example: 997 videos
channel_countrystringChannel's claimed country, from its About tab. Only populated for a channel row. Example: United States
channel_join_datedatetimeDate the channel joined YouTube, from its About tab. Only populated for a channel row. Example: 2012-02-20
channel_external_linksjsonExternal/social links listed on the channel's About tab. Only populated for a channel row. Example: ["https://www.instagram.com/mrbeast/", "https://x.com/MrBeast"]
is_livebooleanWhether the video is currently a live broadcast. Example: False
is_upcomingbooleanWhether the video is an upcoming/scheduled premiere. Only populated when the video itself was fetched directly. Example: False
live_start_timedatetimeLive broadcast start time, if is_live is true. Only populated when the video itself was fetched directly.
captions_availablebooleanWhether the video has any captions/subtitles (auto-generated or user-added). Only populated when the video itself was fetched directly. Example: True
caption_languagesjsonLanguage codes of the video's available caption tracks. Only populated when the video itself was fetched directly. Example: ["en", "de-DE"]
categorystringVideo category. Only populated when the video itself was fetched directly. Example: Music
is_family_safebooleanWhether the video or channel is flagged family-safe by YouTube. Example: True
is_unlistedbooleanWhether the video is unlisted. Only populated when the video itself was fetched directly. Example: False
source_inputstringThe task's original input string (URL or search text) that produced this row. Example: rick astley
positioninteger1-based position of this row within its task's results (always 1 for a video/channel URL task). Example: 1
Get Comments
top_commentsjsonFirst page of top-level comments (up to 10). Only populated when Get Comments is enabled. Example: [{"comment_id": "UgzABC123", "author": "@SomeUser", "author_channel_id": "UCabc123", "text": "This is amazing!", "published_time_text": "2 days ago", "vote_count": 214}]
Get Subtitles
subtitles_languagestringLanguage code of the caption track subtitles_text was fetched from. Only populated when Get Subtitles is enabled. Example: en
subtitles_textstringTranscript text of one caption track (see subtitles_language). Only populated when Get Subtitles is enabled, and empty if the video has no captions. Example: [Music playing] Welcome back to the channel...
Code Examples
curl -G https://api.lobstr.io/v1/results \ -H "Authorization: Token YOUR_API_KEY" \ -d "squid=YOUR_SQUID_HASH" \ -d "page=1"
Response
{"total_results": 1, "data": [{"result_type": "video", "content_id": "dQw4w9WgXcQ", "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)", "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg", "description": "The official video for \u201cNever Gonna Give You Up\u201d by Rick Astley.", "hashtags": ["#RickAstley", "#NeverGonnaGiveYouUp"], "published_at": "2009-10-24T23:57:33-07:00", "published_time_text": "14 years ago", "duration_seconds": 213}]}