YouTube Video Finder

Search several resources for archived YouTube video and metadata

• Source code (GitHub)
• Back to home

API Documentation

Please note: The API can be used to embed this site into your own code. If you just want to search for a video, return to the homepage.

Call: GET /api/:version/:videoid

Accepted query string parameters: includeRaw (set to include the rawraw field), stream (stream service objects as they are processed, rather than all at the end)

Current versions available: v2, v3, v4. Documentation below only applies to the latest version.

id (str)

The interpreted video ID.

status (str)

bad.id if invalid ID.

keys (list[YouTubeService])

An array with all the server responses. THIS IS DIFFERENT THAN BEFORE! Before, this would be an array of strings. You'd use the strings as keys. Now, this array has the data directly!

api_version (int)

The API version. Breaking API changes are made by incrementing this.

verdict (dict)

The verdict of the response. Has video, metaonly, and comments field, that are set to true if any archive was found where that was saved. Also has human_friendly field that has a simple verdict that can be used by people.

A stream of JSONL: one json object followed by a newline, then the next, etc. The order of what is sent:

• Object of internal class name to on-screen name. Use this to pre-populate the list. You probably don't need the internal class name - it's only provided in case you need it for e.g. element IDs where the usable character set is limited.
• Service objects (see below), as they are generated.
• Null, to show that we are finished generating the service objects. (You can also use the object of class names, but this probably works better.)
• A verdict.

archived (bool)

Whether the video is archived or not.

available (Optional[str])

A link to the archived material if it can be produced; null otherwise.

capcount (int)

The number of captures. Currently deprecated - the capture count sent may or may not be the true number of captures. However, it will always be a positive non-zero number if the video is archived.

error (Optional[str])

An error message if an error was encountered; otherwise, null.

lastupdated (int)

The timestamp the data was retrieved from the server. Used internally to expire cache entries.

name (str)

The name of the service. Used in the UI.

note (str)

A footnote about the service. This could be different depending on conditions. For example, the Internet Archive has an extra passage if the item is dark. Used in the UI.

rawraw (Any)

The data used to check whether the video is archived on that particular service. For example, for GhostArchive, it would be the HTTP status code. The structure could change at any time.

metaonly (bool)

True if only the metadata is archived. This value should not be relied on!

comments (bool)

True if the comments are archived. This value should not be relied on!

maybe_paywalled (bool)

True if the service might require payment.

classname (str)

The internal class name, useful for streaming mode.

Website created by TheTechRobo