API Documentation

YouTube

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`	bool	No	Use cached data if available

Example response

json

{
  "avatar": "example",
  "banner": "example",
  "channelId": "example",
  "description": "example",
  "externalLinks": [],
  "name": "example",
  "subscriberCount": 1,
  "videoCount": 1
}

Code

curl -X POST https://dev-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",
  "cache": true
}'

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`	bool	No	Use cached data if available

Example response

json

{
  "videos": [
    {
      "duration": "example",
      "publishedAt": "example",
      "thumbnail": "example",
      "title": "example",
      "videoId": "example",
      "viewCount": 1
    }
  ]
}

Code

curl -X POST https://dev-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",
  "cache": true
}'

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`	bool	No	Use cached data if available

Example response

json

{
  "results": [
    {
      "channelName": "example",
      "publishedAt": "example",
      "thumbnail": "example",
      "title": "example",
      "videoId": "example",
      "viewCount": 1
    }
  ]
}

Code

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

Try it

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`	bool	No	Include video captions/subtitles in the response
`cache`	bool	No	Use cached data if available

Example response

json

{
  "channelId": "example",
  "channelName": "example",
  "chapters": [],
  "description": "example",
  "duration": "example",
  "likeCount": 1,
  "publishedAt": "example",
  "tags": [],
  "thumbnails": {},
  "title": "example",
  "videoId": "example",
  "viewCount": 1
}

Code

curl -X POST https://dev-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",
  "include_captions": true,
  "cache": true
}'

Try it