> ## Documentation Index
> Fetch the complete documentation index at: https://docs.influship.com/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube Live Data

> Discover current YouTube topics, paginate search results, and fetch channel, video, and transcript data.

# YouTube Live Data

The YouTube live endpoints cover topic discovery, channel research, video validation, and transcripts. Search is designed for bounded discovery jobs: choose filters, inspect one page, and continue with the returned cursor only when you need more candidates.

## Endpoints and pricing

| Endpoint                                           | Returns                                        |                   Credits |
| -------------------------------------------------- | ---------------------------------------------- | ------------------------: |
| `GET /v1/raw/youtube/search`                       | One filtered result page and `next_cursor`     |                `0.5/page` |
| `GET /v1/raw/youtube/typeahead`                    | Localized query suggestions                    |             `0.5/request` |
| `GET /v1/raw/youtube/video/{video_id}`             | Fresh video metadata and engagement            |               `0.5/video` |
| `GET /v1/raw/youtube/channel/{handle}`             | Channel identity, metrics, and optional videos |             `0.5/channel` |
| `GET /v1/raw/youtube/transcript/{video_id}`        | One normalized transcript                      |          `0.5/transcript` |
| `GET /v1/raw/youtube/channel-transcripts/{handle}` | Selected channel-video transcripts             | `0.5/transcript returned` |

One credit is \$0.01. API-key and OAuth requests are charged only when they succeed. See [Pricing](/concepts/pricing) for the payment-rail rules.

## Search for emerging videos

Use topic phrases or entities in `q`. Hashtags are accepted as ordinary query text, but phrases usually cover more of the language people use in titles and descriptions.

```bash theme={null}
curl --get 'https://api.influship.com/v1/raw/youtube/search' \
  -H "X-API-Key: $INFLUSHIP_API_KEY" \
  --data-urlencode 'q=mini documentary urban planning' \
  --data-urlencode 'upload_date=this_week' \
  --data-urlencode 'sort_by=popular' \
  --data-urlencode 'content_type=videos' \
  --data-urlencode 'duration=long' \
  --data-urlencode 'country_code=US' \
  --data-urlencode 'language_code=en' \
  --data-urlencode 'limit=20'
```

Search supports these controls:

| Parameter       | Values                                                              |
| --------------- | ------------------------------------------------------------------- |
| `upload_date`   | `any`, `last_hour`, `today`, `this_week`, `this_month`, `this_year` |
| `sort_by`       | `relevance`, `popular`                                              |
| `content_type`  | `all`, `videos`                                                     |
| `duration`      | `any`, `short`, `medium`, `long`                                    |
| `country_code`  | Two-letter country code, such as `US` or `GB`                       |
| `language_code` | Language code, such as `en` or `en-GB`                              |
| `limit`         | 1 to 50 results per page                                            |

Video search results include channel identity, duration, view count, thumbnail, and relative and approximate publication data. Use the video endpoint when exact publication data or current likes and comments affect your ranking.

## Continue to the next page

Each successful search returns `next_cursor`. Treat it as opaque and return it unchanged with the original query and filters.

```bash theme={null}
curl --get 'https://api.influship.com/v1/raw/youtube/search' \
  -H "X-API-Key: $INFLUSHIP_API_KEY" \
  --data-urlencode 'q=mini documentary urban planning' \
  --data-urlencode 'upload_date=this_week' \
  --data-urlencode 'sort_by=popular' \
  --data-urlencode 'content_type=videos' \
  --data-urlencode 'duration=long' \
  --data-urlencode 'cursor=PASTE_NEXT_CURSOR_HERE'
```

Every continuation request is another 0.5-credit page. Set a page ceiling in scheduled jobs so a changing result set cannot create unbounded work.

## Expand a topic seed

Typeahead returns current localized suggestions for a partial phrase.

```bash theme={null}
curl --get 'https://api.influship.com/v1/raw/youtube/typeahead' \
  -H "X-API-Key: $INFLUSHIP_API_KEY" \
  --data-urlencode 'q=why do cities' \
  --data-urlencode 'country_code=US' \
  --data-urlencode 'language_code=en'
```

Use a small set of distinct suggestions as search seeds, then deduplicate videos by `video_id` before scoring them.

## Fetch exact video details

```bash theme={null}
curl 'https://api.influship.com/v1/raw/youtube/video/dQw4w9WgXcQ' \
  -H "X-API-Key: $INFLUSHIP_API_KEY"
```

The response includes views, likes, comments, duration, tags, categories, channel identity, and `published_at` when YouTube supplies an exact timestamp.

## Resolve a channel

Channel routes accept a bare handle, an `@handle`, a `UC`-prefixed channel ID, or a full channel URL.

```bash theme={null}
curl --get 'https://api.influship.com/v1/raw/youtube/channel/@techreviews' \
  -H "X-API-Key: $INFLUSHIP_API_KEY" \
  --data-urlencode 'include_videos=true' \
  --data-urlencode 'video_limit=12'
```

## MCP and no-code access

The six workflows are available through the Influship MCP server as `search_youtube`, `get_youtube_typeahead`, `get_youtube_video`, `get_youtube_channel`, `get_youtube_video_transcript`, and `get_youtube_channel_transcripts`.

n8n and Make expose the same YouTube operations as dedicated fields and actions. Zapier users can call these REST endpoints from a Webhooks step.