Meme LemurDocs

Feedback

Record what your members did with each meme with POST /v1/feedback, read the counts for a meme or for each template, and export every shown meme with its signals.

Record a signal #

POST /v1/feedback

Every generate, match and render call is stored with the memes it returned, and each of those memes has an id that starts with shown_. Send that id here when a member votes on the meme or posts it. A library meme's id works too.

Field Type What it does
memeId string The id of a meme from a generate, match or render response, or the id of a saved meme. Required.
signal up, down, pick, dismiss or clear What the member did. Required.
actor string, up to 200 characters Your own id for the member. It must not be an email address.
Signal What it records
up, down A vote for or against the meme.
pick The member chose this meme to post.
dismiss The member turned the meme down.
clear Takes back the actor's vote. It needs an actor.

With an actor, each member has one vote on a meme: a new vote replaces that actor's earlier one, and a repeated pick or dismiss counts once. Without an actor, every call counts on its own.

Shell
curl https://api.memelemur.com/v1/feedback \
  -H "Authorization: Bearer $MEMELEMUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"memeId": "shown_os3512168bmpdyq3", "signal": "pick", "actor": "member-42"}'

The response has the meme's counts after the signal:

JSON
{
  "meme": {
    "id": "shown_os3512168bmpdyq3",
    "templateId": "tpl_kwhxl4k7tqhc25ds",
    "picks": 1,
    "dismissals": 0,
    "upVotes": 1,
    "downVotes": 0,
    "netVotes": 1
  }
}

Errors #

Status When
400 signal is not one of the five, actor has an @ in it, or clear was sent with no actor.
404 Your team has no shown meme and no saved meme with that id.

What a vote changes #

A vote changes what later generate and match calls return to your team.

A template is left out of a call when more of your members voted its memes down than voted them up or picked them. Only the memes made for the same prompt or phrase count, or for one close to it: other casing or punctuation, a small edit, or a rewording. It is the template that is left out, whatever captions the meme had. votedDown in the response says how many templates were.

The template comes back when the member takes the vote back with clear, when as many members vote one of its memes up or pick it, and after 30 days. A member counts once however often they voted. That is what actor is for here: without one, every vote counts as another person.

When match chooses the pictures for a phrase, the votes and picks on that phrase, or one close to it, are shown to the model that chooses.

Votes on memes made for other prompts and phrases never leave a template out. They move it a few places in the order templates are tried, up for votes in favor and down for votes against, and one such vote moves nothing.

A pick also counts a little against the memes it passed over: the ones shown above the picked meme and the one right below it, unless they are on the same template or have a vote or pick of their own. Each weighs a quarter of a down vote in that order, and never leaves a template out.

A meme from the pool that your members voted down is not returned to your team again, for any prompt.

Only your own team's votes do any of this. When every template that suits a prompt or phrase was voted down, the call returns fewer memes, or none, and does not put the words on a template that does not suit them.

Read one meme's counts #

GET /v1/feedback/memes/:id

Shell
curl https://api.memelemur.com/v1/feedback/memes/shown_os3512168bmpdyq3 \
  -H "Authorization: Bearer $MEMELEMUR_KEY"
JSON
{
  "meme": {
    "id": "shown_os3512168bmpdyq3",
    "templateId": "tpl_kwhxl4k7tqhc25ds",
    "picks": 1,
    "dismissals": 0,
    "upVotes": 1,
    "downVotes": 0,
    "netVotes": 1
  }
}

netVotes is upVotes minus downVotes. It returns 404 when your team has no meme with that id.

Read the counts for each template #

GET /v1/feedback/templates

Returns the same counts added up for each template, the most picked first. shown is how many times a call returned a meme on the template, and render calls count.

Query What it does
limit 1 to 500. The default is 100.
offset How many to skip. The default is 0.
Shell
curl "https://api.memelemur.com/v1/feedback/templates?limit=2" \
  -H "Authorization: Bearer $MEMELEMUR_KEY"
JSON
{
  "templates": [
    {
      "templateId": "tpl_kwhxl4k7tqhc25ds",
      "templateName": "Drakeposting",
      "shown": 2,
      "picks": 1,
      "dismissals": 0,
      "upVotes": 1,
      "downVotes": 0,
      "netVotes": 1
    },
    {
      "templateId": "tpl_jlzin2j8osodldsx",
      "templateName": "Futurama Fry",
      "shown": 1,
      "picks": 0,
      "dismissals": 0,
      "upVotes": 0,
      "downVotes": 0,
      "netVotes": 0
    }
  ]
}

A signal on a library meme is counted under that meme's template. A template can have votes and a shown of 0 for that reason.

Export shown memes #

GET /v1/feedback/export

Returns every meme your team was shown, newest first, with the call that made it and the signals it got. Use it to see which prompts and templates work for your audience, or as training data. A meme nobody gave a signal on is a row with zero counts.

Query What it does
since An ISO 8601 time with an offset, such as 2026-10-01T00:00:00Z. Keeps memes shown at or after it.
limit 1 to 500. The default is 100.
cursor The nextCursor of the page before, to get the next page.
Shell
curl "https://api.memelemur.com/v1/feedback/export?since=2026-10-01T00:00:00Z&limit=1" \
  -H "Authorization: Bearer $MEMELEMUR_KEY"
JSON
{
  "rows": [
    {
      "id": "shown_os3512168bmpdyq3",
      "generationId": "gen_lm3cb7x1cxp14mna",
      "kind": "generate",
      "input": "when the deploy goes out at 4:55pm on a Friday",
      "context": null,
      "position": 0,
      "templateId": "tpl_kwhxl4k7tqhc25ds",
      "templateName": "Drakeposting",
      "captions": ["Deploying on Monday morning", "Deploying at 4:55pm on a Friday"],
      "key": "renders/tnt_hc0n3r4w54a35prf/af658530e5411f8f682cd40ffc808c1bc5e172dfd9a80e577d2c28dd7a2dc3ca.jpg",
      "source": "generated",
      "usage": {
        "inputTokens": 2210,
        "outputTokens": 187,
        "cacheReadTokens": 0,
        "cacheWriteTokens": 0,
        "model": "claude-haiku-4-5",
        "usedFallback": false,
        "paidBy": "platform"
      },
      "price": { "kind": "standard", "micros": 9900, "creditMicros": 9900 },
      "elapsedMs": 2840,
      "modelMs": 2310,
      "shownAt": "2026-10-02T00:57:44.277Z",
      "signals": { "picks": 1, "dismissals": 0, "upVotes": 1, "downVotes": 0, "netVotes": 1 },
      "url": "https://api.memelemur.com/i/renders/tnt_hc0n3r4w54a35prf/af658530e5411f8f682cd40ffc808c1bc5e172dfd9a80e577d2c28dd7a2dc3ca.jpg"
    }
  ],
  "nextCursor": "2026-10-02T00:57:44.277Z~shown_os3512168bmpdyq3"
}
Field What it is
kind generate, match or render.
input The prompt or the phrase. Null for a render.
context The context the call sent, or null.
position Where the meme came in its call's list, from 0.
source generated or reused. Null for a render.
usage What the caption model used for the call: the tokens, the model, whether the fallback model answered, and whether the platform or the team key paid. Every meme of one call has the same usage. Left out when no model replied.
price What the call was charged, once for the call and not once for each meme. kind is standard, ownKey, animated or none, micros is the amount in millionths of a US dollar, and creditMicros is how much of it prepaid credit covered. A render has none and 0.
elapsedMs How long the call took.
modelMs How long the call waited for the caption model. Left out when no model was asked.
space The space the meme was shown in. Left out for a meme shown in no space.
channel Where the call came from: api for an API key, publishable for the meme picker or button, slack, discord, or signedIn for the Jungle Gym. Left out for a call made before October 2026.
audience The space's audienceTags when the call was made. Left out when it had none.
signals The counts, as the other feedback routes return them.

nextCursor is null on the last page. Feedback can arrive after a meme was shown, so an export that picks up where an earlier one stopped should overlap it and replace the rows it already has. A call that returned no memes has no row.

A cursor this route did not return gives 400.

Feedback in a space #

A call made with the Memelemur-Space header is stored under that space, with the memes it returned. With the header, the template counts and the export return that space's counts and rows. Without it they cover the whole team, and an export row for a meme shown in a space has a space field.

Recording a signal and reading one meme's counts need no header. A signal is stored under the space of the meme it is about.