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.
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:
{
"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
curl https://api.memelemur.com/v1/feedback/memes/shown_os3512168bmpdyq3 \
-H "Authorization: Bearer $MEMELEMUR_KEY"{
"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. |
curl "https://api.memelemur.com/v1/feedback/templates?limit=2" \
-H "Authorization: Bearer $MEMELEMUR_KEY"{
"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. |
curl "https://api.memelemur.com/v1/feedback/export?since=2026-10-01T00:00:00Z&limit=1" \
-H "Authorization: Bearer $MEMELEMUR_KEY"{
"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.