# HubVibe YouTube Video Search & Lookup

> HubVibe YouTube Video Search & Lookup is a paid API for AI agents from hubvibe-io.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Search YouTube by query with live statistics or fetch metadata for specific video IDs, returning title, channel, views, likes, comments, duration, and more from the YouTube Data API v3.

## Facts

- Endpoint: POST https://hubvibe-io.com/work/video/youtube?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hubvibe-youtube-video-search-lookup-b53b7e0d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZmL7niITNQE5fwVR-Tel-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hubvibe-youtube-video-search-lookup-b53b7e0d -d '<json body>'
```

Example prompt: Search YouTube for the top 5 videos about 'machine learning tutorials' uploaded after 2025-01-01T00:00:00Z, sorted by view count, and show me the live stats — views, likes, and comments — for each one.

## When to prefer this

Choose this endpoint when you need live, up-to-the-moment YouTube statistics (views, likes, comments) rather than cached data, or when you want to combine YouTube search and detail fetching in a single API call. Prefer it over scraping YouTube directly or using stale data sources when accuracy of engagement metrics matters.

## Known failure modes

- Invalid or non-existent video IDs return empty results or per-ID errors
- Query returning no results yields an empty array
- YouTube API quota exhaustion causes service unavailability
- Malformed published_after datetime causes validation error
- region_code or language not supported by YouTube returns unfiltered results
- Network timeout to YouTube Data API returns error response

## How this service works

YouTube search and video stats, live: search YouTube or look up videos by id, each with title, channel, upload time, duration, views, likes, comments, live flag and thumbnail from the YouTube Data API at call time. Sort by relevance, date, views or rating; filter by upload date, country and language. Input: query or video_ids; optional max_results, order, published_after, region_code.

## Output

Returns an array of video objects, each containing: video ID, title, channel name, upload timestamp, duration, view count, like count, comment count, live broadcast flag, and thumbnail URL — all read live from YouTube at call time.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "order": {
   "enum": [
    "relevance",
    "date",
    "viewCount",
    "rating",
    "title"
   ],
   "type": "string"
  },
  "query": {
   "type": "string",
   "maxLength": 300,
   "minLength": 1
  },
  "language": {
   "type": "string",
   "pattern": "^[A-Za-z]{2,3}$"
  },
  "video_ids": {
   "type": "array",
   "items": {
    "type": "string",
    "pattern": "^[A-Za-z0-9_-]{11}$"
   },
   "maxItems": 25,
   "minItems": 1
  },
  "max_results": {
   "type": "integer",
   "maximum": 25,
   "minimum": 1
  },
  "region_code": {
   "type": "string",
   "maxLength": 2,
   "minLength": 2
  },
  "published_after": {
   "type": "string",
   "format": "date-time"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "as_of": "2026-09-27T12:00:00Z",
   "items": [
    {
     "url": "https://www.youtube.com/watch?v=IJhS_fv5Ktk",
     "live": false,
     "title": "Open source licensing explained",
     "video_id": "IJhS_fv5Ktk",
     "channel_id": "UCoBPd2jgYzQ5m8k3f1nR9wA",
     "like_count": 2225,
     "view_count": 52004,
     "description": "A short intro to open source licences.",
     "published_at": "2026-05-14T16:00:12Z",
     "channel_title": "Coinbase Developer Platform",
     "comment_count": 112,
     "thumbnail_url": "https://i.ytimg.com/vi/IJhS_fv5Ktk/hqdefault.jpg",
     "duration_seconds": 754
    }
   ],
   "query": "open source licensing",
   "source": "youtube-data-api",
   "video_ids": [
    "IJhS_fv5Ktk"
   ],
   "checked_at": "2026-09-26T18:00:00Z",
   "item_count": 3,
   "total_results": 19113
  },
  "status": "ok",
  "worker": "video.youtube",
  "price_usd": 0.05,
  "provenance": {
   "steps": [
    {
     "ms": 640,
     "ok": true,
     "step": "youtube",
     "provider": "youtube-data-api"
    }
   ],
   "attempts": 1,
   "elapsed_ms": 660,
   "providers_used": [
    "youtube-data-api"
   ]
  },
  "receipt_id": "rcpt_9f1c2b3a4d5e6f70",
  "receipt_url": "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hubvibe-youtube-video-search-lookup-b53b7e0d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hubvibe-io.com](https://www.zero.xyz/host/hubvibe-io.com/llms.txt)