Search YouTube videos by keyword and filters

TikHub

Search YouTube by keyword (filter type=video for videos only)

Capability: YouTube content research
Current price: $0.0028/call
Availability: Ready to run

What this API does

Search YouTube by keyword (filter type=video for videos only) Retrieve one bounded result or page using the documented fields. Pagination is explicit: follow-up pages require another run. The catalog price is the maximum per request; the quote reflects the selected limits and the wallet settles the verified actual cost plus 40%. Free supplier calls remain free. Read public social data without a connected social account. Results contain reviewed business data and available pagination. The worked example shows selected fields from a recorded response, with at most the first item of each list.

Agents select this operation with tool ID tikhub.youtube-search-videos, then check its current inputs and price before a run.

Inputs and outputs

Input

continuation_tokenstring · optional

pagination token for the next page

minLength: 1 · maxLength: 4096

durationstring · optional

short ( 20min)

minLength: 1 · maxLength: 500

featuresstring · optional

comma-separated: live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr

minLength: 1 · maxLength: 500

keywordstring · required

required on the first request; omit when paging with continuation_token

minLength: 1 · maxLength: 500

sort_bystring · optional

relevance | upload_date | view_count | rating

minLength: 1 · maxLength: 500 · enum: relevance, upload_date, view_count, rating

typestring · optional

video | channel | playlist | movie

minLength: 1 · maxLength: 500 · enum: video, channel, playlist, movie

upload_datestring · optional

last_hour | today | this_week | this_month | this_year

minLength: 1 · maxLength: 500

Output

dataobject

Returned data value.

Example request and output

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

Request

{
  "tool_id": "tikhub.youtube-search-videos",
  "input": {
    "type": "video",
    "keyword": "coffee"
  }
}

Output

{
  "data": {
    "videos": [
      {
        "url": "https://www.youtube.com/watch?v=Gy7nd_A9AIE",
        "title": "COFFEE (Official Music Video) - Amrinder Gill | Jasmeen Akhtar | Navi Brar  | Raj Ranjodh",
        "duration": "2:44",
        "video_id": "Gy7nd_A9AIE",
        "view_count": "26,403,489 views"
      }
    ],
    "keyword": "coffee"
  }
}

Errors and limitations

invalid_input: The lookup fields or limits are invalid.example: {"keyword":"coffee","type":"video"}
upstream_error: The provider could not complete a verified result; the wallet was not charged.Check the documented fields and contact Scrollport support with the run ID if needed.

Use Search YouTube videos by keyword and filters with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.