/media/upload

You can upload image/gif, video/mp4, and video/webm media by sending a POST multipart/form-data request.

Use your Authentication Key for added benefits. Read Authentication Key for full benefits.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Request
curl \
  -H "Gifs-API-Key: gifs56d63999f0f34" \
  -F "file=@/media/gifs/awesome.gif" \
  -F "title=The most awesome gif eva" \
  -F "tags=awesome, cool, fun, gnarly" \
  https://api.gifs.com/media/upload
Results
{
 "success":{
    "page": "https://gifs.com/gif/2k9BMv",
    "files": {
        "gif": "https://j.gifs.com/2k9BMv.gif",
        "jpg": "https://j.gifs.com/2k9BMv.jpg",
        "mp4": "https://j.gifs.com/2k9BMv.mp4",
        "webm": "https://j.gifs.com/2k9BMv.webm"
    },
    "oembed": "https://gifs.com/oembed/2k9BMv",
    "embed": "<iframe src='https://gifs.com/embed/2k9BMv' frameborder='0' scrolling='no' width='640' height='360' style='-webkit-backface-visibility: hidden;-webkit-transform: scale(1);' ></iframe>",
    "meta": {
        "duration": "4.104s",
        "frames": "123",
        "height": "360",
        "width": "640"
    }
 }
}
{
    "errors": {
        "message": "We've encountered an unexpected issue, please try again."
    }
}
Body Params
file
required

The file being uploaded

string

The title of the media

tags
array of strings

The tags relating the the media

tags
boolean

If the media is not safe for work

string

twitter, reddit, instagram, or a custom URL

string

The username for social media sites

string

The url if site != social media

Language
Credentials
Header
LoadingLoading…