Skip to main content
GET
Get Results
Retrieve scraped data from your YouTube Search Scraper runs.

Headers

string
required
Your API authentication token. Value: Token YOUR_API_KEY.

Query Parameters

string
required
Hash of the squid to get results from.
integer
Page number (default: 1).

Result Fields

Export Results

string
What this row represents: ‘video’, ‘channel’, ‘short’, ‘stream’, or ‘playlist’. Example: video
string
YouTube’s own identifier for this video, channel, or playlist — unique on its own since video/channel/playlist id formats never collide. Example: dQw4w9WgXcQ
string
Video title, or channel display name for a channel row. Example: Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)
string
Direct URL to the video or channel. Example: https://www.youtube.com/watch?v=dQw4w9WgXcQ
string
Video thumbnail, or channel avatar for a channel row. Example: https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg
text
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.
json
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"]
datetime
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
string
Approximate, relative publish time as shown on a search-listing row. Only populated for search-listing video rows. Example: 14 years ago
integer
Exact video duration in seconds. Only populated when the video itself was fetched directly. Example: 213
string
Video duration as shown on a search-listing row (e.g. “3:32”). Only populated for search-listing video rows. Example: 3:32
bigint
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
string
View count as shown on a search-listing row. Only populated for search-listing video rows. Example: 48,467,121 views
bigint
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
string
Approximate comment count text. YouTube exposes no exact comment count anywhere. Only populated when the video itself was fetched directly. Example: 2.4M
string
Channel identifier — the video’s channel, or the channel itself for a channel row. Example: UCuAXFkgsw1L7xaCfnd5JJOw
string
Channel display name. Example: Rick Astley
string
Direct URL to the channel. Example: https://www.youtube.com/@RickAstleyYT
string
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
boolean
Whether the channel has YouTube’s verified (or Official Artist Channel) badge. Example: True
string
Approximate subscriber count text — YouTube exposes no exact subscriber count anywhere. Example: 4.53M subscribers
string
Channel banner image. Only populated for a channel row. Example: https://yt3.googleusercontent.com/example=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj
string
Channel handle. Only populated for a channel row. Example: @MrBeast
string
Approximate total video count text. Only populated for a channel row. Example: 997 videos
string
Channel’s claimed country, from its About tab. Only populated for a channel row. Example: United States
datetime
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"]
boolean
Whether the video is currently a live broadcast. Example: False
boolean
Whether the video is an upcoming/scheduled premiere. Only populated when the video itself was fetched directly. Example: False
datetime
Live broadcast start time, if is_live is true. Only populated when the video itself was fetched directly.
boolean
Whether the video has any captions/subtitles (auto-generated or user-added). Only populated when the video itself was fetched directly. Example: True
json
Language codes of the video’s available caption tracks. Only populated when the video itself was fetched directly. Example: ["en", "de-DE"]
string
Video category. Only populated when the video itself was fetched directly. Example: Music
boolean
Whether the video or channel is flagged family-safe by YouTube. Example: True
boolean
Whether the video is unlisted. Only populated when the video itself was fetched directly. Example: False
string
The task’s original input string (URL or search text) that produced this row. Example: rick astley
integer
1-based position of this row within its task’s results (always 1 for a video/channel URL task). Example: 1

Get Comments

json
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

string
Language code of the caption track subtitles_text was fetched from. Only populated when Get Subtitles is enabled. Example: en
string
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

Response

200