Developer API

Trending images (Tenor v2-compatible)

The trending images, in Tenor's featured format. Counts against your quota (the free 100 calls a day, else your packs); only a 2xx answer counts — any other answer gives the call back.

get/v2/featured

Request

  • Base URL: https://api.memestack.ai
  • URL: https://api.memestack.ai/v2/featured
  • Auth: one of:
    • API key in query parameter key
    • API key in header X-API-Key

Query parameters

limitinteger

Results per page (1-50).

posstring

The next of the previous page (an offset, at most 1000).

contentfilter'off' | 'low' | 'medium' | 'high'

off = everything; low/medium/high = the safe set. Missing = the safe set (Tenor's default was off).

media_filterstring

Comma-separated MEDIA_OBJECT keys to return (gif, tinygif, nanogif, mediumgif, preview, png, jpg, webp); none = all. Video keys never exist.

searchfilterstring

sticker answers no results (MemeStack has no stickers) and spends no call.

client_keystring

Your integration's name, recorded in the usage statistics.

localestring

Accepted and ignored: search understands queries in any language.

countrystring

Accepted and ignored.

ar_rangestring

Accepted and ignored.

randomboolean

Accepted and ignored.

content'safe' | 'all'

MemeStack: wins over contentfilter.

tagsstring

MemeStack: comma-separated tag slugs, all required.

categorystring

MemeStack: a category slug (see /v2/categories path).

in_text_onlyboolean

MemeStack: search only the text printed inside images.

has_chart_databoolean

MemeStack: only charts with known chart facts.

chart_sourcestring

MemeStack: the chart publisher.

data_frominteger

MemeStack: charts whose shown period ends at or after this year.

data_tointeger

MemeStack: charts whose shown period starts at or before this year.

regionstring

MemeStack: charts covering this region.

is_generatedboolean

MemeStack: only AI-generated images.

closest'none'

MemeStack: none = strong matches only.

autocorrectboolean

MemeStack: false = no spelling correction.

publisher_onlyboolean

MemeStack: true = only charts imported from a licence-clean publisher (Our World in Data, USDA ERS, Eurostat, EEA). Missing (or empty) = your key's default: false, unless the key's publisher_only_default is on (PATCH /v1/developer/keys/{id}); false overrides that default. The answer's memestack.publisher_only says which applied. Any value other than true or false is 400 INVALID_PUBLISHER_ONLY.

Response

Results.

nextstring

Pass as pos for the next page; empty when there is none.

Example response

{
  "results": [
    {
      "memestack": {
        "rights": {
          "source": "publisher",
          "publisher": {
            "key": "usda_ers",
            "name": "USDA Economic Research Service"
          },
          "license": "US-PD",
          "license_name": "Public domain (U.S. federal work)",
          "license_url": "https://www.usa.gov/government-copyright",
          "attribution": "Source: USDA Economic Research Service",
          "attribution_required": true,
          "commercial_use": "yes",
          "note": null
        }
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.