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 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.

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.

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.

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

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.

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.

Getting Started

Concepts

Guides

Cookbook

Billing & Limits

Integrations

Updates

YouTube Live Data

YouTube Live Data

Endpoints and pricing

Search for emerging videos

Continue to the next page

Expand a topic seed

Fetch exact video details

Resolve a channel

MCP and no-code access

​YouTube Live Data

​Endpoints and pricing

​Search for emerging videos

​Continue to the next page

​Expand a topic seed

​Fetch exact video details

​Resolve a channel

​MCP and no-code access

YouTube Live Data

Endpoints and pricing

Search for emerging videos

Continue to the next page

Expand a topic seed

Fetch exact video details

Resolve a channel

MCP and no-code access