Updated August 2026: This guide reflects the current Supermeme API. We originally published this URL in December 2022 when API access first launched.
The Supermeme API turns a text prompt into finished meme images, editable caption-and-template pairs, or template search results. You can send a sentence such as "When the tests finally pass" without choosing a template or writing a caption first.
API access is included with every paid plan. Create a key in Developer Settings, store it on your server, and send it as a Bearer token with each request. The complete API documentation covers every parameter, response, and error.
Quickstart: generate a finished meme from text
The finished-meme endpoint returns captioned images that are ready to display. Start with a count of one while you test the integration.
export SUPERMEME_API_KEY='paste-your-api-key-here'
curl --request POST \
--url https://app.supermeme.ai/api/v2/meme/image \
--header "Authorization: Bearer ${SUPERMEME_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"text":"When the tests finally pass","count":1}'
Read the JSON response
{
"memes": ["https://.../generated-meme-1.png"],
"expiresAt": "2026-08-27T13:00:00.000Z"
}
The memes array contains signed PNG URLs. Those URLs expire after one hour, so download or copy the images to your own storage when the product needs permanent assets. The expiresAt value gives you the deadline for that response.
Create your API key, or read the full quickstart before you integrate.
Choose the right meme API endpoint
The API supports four output types. Pick the response that matches the part of the meme workflow your product owns.
| Product need | Endpoint | Response |
|---|---|---|
| Finished captioned memes | POST /api/v2/meme/image |
Signed PNG URLs with the caption rendered into each image |
| Editable captions and templates | POST /api/v1/meme/text |
Generated captions paired with clean template URLs |
| Template search | GET /api/v1/search |
Up to 20 matching template paths |
| Minimalist illustrations | POST /api/v1/minimalist-visual |
Signed illustration URLs for slides, documents, or social posts |
Most integrations should start with POST /api/v2/meme/image. The editable endpoint fits products that apply their own caption styling or let a person choose the final template. Template search works when you need discovery without generation.
What can you build with a meme API?
A messaging bot can turn a conversation into a reaction meme. A social-publishing tool can generate options alongside a post draft. An internal app can add memes to announcements, learning material, or team updates. Customer-facing products can offer meme creation without building template ranking and image rendering from scratch.
You can also use the search endpoint to build a template picker. It accepts natural-language queries such as an emotion or situation, so users do not have to remember a template name.
Meme API or MCP?
Use the REST API when you are adding meme generation to an application, bot, or backend. Your server controls the request, stores the API key, and decides what to do with each response.
Use the Supermeme MCP server when an MCP-compatible assistant needs meme tools inside a conversation. The MCP connection uses OAuth instead of a REST API key. It lets assistants search templates and render captions without asking the user to leave the chat.
Both options require a paid plan. The API gives software teams an HTTP interface; MCP gives AI assistants a conversational tool connection.
Authentication, quotas, and production notes
Keep the API key out of browser JavaScript, mobile bundles, and public repositories. Call Supermeme from your backend and store the key as a secret. Generating a new key in Developer Settings invalidates the previous one.
Each plan has a monthly request allowance that resets with its billing period. The API does not return rate-limit headers, so check your current usage in Developer Settings and compare the current allowances on the pricing page. A request made after the allowance is exhausted returns HTTP 429 with the error type quota_exceeded; stop and wait until the quota resets before retrying.
Generation calls run text and image work, so give them an application-level timeout. Retry server errors with backoff, but change the request before retrying validation or authentication errors. The production checklist covers storage, retries, and logging.
Meme API FAQ
Can I generate a finished meme from text with an API?
Yes. Send text to POST /api/v2/meme/image. Supermeme selects relevant templates, writes captions, renders the images, and returns signed URLs.
Do I need to choose a meme template first?
No. The finished-meme endpoint can interpret the text and choose templates. Use GET /api/v1/search when your product needs a separate template-selection step.
Is the Supermeme API free?
The web app has a free allowance, but API keys require a paid plan. Every paid plan includes a monthly API quota and access to the MCP server. The pricing page lists the current allowances.
Do generated meme URLs expire?
Finished meme and minimalist-visual URLs expire after one hour. Editable meme and template-search responses use public template URLs that do not have the one-hour generated-image expiry.
Should I use the API or the MCP server?
Use the API for an app or backend. Use MCP when Claude, ChatGPT, Cursor, or another MCP client should search and create memes inside a conversation.
Get an API key
Open Developer Settings to create a key. If the account does not have API access, the setup flow will show the plans that include it. Once you have a key, run the one-result request above and then move to the complete API reference.
Building for an AI assistant instead? Set up the Supermeme MCP server.