All requests to the API require an API key. You can get an API key by signing up .
clip/clip
Get information about an existing clip.
URL
GET https://api.neatclip.com/v1/clip/clip.php
REQUIRED PARAMETERS
api_key
A valid API key.
slug
The slug id of a clip (e.g. "z87dkqj87").
OPTIONAL PARAMETERS
(none)
clip/create
Creates a new clip from an active livestream. Does currently not work for Mixer or Facebook.
URL
GET https://api.neatclip.com/v1/clip/create.php
REQUIRED PARAMETERS
api_key
A valid API key.
stream_url
A stream url. E.g. "https://www.twitch.tv/sodapoppin".
OPTIONAL PARAMETERS
clip_duration
Duration of the clip. Default: "60".
clip_url_return_only
If set to true, returns the url to the created clip only. This is useful for bots like Streamlabs Bot. Default: false.
Are you looking for a way to allow users to create clips directly in the chat? We have a working solution for that here!
stream/clips
Returns clips that were clipped from a specific livestream.
URL
GET https://api.neatclip.com/v1/stream/clips.php
REQUIRED PARAMETERS
api_key
A valid API key.
stream_url
The url of a specific livestream. E.g. "https://www.youtube.com/watch?v=4W65qwLjeHU".
OPTIONAL PARAMETERS
page
The page of the results. Each page returns 100 results. Default: "0".
time
The time limit. Can be "hour", "day", "week", "month", "year" or "all". Default: "all".
sort
The sorting mode. Can be "top", "new", "old" or "random". Default: "new".
streamer/streamer
Returns information about a streamer.
URL
GET https://api.neatclip.com/v1/streamer/streamer.php
REQUIRED PARAMETERS
api_key
A valid API key.
streamer_site
The site of the streamer. E.g. "youtube".
streamer_channel
The (external) channel id of the streamer. E.g. "UCv9Edl_WbtbPeURPtFDo-uA".
OPTIONAL PARAMETERS
(none)
streamer/clips
Returns clips from a streamer.
URL
GET https://api.neatclip.com/v1/streamer/clips.php
REQUIRED PARAMETERS
api_key
A valid API key.
streamer_id
The (internal / NeatClip) id of the streamer. E.g. "102". Query streamer/streamer to
get the streamer id.
OPTIONAL PARAMETERS
page
The page of the results. Each page returns 100 results.
time
The time limit. Can be "hour", "day", "week", "month", "year" or "all". Default: "all".
sort
The sorting mode. Can be "top", "new", "old" or "random". Default: "new".
gallery/clips
Returns clips from the gallery.
URL
GET https://api.neatclip.com/v1/gallery/clips.php
REQUIRED PARAMETERS
api_key
A valid API key.
OPTIONAL PARAMETERS
page
The page of the results. Each page returns 100 results.
time
The time limit. Can be "hour", "day", "week", "month", "year" or "all". Default: "all".
sort
The sorting mode. Can be "top", "new", "old" or "random". Default: "new".