Meme LemurDocs

Tags

GET /v1/tags lists the tags of the templates your team can use, with how many templates have each and which ones your settings block.

List the tags #

GET /v1/tags

Returns every tag you can filter or block by, the most used first. Use it to offer tags in a search screen, or to offer the sensitive ones in a moderation screen.

Query What it does
group Keeps one group: format, tone, subject or sensitive.
kind Which templates templates counts: still (the default) or animated.
Shell
curl "https://api.memelemur.com/v1/tags?group=sensitive" \
  -H "Authorization: Bearer $MEMELEMUR_KEY"
JSON
{
  "tags": [
    { "tag": "violence", "group": "sensitive", "sensitive": true, "templates": 16, "blocked": false },
    { "tag": "politician", "group": "sensitive", "sensitive": true, "templates": 12, "blocked": false },
    { "tag": "profanity", "group": "sensitive", "sensitive": true, "templates": 8, "blocked": true },
    { "tag": "political", "group": "sensitive", "sensitive": true, "templates": 2, "blocked": true }
  ]
}
Field What it is
tag The tag, in lowercase.
group format, tone, subject or sensitive. Null for a tag that only your own uploads have.
sensitive True for a tag in the sensitive group.
templates How many of the templates your team can use have the tag.
blocked Whether blockedTags in your settings has the tag.

The shared templates are tagged from one fixed list, and each tag in it is in one group. The sensitive tags are the ones a team blocks to keep a kind of template out, such as profanity, political or violence. Every tag in the list is returned, including one that no template has yet, so you can block it ahead of time.

With the Memelemur-Space header, blocked also counts the tags that space adds to blockedTags.

Where tags are used #

  • tags on the template list keeps the templates that have every tag you send.
  • tags and excludeTags on generate and match choose which templates a call may use.
  • blockedTags in your settings keeps templates with a tag out of every generate and match call.
  • tags on a saved meme are your own words, and are separate from template tags.