> ## Documentation Index > Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt > Use this file to discover all available pages before exploring further. # Get Results > Retrieve scraped data from YouTube Search Scraper Retrieve scraped data from your **YouTube Search Scraper** runs. ## Headers Your API authentication token. Value: `Token YOUR_API_KEY`. ## Query Parameters Hash of the squid to get results from. Page number (default: 1). ## Result Fields ### Export Results What this row represents: 'video', 'channel', 'short', 'stream', or 'playlist'. Example: `video` YouTube's own identifier for this video, channel, or playlist -- unique on its own since video/channel/playlist id formats never collide. Example: `dQw4w9WgXcQ` Video title, or channel display name for a channel row. Example: `Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)` Direct URL to the video or channel. Example: `https://www.youtube.com/watch?v=dQw4w9WgXcQ` Video thumbnail, or channel avatar for a channel row. Example: `https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg` Full video description, or full channel About text for a channel row. Example: `The official video for “Never Gonna Give You Up” by Rick Astley.` Hashtags 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"]` Exact 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` Approximate, relative publish time as shown on a search-listing row. Only populated for search-listing video rows. Example: `14 years ago` Exact video duration in seconds. Only populated when the video itself was fetched directly. Example: `213` Video duration as shown on a search-listing row (e.g. "3:32"). Only populated for search-listing video rows. Example: `3:32` Exact 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 as shown on a search-listing row. Only populated for search-listing video rows. Example: `48,467,121 views` Exact 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` Approximate comment count text. YouTube exposes no exact comment count anywhere. Only populated when the video itself was fetched directly. Example: `2.4M` Channel identifier -- the video's channel, or the channel itself for a channel row. Example: `UCuAXFkgsw1L7xaCfnd5JJOw` Channel display name. Example: `Rick Astley` Direct URL to the channel. Example: `https://www.youtube.com/@RickAstleyYT` Channel 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` Whether the channel has YouTube's verified (or Official Artist Channel) badge. Example: `True` Approximate subscriber count text -- YouTube exposes no exact subscriber count anywhere. Example: `4.53M subscribers` Channel banner image. Only populated for a channel row. Example: `https://yt3.googleusercontent.com/example=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj` Channel handle. Only populated for a channel row. Example: `@MrBeast` Approximate total video count text. Only populated for a channel row. Example: `997 videos` Channel's claimed country, from its About tab. Only populated for a channel row. Example: `United States` Date the channel joined YouTube, from its About tab. Only populated for a channel row. Example: `2012-02-20` External/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"]` Whether the video is currently a live broadcast. Example: `False` Whether the video is an upcoming/scheduled premiere. Only populated when the video itself was fetched directly. Example: `False` Live broadcast start time, if is\_live is true. Only populated when the video itself was fetched directly. Whether the video has any captions/subtitles (auto-generated or user-added). Only populated when the video itself was fetched directly. Example: `True` Language codes of the video's available caption tracks. Only populated when the video itself was fetched directly. Example: `["en", "de-DE"]` Video category. Only populated when the video itself was fetched directly. Example: `Music` Whether the video or channel is flagged family-safe by YouTube. Example: `True` Whether the video is unlisted. Only populated when the video itself was fetched directly. Example: `False` The task's original input string (URL or search text) that produced this row. Example: `rick astley` 1-based position of this row within its task's results (always 1 for a video/channel URL task). Example: `1` ### Get Comments First 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 Language code of the caption track subtitles\_text was fetched from. Only populated when Get Subtitles is enabled. Example: `en` Transcript 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 ```bash cURL theme={null} curl -G https://api.lobstr.io/v1/results \ -H "Authorization: Token YOUR_API_KEY" \ -d "squid=YOUR_SQUID_HASH" \ -d "page=1" ``` ```python Python theme={null} import requests response = requests.get( "https://api.lobstr.io/v1/results", headers={"Authorization": "Token YOUR_API_KEY"}, params={"squid": "YOUR_SQUID_HASH", "page": 1}, ) print(response.json()) ``` ## Response ```json 200 theme={null} {"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}]} ```