API Documentation

YouTube

YouTube Video Details

Get full video details: title, description, view/like counts, duration, tags, thumbnails, chapters.

POST

/api/v1/youtube_video

1 credit per call

Parameters

Field	Type	Required	Description
`url`	string	Yes	YouTube video URL or video ID
`include_captions`	boolean	No	Include video captions/subtitles in the response
`cache`	boolean	No	Use cached data if available

Response fields

Field	Type	Description
`videoId`	string	YouTube video ID
`title`	string	Video title
`description`	string	Full video description
`channelName`	string	Channel name
`channelId`	string	Channel ID
`viewCount`	integer	Total view count
`likeCount`	integer	Total like count
`duration`	string	Video duration (ISO 8601)
`tags`	array	Video tags
`thumbnails`	object	Thumbnail URLs by quality (default, medium, high, maxres)
`chapters`	array	Chapter timestamps and titles (if available)
`publishedAt`	string	Publication date

Code

curl -X POST https://api.richapi.ai/api/v1/youtube_video \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}'

Try it

YouTube Search

Search YouTube videos — returns up to 20 video IDs, titles, channels, view counts, and thumbnails per call.

POST

/api/v1/youtube_search

1 credit per call

Parameters

Field	Type	Required	Description
`query`	string	Yes	Search query
`cache`	boolean	No	Use cached data if available

Response fields

Field	Type	Description
`results`	array	List of matched videos
`results[].videoId`	string	YouTube video ID
`results[].title`	string	Video title
`results[].channelName`	string	Channel name
`results[].viewCount`	integer	View count
`results[].thumbnail`	string	Thumbnail URL
`results[].publishedAt`	string	Publication date

Code

curl -X POST https://api.richapi.ai/api/v1/youtube_search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "python tutorial"
}'

Try it

YouTube Channel Info

Get channel info: name, subscriber count, description, avatar, banner, external links.

POST

/api/v1/youtube_channel

1 credit per call

Parameters

Field	Type	Required	Description
`url`	string	Yes	YouTube channel URL (@handle, /c/, or /channel/ format)
`cache`	boolean	No	Use cached data if available

Response fields

Field	Type	Description
`channelId`	string	YouTube channel ID
`name`	string	Channel name
`description`	string	Channel description
`subscriberCount`	integer	Subscriber count
`videoCount`	integer	Total video count
`avatar`	string	Channel avatar URL
`banner`	string	Channel banner URL
`externalLinks`	array	External links listed on the channel

Code

curl -X POST https://api.richapi.ai/api/v1/youtube_channel \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.youtube.com/@MrBeast"
}'

Try it

YouTube Channel Videos

List up to 50 most recent videos from a YouTube channel with titles, view counts, and durations per call.

POST

/api/v1/youtube_channel_videos

2 credits per call

Parameters

Field	Type	Required	Description
`url`	string	Yes	YouTube channel URL
`cache`	boolean	No	Use cached data if available

Response fields

Field	Type	Description
`videos`	array	List of videos
`videos[].videoId`	string	Video ID
`videos[].title`	string	Video title
`videos[].viewCount`	integer	View count
`videos[].duration`	string	Duration (ISO 8601)
`videos[].publishedAt`	string	Publication date
`videos[].thumbnail`	string	Thumbnail URL

Code

curl -X POST https://api.richapi.ai/api/v1/youtube_channel_videos \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.youtube.com/@MrBeast"
}'

Try it