Free meme template API and widget
Everything on this site is also a set of plain JSON files. No key, no signup, no rate limit beyond GitHub Pages' own, and
Access-Control-Allow-Origin: * so you can call it from a browser. The files are rebuilt on every deploy and at least weekly.
Endpoints
| File | What's in it |
|---|---|
templates.json | Every described template: name, other names, what it looks like, how it's used, text slots, examples, tags, source, Imgflip id and links. |
templates/<slug>.json | One template. |
search-index.json | The compact file this site's own search runs on. |
trending.json | This week's most-captioned templates on Imgflip, in order, with movement since the previous snapshot. |
meta.json | Counts and the dates the data was built and last refreshed. |
Example
curl https://theguysaccount.github.io/meme-search-engine/api/v1/templates/0-days-without.json
// in a browser
const all = await (await fetch("https://theguysaccount.github.io/meme-search-engine/api/v1/templates.json")).json();
const withCats = all.templates.filter(t => t.tags.includes("cat"));
Search in your own app
The ranking code is one dependency-free ES module. Load it with the index and search on the device:
import { buildIndex, search } from "https://theguysaccount.github.io/meme-search-engine/assets/core.js";
const data = await (await fetch("https://theguysaccount.github.io/meme-search-engine/api/v1/templates.json")).json();
const index = buildIndex(data.templates);
search(index, "guy looking back at another girl")[0].record.name;
Embed the search box
Paste this where you want a "what's that meme called?" box. Results open on this site in a new tab.
<iframe src="https://theguysaccount.github.io/meme-search-engine/embed/" title="Describe a meme, get its name" width="100%" height="420" style="border:1px solid #ddd;border-radius:12px" loading="lazy"></iframe>
Terms
- Descriptions, tags and examples are written for this project and licensed CC BY 4.0: use them anywhere, with a link back to this site.
- Template names, ids and popularity come from Imgflip's public API. Images are not part of this API: link to Imgflip for those and follow its terms.
- Version 1 files only gain fields; a breaking change would get a new
/v2/path.