VideoMentions YouTube API Documentation

The VideoMentions YouTube API can be used for fetching YouTube videos, channels and playlists data. You can review the pages of this documentation to learn how to use it.

Endpoints

Follow the links below for documentation on each API endpoint.

/channel Get a YouTube channel’s data.
/channel-playlists Get a YouTube channel’s playlists.
/channel-videos Get a YouTube channel’s videos.
/comments Get video comments.
/playlist Get a YouTube playlist’s data, including its videos.
/verify-channels Verify a list of YouTube channel IDs.
/verify-videos Verify a list of YouTube video IDs.
/video Get a YouTube video’s data.
/video-search Search for YouTube videos.

Authentication

The VideoMentions YouTube API uses a combination of an API key and API secret to authenticate requests. You will be given your key and secret once API access has been granted to you. The API key is a unique value that identifies your account and the API secret is a value used to authenticate your account’s requests, specifically.

The API key and API secret must be provided with every request as API-Key and API-Secret headers, as shown in the example below.

curl -X GET 
-H "API-Key: your-api-key" 
-H "API-Secret: your-api-secret" 
https://videomentions.com/api/v1/video?id=ENtxJcI5Ll4

If either of these headers is excluded or incorrect, a 401 Unauthorized error response will be returned.

Your API key and API secret carry privileges, so be sure to keep them secure. Don’t share your key or secret in publicly accessible places such as GitHub, client-side code, and so on.

Usage limits

Usage of the VideoMentions YouTube API is limited to a maximum of 10,000 requests per hour.

Example breakdown for a 30-day month:

500,000 requests to verify channels/videos (since up to 50 resources can be verified per request, this results in verification of 25,000,000 resources per month)
1,000,000 requests to get playlists for specific channels
5,700,000 requests to get single videos/playlists/channels
= 7,200,000 requests total (10k requests/hr * 24 hours * 30 days)

Note that the above is merely an example. Requests may be sent to any of the API endpoints in any amounts, as long as the total number of requests sent does not exceed 10,000 per hour.

Questions or concerns

If you have questions or concerns about the VideoMentions YouTube API, please contact us. Thank you for using the API.