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 #
tagson the template list keeps the templates that have every tag you send.tagsandexcludeTagson generate and match choose which templates a call may use.blockedTagsin your settings keeps templates with a tag out of every generate and match call.tagson a saved meme are your own words, and are separate from template tags.