← Main docs page

Verify videos

https://videomentions.com/api/v1/verify-videos?ids=${ONE},${TWO},${THREE}

This endpoint can be used to verify whether YouTube videos exist. This is useful for verifying that YouTube videos are still live and and have not been deleted.

Parameters

• ids - string. A comma-separated list of YouTube video IDs. A maximum of 50 IDs may be provided in each request.

Response

array. Verification results.

• id - string. Video ID.
• exists - boolean. true if the video exists, false if it does not.

Notes

If more than 50 comma-separated IDs are provided for the ids parameter, a 400 Bad Request error response will be returned.

Example

Below is an example request for checking whether the YouTube videos with IDs of NIR1Yfvy2vQ, pUtJ8HPZRkw, 9gUzRa58Dq, and ABC123 still exist.

curl -X GET 
-H "API-Key: your-api-key" 
-H "API-Secret: your-api-secret" 
https://videomentions.com/api/v1/verify-videos?ids=NIR1Yfvy2vQ,pUtJ8HPZRkw,NhHi0OjHUMQ,ABC123

Response

[
	{
		"id": "NIR1Yfvy2vQ",
		"exists": true
	},
	{
		"id": "pUtJ8HPZRkw",
		"exists": true
	},
	{
		"id": "9gUzRa58Dq",
		"exists": true
	},
	{
		"id": "ABC123",
		"exists": false
	}
]