Skip to content
Examples

Get Results

Retrieve scraped comments from YouTube Comments 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 comments collected by your YouTube Comments Scraper runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

runstringquery

Hash of a specific run (optional)

pageintegerquery

Page number (default: 1)

Result Fields

comment_idstring

Unique YouTube comment ID. Example: UgxZf7BbcN3mJlQkfvt4AaABAg

textstring

Full text content of the comment. Example: This video is amazing, learned so much!

authorstring

Display name of the comment author. Example: John Doe

author_channel_idstring

YouTube channel ID of the author. Example: UCxxxxxxxxxxxxxxxxxxxxxx

author_profile_urlstring

URL to the author's YouTube channel. Example: https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxxxx

author_avatarstring

URL to the author's profile picture. Example: https://yt3.ggpht.com/...

author_is_channel_ownerboolean

Whether the commenter is the video's channel owner. Example: false

author_is_verifiedboolean

Whether the author's channel is verified. Example: false

author_badgestring | null

Membership or sponsorship badge label, if any. Example: null

published_time_textstring

Human-readable relative publish time as shown on YouTube. Example: 2 years ago

published_atstring | null

ISO 8601 timestamp of when the comment was published, if available. Example: 2022-08-15T14:30:00Z

vote_countinteger

Number of likes on the comment. Example: 342

reply_countinteger

Number of replies to this top-level comment. Always 0 for replies. Example: 12

has_creator_heartboolean

Whether the video creator hearted this comment. Example: false

is_pinnedboolean

Whether this comment is pinned at the top. Example: false

typestring

Comment type: comment for top-level or reply for a reply. Example: comment

reply_to_comment_idstring | null

The comment_id of the parent comment this is a reply to. null for top-level comments. Example: null

video_idstring

YouTube video ID the comment belongs to. Example: dQw4w9WgXcQ

video_urlstring

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

video_titlestring

Title of the video. Example: Rick Astley - Never Gonna Give You Up (Official Music Video)

comments_countinteger

Total number of comments on the video. Example: 2400000

channel_namestring

Name of the channel that uploaded the video. Example: Rick Astley

channel_idstring

YouTube channel ID of the video uploader. Example: UCuAXFkgsw1L7xaCfnd5JJOw

Code Examples

curl "https://api.lobstr.io/v1/results?squid=YOUR_SQUID_HASH&page=1" \
  -H "Authorization: Token YOUR_API_KEY"

Response

200
{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "comment_id": "UgxZf7BbcN3mJlQkfvt4AaABAg",
      "text": "This song never gets old.",
      "author": "Jane Smith",
      "author_channel_id": "UCxxxxxxxxxxxxxxxxxxxxxx",
      "author_profile_url": "https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxxxx",
      "author_avatar": "https://yt3.ggpht.com/example",
      "author_is_channel_owner": false,
      "author_is_verified": false,
      "author_badge": null,
      "published_time_text": "3 years ago",
      "published_at": "2021-06-10T09:15:00Z",
      "vote_count": 1204,
      "reply_count": 45,
      "has_creator_heart": false,
      "is_pinned": false,
      "type": "comment",
      "reply_to_comment_id": null,
      "video_id": "dQw4w9WgXcQ",
      "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "video_title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
      "comments_count": 2400000,
      "channel_name": "Rick Astley",
      "channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw"
    },
    {
      "comment_id": "UgxZf7BbcN3mJlQkfvt4AaABAg.9k2mLpQvX3z",
      "text": "Agreed, timeless classic.",
      "author": "John Doe",
      "author_channel_id": "UCyyyyyyyyyyyyyyyyyyyyyy",
      "author_profile_url": "https://www.youtube.com/channel/UCyyyyyyyyyyyyyyyyyyyyyy",
      "author_avatar": "https://yt3.ggpht.com/example2",
      "author_is_channel_owner": false,
      "author_is_verified": false,
      "author_badge": null,
      "published_time_text": "3 years ago",
      "published_at": "2021-06-11T10:02:00Z",
      "vote_count": 8,
      "reply_count": 0,
      "has_creator_heart": false,
      "is_pinned": false,
      "type": "reply",
      "reply_to_comment_id": "UgxZf7BbcN3mJlQkfvt4AaABAg",
      "video_id": "dQw4w9WgXcQ",
      "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "video_title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
      "comments_count": 2400000,
      "channel_name": "Rick Astley",
      "channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw"
    }
  ]
}