Describe a Meme

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

FileWhat's in it
templates.jsonEvery described template: name, other names, what it looks like, how it's used, text slots, examples, tags, source, Imgflip id and links.
templates/<slug>.jsonOne template.
search-index.jsonThe compact file this site's own search runs on.
trending.jsonThis week's most-captioned templates on Imgflip, in order, with movement since the previous snapshot.
meta.jsonCounts 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