Skip to content
Examples

Get Results

Retrieve scraped data from YouTube Transcript Scraper

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your YouTube Transcript Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

pageintegerquery

Page number (default: 1)

Result Fields

video_idstring

YouTube video identifier. Example: dQw4w9WgXcQ

urlstring

Canonical URL of the video. Example: https://www.youtube.com/watch?v=dQw4w9WgXcQ

titlestring

Video title. Example: Rick Astley - Never Gonna Give You Up

descriptiontext

Full video description.

keywordsjson

Keywords (tags) set by the creator.

duration_secondsinteger

Video length in seconds. Example: 212

view_countbigint

View count at collection time. Example: 1400000000

like_countbigint

Like count (null when likes are hidden). Example: 15000000

comment_count_textstring

Approximate comment count as displayed by YouTube. Example: 2.1M

published_atdatetime

Publish date and time (UTC). Example: 2009-10-25T06:57:33Z

published_time_textstring

Relative publish time as displayed by YouTube. Example: 16 years ago

categorystring

YouTube category. Example: Music

is_unlistedboolean

Whether the video is unlisted.

is_family_safeboolean

Whether YouTube flags the video as family safe.

is_live_contentboolean

Whether the video is or was a live broadcast.

thumbnail_urlstring

Highest resolution thumbnail URL.

channel_idstring

YouTube channel identifier. Example: UCuAXFkgsw1L7xaCfnd5JJOw

channel_namestring

Channel name. Example: Rick Astley

channel_urlstring

Channel URL. Example: https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw

channel_handlestring

Channel handle. Example: @RickAstleyYT

channel_avatar_urlstring

Channel avatar image URL.

channel_subscriber_count_textstring

Subscriber count as displayed by YouTube. Example: 3.8M subscribers

requested_languagestring

Language setting used for this row. Example: en

languagestring

Language code of the primary transcript. Example: en

language_namestring

Display name of the primary transcript track. Example: English

is_auto_generatedboolean

Whether the primary transcript is auto-generated.

segmentsjson

Primary transcript as timestamped segments (start, duration, text).

full_texttext

Primary transcript as plain text. Example: We're no strangers to love...

word_countinteger

Number of words in full_text. Example: 312

tracksjson

Every downloaded caption track.

tracks_countinteger

Number of downloaded tracks. Example: 3

available_languagesjson

Every caption track the video offers.

statusstring

'ok' when at least one track was downloaded, 'no_captions' when none available. Example: ok

transcript_foundboolean

Whether a transcript was downloaded.

Response

200
{"total_results": 1, "data": [{"video_id": "dQw4w9WgXcQ", "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "title": "Rick Astley - Never Gonna Give You Up", "language": "en", "full_text": "We're no strangers to love...", "word_count": 312, "tracks_count": 3, "status": "ok"}]}