Imgflip API

Gets an array of popular memes that may be captioned with this API. The size of this array and the order of memes may change at any time. When this description was written, it returned 100 memes ordered by how many times they were captioned in the last 30 days. Additional properties other than those listed below may be added in the future without warning, so do not assume the JSON structure of each meme will never have new properties.

{
   "success": true,
   "data": {
      "memes": [
         {
            "id": "61579",
            "name": "One Does Not Simply",
            "url": "https://i.imgflip.com/1bij.jpg",
            "width": 568,
            "height": 335,
            "box_count": 2
         },
         {
            "id": "101470",
            "name": "Ancient Aliens",
            "url": "https://i.imgflip.com/26am.jpg",
            "width": 500,
            "height": 437,
            "box_count": 2
         }
         // probably a lot more memes here..
      ]
   }
}
		

Add a caption to an Imgflip meme template. Images created with this API will be publicly accessible by anyone through the url in the response - there is no "private" option. This does not mean these memes will be posted publicly though, one still needs to know the exact URL to find the image. If the image hangs around on Imgflip servers for a while and gets very few views (direct image views and image page views both count), it will be auto-deleted to save space.

For a real working example of the API, check out this hubot script (written in coffeescript). That script is open source, so feel free to use that set of regexes as a starting place. IMPORTANT NOTE: If you plan to use the API for anything other than testing, you should create your own Imgflip account and use that instead of the default imgflip_hubot account, because that account may be limited as soon as you send a non-trivial number of requests, and then your script wouldn't be able to make memes anymore, and everyone would be sad.

[
   {
      "text": "One does not simply",
      "x": 10,
      "y": 10,
      "width": 548,
      "height": 100,
      "color": "#ffffff",
      "outline_color": "#000000"
   },
   {
      "text": "Make custom memes on the web via imgflip API",
      "x": 10,
      "y": 225,
      "width": 548,
      "height": 100,
      "color": "#ffffff",
      "outline_color": "#000000"
   }
]
					

{
   "success": true,
   "data": {
      "url": "https://i.imgflip.com/123abc.jpg",
      "page_url": "https://imgflip.com/i/123abc"
   }
}
		

{
   "success" => false,
   "error_message" => "Some hopefully-useful statement about why it failed"
}
		

Add a caption to an Imgflip animated GIF template. Mostly identical to /caption_image above, except the older text0/text1 format is not supported (use boxes instead).

/caption_gif requires API Premium. First 50 creations per month are included, then $0.02 per creation.

Search for meme templates that can be captioned with the /caption_image endpoint. This allows you to give users a search input to find which of the 1M+ templates from the Imgflip database they want to use. If you plan to use search-as-you-type and send multiple searches per user, you may want to use caching on your frontend. Do not cache the results globally for all users on your backend though, as memes are constantly updated.

IMPORTANT NOTE: The Imgflip database is user-generated content, NOT curated content. We have some simple mechanisms to help prevent spam and inappropriate content, but you may want to filter based on your own criteria such as language or number of captions (aka popularity).

Searching memes requires API Premium. First 200 searches per month are included, then $0.005 per search.

{
   "success": true,
   "data": {
      "memes": [
      {
         "id": "61579",
         "name": "One Does Not Simply",
         "url": "https://i.imgflip.com/1bij.jpg",
         "width": 568,
         "height": 335,
         "box_count": 2,
         "captions": 1750 // estimated number of all-time captions of this meme, rounded
      },
      // probably a lot more memes here..
   ]
   }
}
		

Get a meme by ID. Same return format as /search_memes. Helpful if your users want to upload templates to Imgflip and then give you the ID directly to use in your app/website/bot. Currently Premium only.

{
   "success": true,
   "data": {
     "meme": {
       "id": "61579",
       "name": "One Does Not Simply",
       "url": "https://i.imgflip.com/1bij.jpg",
       "width": 568,
       "height": 335,
       "box_count": 2,
       "captions": 1750 // estimated number of all-time captions of this meme, rounded
     }
   }
}
		

Automatically caption one of the top 2,048 memes based only on the input text. This allows someone to simply type the phrase they want turned into a meme, and Imgflip magically picks the correct meme and adds their text. Automeme uses a deep neural network trained on millions of public Imgflip memes. Keep in mind that some memes work much better than others for this style of creation, namely shorter simpler memes. Memes with many text locations and no discernible patterns are less likely to work well.

To see how it works, try it yourself at imgflip.com/automeme. This is also what powers the Imgflip Slack App where you can type phrases like "/imgflip nobody got time for reading long API docs".

Automeme requires API Premium. First 50 creations per month are included, then $0.02 per creation.

Generates a fresh meme from scratch using either OpenAI GPT or Imgflip's own deep neural network trained on millions of public memes.

IMPORTANT NOTE (only if using classic model): The classic Imgflip AI is trained on all public user-generated content, so it is NOT censored or curated in any way, and therefore may contain vulgarities or other potentially unsuitable content. If this doesn't fit your use case, you may want to filter the output based on language.

To see how it works, try it yourself at imgflip.com/ai-meme.

AI Meme requires API Premium. First 50 creations per month are included, then $0.02 per creation.

{
   "success": true,
   "data": {
      "url": "https://i.imgflip.com/123abc.jpg",
      "page_url": "https://imgflip.com/i/123abc",
      "template_id": 89370399,
      "texts": ["you can't get caught to sing a conversation", "if you don't have any money"]
   }
}