Social Fetch
YouTube

List YouTube channel videos

Get videos published by a specific YouTube channel.

Use `data.lookupStatus` to distinguish a resolved empty result from `not_found`.

An empty `data.videos` array can still mean `data.lookupStatus: "found"` when the channel resolves but the returned page has no videos.

GET/v1/youtube/channels/videos
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
5
channelIdstringquery

Optional YouTube channel id for the request.

min 1 chars · max 4096 chars

handlestringquery

Optional YouTube channel handle for the request.

sortBystringquery

Optional sort order for the returned YouTube videos.

one of: latest, popular

cursorstringquery

Opaque pagination cursor returned by a previous response.

min 1 chars

includeExtrasbooleanquery

Optional flag to include richer per-video metadata when available.

Response fields
31

Endpoint-specific response payload.

datalookupStatus
string

Whether the channel was resolved for this request.

one of: found, not_found

YouTube videos returned for the resolved channel. This array may be empty when the channel resolves but there are no videos in the returned page.

datavideos[]id
string

YouTube video identifier.

min 1 chars

datavideos[]url
stringnullable

Canonical public YouTube URL for the video.

datavideos[]title
stringnullable

Title shown for the YouTube video.

datavideos[]thumbnailUrl
stringnullable

Best available thumbnail image URL for the video.

datavideos[]viewCount
integernullable

View count for the video when available.

≥ 0

datavideos[]viewCountText
stringnullable

Human-readable view count label when available.

datavideos[]publishedAt
stringnullable

ISO-8601 timestamp for when the video was published, when available.

datavideos[]publishedTimeText
stringnullable

Human-readable relative publish time text when available.

datavideos[]durationSeconds
integernullable

Duration of the video in seconds when available.

≥ 0

datavideos[]durationText
stringnullable

Human-readable duration label for the video when available.

datavideos[]channelTitle
stringnullable

Channel title shown alongside the video when available.

datavideos[]channelThumbnailUrl
stringnullable

Channel thumbnail image URL shown alongside the video when available.

datavideos[]description
stringnullableoptional

Video description text when available.

datavideos[]commentCount
integernullableoptional

Comment count for the video when available.

≥ 0

datavideos[]commentCountText
stringnullableoptional

Human-readable comment count label when available.

datavideos[]likeCount
integernullableoptional

Like count for the video when available.

≥ 0

datavideos[]likeCountText
stringnullableoptional

Human-readable like count label when available.

datavideos[]publishDate
stringnullableoptional

Publish date text when available.

datavideos[]genre
stringnullableoptional

Video category or genre label when available.

datavideos[]durationMs
integernullableoptional

Duration of the video in milliseconds when available.

≥ 0

datavideos[]durationFormatted
stringnullableoptional

Alternative formatted duration label when available.

Pagination information for the current response.

datapagenextCursor
stringnullable

Cursor to pass in the next request when another page exists.

datapagehasMore
boolean

Whether another page of videos is available.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/youtube/channels/videos?handle=charlidamelio" \
  -H "x-api-key: YOUR_API_KEY"

Responses

YouTube videos for the requested channel. Check `data.lookupStatus` for `found` vs `not_found`.

On this page

No Headings