This website is designed for ADULTS only and is not suited for children.
If you are not old enough to drink, you most likely shouldn't be here.
Haven't heard of Minecraft yet? Now is the time Official Minecraft Trailer - YouTube
Minecraft is not your thing? Well, how about Official Sea of Thieves Gameplay Launch Trailer - YouTube

And if you are not old enough for either, how on earth did you get here!?


We are offering a public api for various tasks, from controling a subscription to interacting with videos and search results in an automated way.


The Api is still in testing, consider changes and maybe even errors.


The endpoint for all methods is https://api.camshowhub.com/api


All responses are JSON encoded. Should there be a demand for other formats, we will support them too.


Codes:
ERROR_SERVER_OK = 200
ERROR_SERVER_CREATED = 201
ERROR_SERVER_ACCEPTED = 202
ERROR_SERVER_NO_CONTENT = 204
ERROR_SERVER_INTERNAL_ERROR = 500
ERROR_SERVER_UNAVAILABLE = 503

ERROR_CLIENT_BAD_REQUEST = 400
ERROR_CLIENT_FORBIDDEN = 403
ERROR_CLIENT_NOT_FOUND = 404
ERROR_CLIENT_TOO_MANY_REQUESTS = 429

We inherited the meaning of the http codes in the api codes.


$variable = to be replaced with a value.
(type) = type declaration.


Every response contains a (int)code declaring the status of the request.


GET https://api.camshowhub.com/api/search/$search_string

Response will contain:
(array)meta[
(int)count = the count of total results
(string)count_human = the count of total results in a formatted way
(int)duration = the total duration in milliseconds
(string)duration_human = the total duration in a formatted way
(int)size = the total size in bytes
(string)size_human = the total size in a formatted way
],
(array)entries[
(array)[
(string)id = the id of the video
(int)name = the unix timestamp of the video start
(string)name_human = the full name of the video including site, model and a date formatted unix timestamp
(int)duration = the duration in milliseconds
(string)duration_human = the duration in a formatted way
(int)width = the width of the video
(int)height = the height of the video
(string)dimension = the dimension of the video
(int)download_size = the download size in bytes
(string)download_size_human = the download size in a formatted way
(string)download_uri = the uri to the download
(int)do_screencap = the screencap status (0 = no, 1 = queue, 2 = yes)
(string)do_screencap_human = the screencap status as a word
(int)screencap_size = the screencap size in bytes
(string)screencap_size_human = the screencap size in a formatted way
(string)screencap_uri = the uri to the screencap
(string)uri = the uri to the video
(string)uri_thumb = the uri to the thumb
], . . .
],
(string)next = the uri to the next result page


GET video/$video_virtual_id

Response will contain informations about the video.
duration is expressed in milliseconds
do_screencap can be 0-2.
0 = no screencap
1 = screencap queued
2 = screencap available


GET video/$video_virtual_id/do_screencap

Response will contain just an error code.


GET subscription/create (not impelemented yet)

Response will contain informations about the new subscription.


GET subscription/$subscription_virtual_id (not impelemented yet)

Response will contain informations about the subscription.


GET subscription/$subscription_virtual_id/is_downloaded/$video_virtual_id

Response will contain data set to true or false


GET subscription/$subscription_virtual_id/favourite_add/$video_virtual_id

Response will contain just an error code


GET subscription/$subscription_virtual_id/favourite_remove/$video_virtual_id

Response will contain just an error code


GET subscription/$subscription_virtual_id/favourites (not implemented yet)