Meme Generation API

Meme Build has a public api available. See below for valid endpoints. This api is built on REST principles.

We do require an api key. Please create an account in order to generate an API key.

Create Account

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}

Generate Meme

This endpoint generates a meme and returns back url to access the image. Text will be centered across the top and bottom.
If the image is not square, the image will be cropped.

This request requires all params be sent as multipart form data.

POST http://memebuild.com/api/1.0/generateMeme
Parameter Description
topText The top text on the generated meme.
bottomText The bottom text on the generated meme.
image Image file for the meme
imageUrl URL for file for the meme

Must provide either image or imageUrl.

Example Payload

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

Example Response

{
    "url": "https://s3-us-west-2.amazonaws.com/memebuilder/uploads/1615220966_604650e6596b4.jpg"
}

Get Your Recent Memes

This endpoint returns your recently generated memes.

GET http://memebuild.com/api/1.0/myRecentMemes?limit=25&search=lol
Parameter Default Description
limit 20 Pass any number between 1-100.

Example Request

http://memebuild.com/api/1.0/myRecentMemes?limit=25&search=lol