Skip to main content
POST
YouTube Hashtag Search API

YouTube Hashtag Search

Search public YouTube videos by hashtag. Results are normalized and billed by the actual saved record count.

Use with MCP

Use the JSON request body above as the nested input object for socq_execute, or pass the same fields directly to the typed tool. Typed tools also accept _wait_seconds, _result_limit, and _idempotency_key.
A successful submission returns a task_id. Continue with socq_get_task until the task succeeds, then read normalized records from results.items.
See MCP quickstart for the complete submission and polling flow.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
hashtags
string[]
required

Hashtags with or without the # prefix.

Minimum array length: 1
Minimum string length: 1
callback_url
string<uri>
content_type
string
Minimum string length: 1
results_limit
integer
default:100
Required range: 20 <= x <= 2000

Response

200 - application/json

Task accepted

code
integer
data
object