Social Fetch
YouTube

Search YouTube by hashtag

Search YouTube by hashtag.

Use `data.page.hasMore` and `data.page.nextCursor` for pagination rather than inferring completion from result count alone.

GET/v1/youtube/search/hashtags
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
3
hashtag*stringquery

Hashtag to search for. A leading # is optional.

min 1 chars · max 256 chars

typestringoptionalquery

Optional content filter.

one of: all, shorts

cursorstringoptionalquery

Opaque pagination cursor returned by a previous response.

min 1 chars

Response fields
31

Endpoint-specific response payload.

datahashtag
string

Hashtag evaluated for this response, without a leading #.

datatype
string

Content filter applied for this response.

one of: all, shorts

Matching videos and Shorts for the hashtag.

dataresults[]id
string

YouTube content identifier.

min 1 chars

dataresults[]kind
string

Normalized media kind for this row.

one of: video, short

dataresults[]url
stringnullable

Canonical public URL for this item when available.

dataresults[]title
stringnullable

Title shown for this item.

dataresults[]description
stringnullableoptional

Description text when available.

dataresults[]thumbnailUrl
stringnullable

Thumbnail image URL when available.

Channel metadata when available.

dataresults[]channelid
stringnullable

Channel identifier when available.

dataresults[]channeltitle
stringnullable

Channel title when available.

dataresults[]channelhandle
stringnullable

Channel handle when available.

dataresults[]channelthumbnailUrl
stringnullable

Channel thumbnail URL when available.

dataresults[]viewCount
integernullable

View count when available.

≥ 0

dataresults[]viewCountText
stringnullable

Human-readable view count label when available.

dataresults[]publishedAt
stringnullable

ISO-8601 publish timestamp when available.

dataresults[]publishedTimeText
stringnullable

Human-readable relative publish time when available.

dataresults[]durationSeconds
integernullable

Duration in seconds when available.

≥ 0

dataresults[]durationText
stringnullable

Human-readable duration label when available.

Display badges such as New or Live when present.

dataresults[]badges[]
stringoptional
datatotalResults
integer

Number of result rows returned in this response.

≥ 0

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 results 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/search/hashtags?hashtag=trending" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Hashtag search results for the requested tag.

On this page

No Headings