scraper
Back to API docs

Overview

  • Overview

Discovery

  • POSTSearch
  • POSTHashtag

Content

  • POSTVideo
  • POSTChannel
  • POSTChannel Videos
  • POSTPlaylist

Details

  • POSTTranscript
  • POSTComments

YouTube Hashtag

0.5 credits

Get videos associated with a YouTube hashtag.

POST/api/v1/tools/youtube/hashtag

Parameters

hashtagstringrequired

Hashtag to search for (without the # symbol).

maxResultsnumber

Maximum number of results to return. Defaults to 30.

fieldsstring[]

Fields to include per video. Omit for defaults: videoId, title, channelName, viewCount, duration, publishedTime. Use ["*"] for all fields. Available fields: videoId, title, channelName, viewCount, duration, publishedTime, thumbnailUrl, channelId.

Response Schema

dataobject

YouTube hashtag result

hashtagstring

The queried hashtag

videosobject[]

Array of video objects for the hashtag.

countnumber

Number of results returned

truncatedboolean

True if results were cut short. Only present when truncation occurred.

metaobject

Request metadata

toolstring

Tool name (youtube-hashtag)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/youtube/hashtag \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
"hashtag": "webdev",
"maxResults": 15
}'

Response Example

{
"data": {
"hashtag": "webdev",
"videos": [
{
"videoId": "abc123xyz",
"title": "10 Web Dev Tips You Need to Know",
"channelName": "Code Daily",
"viewCount": "320K views",
"duration": "14:22",
"publishedTime": "5 days ago"
}
],
"count": 1
},
"meta": {
"tool": "youtube-hashtag",
"creditsUsed": 0.5,
"requestId": "req_abc123"
}
}