SmasharchivesInfo For Developers

API

Our REST API is publicly accessible, with the Swagger documentation being accessible here.

There are a few things you should keep in mind when querying our API:

• Crawls are executed once every 24 hours.
• All VOD endpoints are cached. Cache times range from 1-6 hours depending on endpoint.
• Certain endpoints are rate limited, and intensive querying (akin to a DOS) will result in an IP block.
• HTTP Exceptions may be thrown (such as a 404 for a nonexistent VOD).

As such, it is recommended that your application:

• Doesn't query the same data endpoint more than once every 24 hours (since the data that will be returned will be the same anyway)
• Doesn't query mutating endpoints (POST, PATCH, PUT) more than necessary to avoid being blacklisted.
• Look for (and handle) HTTP Exceptions appropriately.