Meme Generation API

Meme Build has a public api available. This is a brand new piece that was opened up so there will be more to come. See below for valid endpoints. This api is built on REST principles. We do require an api key. Right now api keys are given out at request. Please contact us here for access .

Authentication

There are two methods of authentication. You can pass your api as a query param or as the API-KEY in the headers of the request.

Preferred Method

HEADERS API-KEY {YourApiKey}

Alternative Method

http://memebuild.com/api/1.0/{request}?api-key={YourApiKey}

Get Recent Memes

This endpoint returns all recently generated memes.

GET http://memebuild.com/api/1.0/getRecentMemes
Parameter Default Description
limit 20 Pass any number between 1-100.

Example Request

http://memebuild.com/api/1.0/getRecentMemes?limit=25

Get Default Memes

This endpoint returns all default memes.

GET http://memebuild.com/api/1.0/getDefaultMemes
Parameter Default Description
limit 25 Pass any number between 1-100.

Example Request

http://memebuild.com/api/1.0/getDefaultMemes?limit=25

Generate Meme

This endpoint generates a meme and returns back a base64 image blob. Text will be centered across the top and bottom.

This request requires all params be sent as a valid JSON payload.

POST http://memebuild.com/api/1.0/generateMeme
Parameter Default Description
topText Required The top text on the generated meme.
bottomText Required The bottom text on the generated meme.
imgUrl Required Tell us where to grab the image from.

Example Payload

{
    "topText":"Hey!"
    "bottomText":"I'm using the API!",
    "imgUrl":"https://s3-us-west-2.amazonaws.com/memebuilder/default/obama.jpg"
}

Example Response

data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAfQAAAH0CAYAAADL1t+K...