SmasharchivesInfo For Developers

Are you looking to develop apps that utilize Smasharchives' VOD index? This page will have you covered!


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.