youtube

Video › Comments

Returns comments on a video, each with the author name, comment text, like count, reply count, and publish timestamp.

Use it for a video's top-level comments, then pass a comment's id as continuationToken to video/comment/replies to open a single thread.

10 credits per call.

Paginates by cursor: see Pagination.

get/v1/youtube/video/comments

Request

Base URL: https://api.insightsocial.app
URL: https://api.insightsocial.app/v1/youtube/video/comments
Auth: API key in header x-api-key

Query parameters

urlstring required

Example:https://www.youtube.com/watch?v=dQw4w9WgXcQ

Full URL of the YouTube video to fetch comments for

order'top' | 'newest'

Order of comments: 'top' (default, YouTube's relevance ranking) or 'newest' (exact newest-first on comment.published_at; each next page continues strictly older with no overlap: the lane for date-window and recency pulls).

searchTermstring

Filter comments to those containing this search term.

format'html' | 'plainText'

Text format for comment bodies: 'html' (default) or 'plainText'.

max_resultsinteger

Comments per page, 1-100. The default page is already 100, so set this only to shrink a page; out-of-range values are rejected with a free 400 rather than degrading the response.

channel_idstring

YouTube channel id to fetch channel-level community comments for (instead of a video's comments).

dry_run'1'

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

sincestring

Only rows published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Rows older than it are left off the page, and the page that reaches one ends the walk: next_cursor is not returned and pagination.stopped_at is since. Sending it sets the newest-first sort shown in this endpoint's sort parameter (any other sort value is a free 400). The page still costs what a page costs, so you pay for the pages you walk and no more. A row with no date is kept.

untilstring

Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept.

cursorstring

The pagination.next_cursor from the previous page, sent back unchanged. Omit it for the first page.

Response

Success.

successtrue required

platformstring required

endpointstring required

schema_version'2' required

unavailablestring[] required

credits_usedinteger required

credits_remaininginteger required

request_idstring required

cachedboolean required

idempotent_replayboolean required

charge_reasonstring required

free_callboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.