YouTube Search

API key Retired v1

Retired on 15 Sep 2026. This endpoint is retired as of 15 September 2026. It receives no further fixes or support and may be switched off without further notice. Remove it from existing integrations; no replacement is offered.

Search YouTube by keyword and get up to 50 videos with statistics.

Runs a YouTube video search and enriches each hit with duration and view, like and comment counts. Only videos with public statistics are included.

GET https://api.zactonz.com/tuber/v1/yt-search.php

Parameters

Name	Type	Description
`key`required	string	Your API key, repeated as a query parameter. Kept for existing integrations; the `Authorization: Bearer` header is the supported way to authenticate.
`q`required	string	Search terms.

Send parameters in the query string.

Response

Matching videos, most relevant first.

Field	Type	Description
`status`	string	`"200"` on success (a string).
`results`	array of object
`results[].videoId`	string	YouTube video id.
`results[].publishedAt`	string	ISO 8601 publish time.
`results[].title`	string
`results[].description`	string
`results[].thumbnail`	string	`hqdefault` thumbnail URL.
`results[].channelId`	string
`results[].channelTitle`	string
`results[].duration`	string	`H:MM:SS` or `MM:SS`.
`results[].viewCount`	string
`results[].likeCount`	string
`results[].dislikeCount`	null	Always `null`.
`results[].commentCount`	string

Status codes

The outcome is reported in the JSON status field. See Errors & status codes for the general rules.

`200`	OK	The search ran. `results` may be empty.
`502`	Search failed	YouTube's Data API rejected the request. Retry later.
`null`	Rejected	`key` was missing or invalid, or `q` was empty.

Notes

Each result costs an extra lookup for statistics, so a full page of 50 can take a few seconds. dislikeCount is always null: YouTube retired it from its Data API in 2021 and the key is kept for older clients.