scrollport

Search YouTube videos by keyword and filters

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

by TikHubReady to run$0.0028 per request · $0.28 per 100 requests

Example

You ask your agent

“Search YouTube for videos about coffee.”

You get

Title
COFFEE (Official Music Video) - Amrinder Gill | Jasmeen Akhtar | Navi Brar | Raj Ranjodh
URL
https://www.youtube.com/watch?v=Gy7nd_A9AIE
Duration
2:44
View count
26,403,489 views
What your agent sends and gets back (JSON)

Your agent works out the exact inputs, such as IDs, dates and settings, from what you ask.

Request

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

Response

{
  "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"
  }
}

Use it with your agent

Copy the prompt and paste it into your agent, then 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.

Provider access is included. If your agent isn't connected to Scrollport yet, it will help you set that up.

Other tools for this job

Compare all 11 →

Questions

Is Search YouTube videos by keyword and filters (TikHub) free?

Scrollport has no free tier: it costs $0.0028 per request ($0.28 per 100 requests), paid per use from a prepaid wallet with no subscription. Connecting your first agent adds $1 of trial credit, so you can try it before adding funds.

Do I need an API key from TikHub?

No. Your agent runs it through your Scrollport connection (MCP, the Scrollport CLI or the HTTP API), and Scrollport handles access to TikHub, so you don't sign up with TikHub or manage an API key.

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.

All 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

Main result payload.

Errors and limits
  • 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.