scrollport

Back to Search YouTube videos and channels

Search YouTube videos by keyword and filters

TikHub

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

Use this tool with your AI agent

  1. Copy the prompt
  2. Paste it into your agent
  3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Search YouTube videos by keyword and filters (tool ID: tikhub.youtube-search-videos). Ask me for the details you need, then show me the result.

Already connected
Your agent can use that connection.
New user
Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

Job
Search YouTube videos and channels
Current price
$0.0028/request
Availability
Ready to run

Tool details

About this tool

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 upfront quote reflects the selected limits. Completed requests cost that quote, including valid empty pages and no-match answers. Supplier waivers do not change the customer price. Failed requests are uncharged. 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.

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.