API Reference
YouTube API
Search YouTube videos, extract transcripts, and analyze video content — all without a YouTube API key. The YouTube endpoint uses the same HyperFusion ranking and QATBE token-budgeted extraction as the main search API.
POST/v1/youtube/search
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query. Max 500 characters. |
max_results | integer | No | Videos to return. Range: 1–20. Default: 5. |
tier | string | No | Detail level for transcript extraction. Default: summary. |
include_transcript | boolean | No | Extract and include video transcripts. Default: true. |
language | string | No | Preferred transcript language (BCP-47). Default: en. |
min_duration | integer | No | Minimum video duration in seconds. |
max_duration | integer | No | Maximum video duration in seconds. |
freshness | string | No | Filter by upload date: day, week, month, year. |
Example request
youtube.sh
curl -X POST https://api.hypersearchx.zuhabul.com/v1/youtube/search \
-H "Authorization: Bearer hsx_your_key" \
-H "Content-Type: application/json" \
-d '{
"query": "rust async tokio tutorial",
"max_results": 5,
"tier": "summary",
"include_transcript": true
}'Response
response.json
{
"meta": {
"query": "rust async tokio tutorial",
"results_count": 5,
"tokens_used": 2840,
"duration_ms": 3120
},
"results": [
{
"video_id": "dQw4w9WgXcQ",
"title": "Tokio Tutorial: Async Rust in Practice",
"channel": "Let's Get Rusty",
"channel_id": "UCpeX4D-ArTrsqvhLapAHprQ",
"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg",
"duration_seconds": 2847,
"view_count": 234521,
"published_at": "2024-09-15T00:00:00Z",
"score": 0.912,
"transcript_snippet": "In this tutorial, we explore Tokio, the most popular async runtime for Rust. We cover the core concepts of async/await, the Tokio scheduler, and practical patterns for building concurrent applications..."
}
]
}Response fields
| Field | Description |
|---|---|
video_id | YouTube video ID |
duration_seconds | Video length in seconds |
view_count | Current view count |
score | HyperFusion relevance score (0–1) |
transcript_snippet | QATBE-extracted transcript excerpt (null if no transcript) |
Social research endpoint
Cross-platform social media research across Reddit, Hacker News, and dev communities:
POST/v1/social/research
bash
curl -X POST https://api.hypersearchx.zuhabul.com/v1/social/research \
-H "Authorization: Bearer hsx_your_key" \
-H "Content-Type: application/json" \
-d '{
"query": "best rust web framework 2025",
"platforms": ["reddit", "hackernews"],
"max_sources": 10,
"tier": "summary"
}'