joshu

Search YouTube by keyword

From Just One API, through Joshu Data Bodega.

Part of YouTube search videos.

Price
$0.016 per call

No calls measured in the last 30 days.

Prices include the router's 10% markup and are paid from the usage wallet. Checked on November 11, 2026.

Inputs

  • typestring: video, channel, playlist, movie, optional

    Filter results by result type. Available Values: - `video`: Video results - `channel`: Channel results - `playlist`: Playlist results - `movie`: Movie results One of: video, channel, playlist, movie.

  • sortBystring: relevance, upload_date, view_count, rating, optional

    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 One of: relevance, upload_date, view_count, rating.

  • keywordstring, optional

    Search keyword. Required on the first request; leave empty when using a continuation token.

  • durationstring: SHORT, MEDIUM, LONG, optional

    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 One of: SHORT, MEDIUM, LONG.

  • featuresstring: live, FOUR_K, hd, subtitles, creative_commons, THREE_SIXTY, vr180, THREE_D, hdr, optional

    Feature filters separated by commas. Supported values: live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr. One of: live, FOUR_K, hd, subtitles, creative_commons, THREE_SIXTY, vr180, THREE_D, hdr.

  • uploadDatestring: last_hour, today, this_week, this_month, this_year, optional

    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 One of: last_hour, today, this_week, this_month, this_year.

  • continuationTokenstring, optional

    Pagination token returned by the previous response.

Call it

Router call with a router API key
curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "justoneapi.x.youtube-search-v1",
    "params": {
      "keyword": "coffee"
    }
  }'