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.

Before you start	Details
Auth	API key or OAuth; supported payment rails also available
Resource	YouTube query, handle, or video ID
Cost	0.5 credits per resource, source page, or returned transcript
Limits	Choose page/video limits; use endpoint-specific bounds in the reference

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. Use these REST endpoints from any workflow platform that supports HTTP requests. Zapier users can call them from a Webhooks step.

Start building

Find and evaluate creators

Research and save

Apps and workflows

Live platform data

Connect your tools

Operate your integration

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

​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

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