Skip to main content
POST
YouTube Shorts Search API

YouTube Shorts Search

Search YouTube for Shorts that match a keyword and get each Short’s link, caption, view count and vertical thumbnail. Search results carry only those basics, so pass the links you keep to YouTube Videos when you also need likes, comments or channel details.
query is required. results_limit defaults to 25 and accepts 1 to 200. Shorts come back in YouTube’s search order.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

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

query is required. Returns Shorts in YouTube's search order. results_limit defaults to 25 and accepts 1 to 200.

query
string
required

Keywords to search YouTube for.

Required string length: 1 - 100
callback_url
string<uri>
results_limit
integer
default:25
Required range: 1 <= x <= 200

Response

Task accepted

code
integer
data
object