An API to programmatically generate memes based solely on requested URLs.
Buy me a coffee to help keep this site running!
The API is stateless so URLs contain all the information necessary to generate meme images. For example, https://api.memegen.link/images/buzz/memes/memes_everywhere.png produces:
Clients can request .jpg
instead of .png
for smaller files or .gif
if an animated background is available:
Format | Example |
---|---|
PNG | /images/ds/small_file/high_quality.png |
JPEG | /images/ds/high_quality/small_file.jpg |
GIF | /images/oprah/you_get/animated_text.gif |
Images can be scaled to a specific width or height using the width=<int>
and height=<int>
query parameters. If both are provided (width=<int>&height=<int>
), the image will be padded to the exact dimensions.
For example, https://api.memegen.link/images/both/width_or_height/why_not_both~q.png?height=350&width=600 produces:
In URLs, spaces can be inserted using underscores or dashes:
- underscore (
_
) → space ( - dash (
-
) → space ( - 2 underscores (
__
) → underscore (_
) - 2 dashes (
--
) → dash (-
) - tilde + N (
~n
) → newline character
Reserved URL characters can be included using escape patterns:
- tilde + Q (
~q
) → question mark (?
) - tilde + A (
~a
) → ampersand (&
) - tilde + P (
~p
) → percentage (%
) - tilde + H (
~h
) → hashtag/pound (#
) - tilde + S (
~s
) → slash (/
) - tilde + B (
~b
) → backslash (\
) - tilde + L (
~l
) → less-than sign (<
) - tilde + G (
~g
) → greater-than sign (>
) - 2 single quotes (
''
) → double quote ("
)
For example, https://api.memegen.link/images/doge/~hspecial_characters~q/underscore__-dash--.png produces:
All of the POST
endpoints will return image URLs with speical characters replaced with these alternatives.
The list of predefined meme templates is available here: https://api.memegen.link/templates/
Some memes come in multiple forms, which can be selected using the style=<str>
query parameter.
For example, the https://api.memegen.link/templates/ds/ template provides these styles:
/images/ds.png |
/images/ds.png?style=maga |
---|---|
The style=<str>
query parameter can also be an image URL to overlay on the default background image.
For example, https://api.memegen.link/images/pigeon/Engineer/_/Is_this_Photoshop~q.png?style=https://i.imgur.com/W0NXFpQ.png produces:
You can also use your own image URL as the background.
For example, https://api.memegen.link/images/custom/_/my_background.png?background=http://www.gstatic.com/webp/gallery/1.png produces: