General search (raw data, recommend V2)

https://api.sandbase.ai/v1/api/youtube/web-v2/general-search

YouTube comprehensive search with multiple filter options for precise result filtering.

Price
$0.0015USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
1 required · 9 optional
Production route

Try the model

Playground

Open playground
Input
Content type filter
Pagination token
Country code affecting regional relevance
Duration filter
Feature filter
Language code (zh-CN for Chinese, en-US for English)
Search keyword
Sort by
Time zone setting
Upload time filter
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price
$0.0015 / run
Daily free calls
First 100 calls per day free (shared per organization)

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

search_query
string · required
content_type
any · optional
continuation_token
any · optional
country_code
string · optional
duration
any · optional
feature
any · optional
language_code
string · optional
sort_by
any · optional
time_zone
string · optional
upload_time
any · optional

Access

Provider
YouTube
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/youtube/web-v2/general-search
Authentication
Bearer API key

API README

General search (raw data, recommend V2)

YouTube comprehensive search with multiple filter options for precise result filtering. It is suitable for youtube workflows.

Capability

YouTube comprehensive search with multiple filter options for precise result filtering. It helps applications, agents, and automated workflows turn that capability into repeatable tasks and useful downstream experiences.

Common use cases

  • Search and discover relevant records for research, monitoring, and product experiences.
  • Create repeatable integrations that pass structured results to downstream business systems.
  • Support scheduled jobs, internal tools, and agent workflows with structured results.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/youtube/web-v2/general-search
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/youtube/web-v2/general-search" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "feature": "360",
  "sort_by": "rating",
  "duration": "long",
  "time_zone": "America/Los_Angeles",
  "upload_time": "hour",
  "content_type": "movie",
  "country_code": "US",
  "search_query": "NASA",
  "language_code": "en-US"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
YouTube$0.0015 per callJSONJul 31, 2026
YouTube$0.0015 per callJSONJul 31, 2026
YouTube$0.0015 per callJSONJul 31, 2026
YouTube$0.0015 per callJSONJul 31, 2026
YouTube$0.0015 per callJSONJul 31, 2026
YouTube$0.0015 per callJSONJul 31, 2026

Questions

FAQ

How do I use the General search (raw data, recommend V2) API?

Send a POST request to https://api.sandbase.ai/v1/api/youtube/web-v2/general-search with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the General search (raw data, recommend V2) API cost?

$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the General search (raw data, recommend V2) API accept?

Required: search_query (string). Optional: content_type (any), continuation_token (any), country_code (string), duration (any), feature (any) and language_code (string) and 3 more. The Parameters table and the Playground on this page list every field.

What does the General search (raw data, recommend V2) API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a YouTube developer account or API key?

No. General search (raw data, recommend V2) runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for YouTube API access separately.