Social Fetch
YouTube

Get YouTube community post

Get the contents of a YouTube community post.

Use `data.lookupStatus` to distinguish a resolved community post from `not_found`.

GET/v1/youtube/community-posts
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
1
url*stringquery

Public YouTube community post URL.

min 1 chars · max 4096 chars

Response fields
34

Endpoint-specific response payload.

datalookupStatus
string

Whether the community post was resolved for this request.

one of: found, not_found

Community post details when found.

datapostid
string

YouTube community post identifier.

min 1 chars

dataposturl
string

Canonical public YouTube community post URL.

min 1 chars

dataposttext
stringnullable

Post text content when available.

datapostpublishedAt
stringnullable

Publish timestamp when available.

datapostpublishedTimeText
stringnullable

Human-readable relative publish time when available.

Publishing channel when found.

datachannelplatform
string

Social platform for this channel.

one of: youtube

datachannelplatformUserId
stringnullable

YouTube channel id when available.

datachannelhandle
stringnullable

YouTube channel handle without a leading @ when available.

datachanneldisplayName
stringnullable

Public display name for the channel when available.

datachannelprofileUrl
stringnullable

Canonical public YouTube channel URL when available.

Media attached to the community post.

Image URLs attached to the community post.

datamediaimageUrls[]
stringoptional

min 1 chars

Linked video when the post promotes or embeds one.

datamedialinkedVideoid
string

YouTube video identifier.

min 1 chars

datamedialinkedVideourl
string

Canonical public YouTube watch URL.

min 1 chars

datamedialinkedVideotitle
stringnullable

Video title when available.

datamedialinkedVideothumbnailUrl
stringnullable

Thumbnail image URL when available.

datamedialinkedVideopublishedAt
stringnullable

Publish timestamp when available.

datamedialinkedVideopublishedTimeText
stringnullable

Human-readable relative publish time when available.

datamedialinkedVideoviewCount
integernullable

View count when available.

≥ 0

datamedialinkedVideoviewCountText
stringnullable

Human-readable view count when available.

datamedialinkedVideodurationSeconds
integernullable

Duration of the video in seconds when available.

≥ 0

datamedialinkedVideodurationText
stringnullable

Human-readable duration label when available.

Engagement metrics when found.

datametricslikes
integernullable

Like count when available.

≥ 0

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/community-posts?url=https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8" \
  -H "x-api-key: YOUR_API_KEY"

Responses

YouTube community post details. Check `data.lookupStatus` for `found` vs `not_found`.

On this page

No Headings