YouTube General Search API (V1)

GET

API health status

Healthy Available Limited Mostly unavailable No data

Loading health status...

Search YouTube through TIKHUB general search, returning mixed video, channel, playlist, and movie results with continuation tokens plus filters for upload date, type, duration, features, and sort order for discovery and monitoring.

Parameters

Name	In	Type	Required	Default	Description
token	query	string	Yes	-	Access token for this API service.
keyword	query	string	No	``	Search keyword. Required on the first request; leave empty when using a continuation token.
continuationToken	query	string	No	``	Pagination token returned by the previous response.
uploadDate	query	string	No	-	Filter results by upload date. Available Values: - last_hour: Uploaded within the last hour - today: Uploaded today - this_week: Uploaded this week - this_month: Uploaded this month - this_year: Uploaded this year
type	query	string	No	-	Filter results by result type. Available Values: - video: Video results - channel: Channel results - playlist: Playlist results - movie: Movie results
duration	query	string	No	-	Filter video results by duration. Supported request values: short, medium, long. Available Values: - SHORT: Short videos under 4 minutes - MEDIUM: Medium videos from 4 to 20 minutes - LONG: Long videos over 20 minutes
features	query	string	No	-	Feature filters separated by commas. Supported values: live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr.
sortBy	query	string	No	-	Sort order for search results. Available Values: - relevance: Sort by relevance - upload_date: Sort by upload date - view_count: Sort by view count - rating: Sort by rating

Code Samples

💡 Environment Note

Use https://api.justoneapi.com by default. Mainland China users can use http://47.117.133.51:30015 instead.

🐚 cURL

curl -X GET "https://api.justoneapi.com/api/youtube/search/v1?token=YOUR_API_KEY"

🤖 AI Prompt

I want to use the "General Search (V1)" API from Just One API.
Base URL: use https://api.justoneapi.com by default. Mainland China users can use http://47.117.133.51:30015 instead.
API Path: /api/youtube/search/v1?token=YOUR_API_KEY
API Endpoint: BASE_URL + /api/youtube/search/v1?token=YOUR_API_KEY
HTTP Method: GET
Authentication: Append the "token" query parameter to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/youtube/general-search-v1-en.json

Parameters:
- token (query): Access token for this API service. (Required)
- keyword (query): Search keyword. Required on the first request; leave empty when using a continuation token.
- continuationToken (query): Pagination token returned by the previous response.
- uploadDate (query): Filter results by upload date.

Available Values:
- `last_hour`: Uploaded within the last hour
- `today`: Uploaded today
- `this_week`: Uploaded this week
- `this_month`: Uploaded this month
- `this_year`: Uploaded this year
- type (query): Filter results by result type.

Available Values:
- `video`: Video results
- `channel`: Channel results
- `playlist`: Playlist results
- `movie`: Movie results
- duration (query): Filter video results by duration. Supported request values: short, medium, long.

Available Values:
- `SHORT`: Short videos under 4 minutes
- `MEDIUM`: Medium videos from 4 to 20 minutes
- `LONG`: Long videos over 20 minutes
- features (query): Feature filters separated by commas. Supported values: live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr.
- sortBy (query): Sort order for search results.

Available Values:
- `relevance`: Sort by relevance
- `upload_date`: Sort by upload date
- `view_count`: Sort by view count
- `rating`: Sort by rating

Return format: JSON

Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set the request timeout to 120 seconds. If 120 seconds is too long for your use case, use at least 60 seconds, but a small number of requests may time out before receiving a result.
3. Business Code Reference:
   - 0: Success
   - 100: Invalid or Inactive Token
   - 301: Collection Failed. Please Retry.
   - 302: Rate Limit Exceeded
   - 303: Daily Quota Exceeded
   - 400: Invalid Parameters
   - 500: Internal Server Error
   - 600: Permission Denied
   - 601: Insufficient Balance

Please help me write a script in my preferred programming language to call this API and handle the response.

🐍 Python

import requests

BASE_URL = "https://api.justoneapi.com"  # Mainland China: "http://47.117.133.51:30015"

url = BASE_URL + "/api/youtube/search/v1?token=YOUR_API_KEY"
response = requests.get(url)
print(response.json())

🌐 JavaScript

const BASE_URL = "https://api.justoneapi.com"; // Mainland China: "http://47.117.133.51:30015"
const url = BASE_URL + "/api/youtube/search/v1?token=YOUR_API_KEY";

const response = await fetch(url, {
  method: "GET"
});
const data = await response.json();
console.log(data);

☕ Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        final String BASE_URL = "https://api.justoneapi.com"; // Mainland China: "http://47.117.133.51:30015"
        final String url = BASE_URL + "/api/youtube/search/v1?token=YOUR_API_KEY";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

🐹 Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

const BASE_URL = "https://api.justoneapi.com" // Mainland China: "http://47.117.133.51:30015"

func main() {
	client := &http.Client{}
	url := BASE_URL + "/api/youtube/search/v1?token=YOUR_API_KEY"
	req, _ := http.NewRequest("GET", url, nil)
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

🐘 PHP

<?php
$BASE_URL = "https://api.justoneapi.com"; // Mainland China: "http://47.117.133.51:30015"
$url = $BASE_URL . "/api/youtube/search/v1?token=YOUR_API_KEY";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;

[OpenAPI Definition (JSON)]

Response Example

Loading the latest successful example...