Skip to navigation
API ReferenceMemegen

List Memes

The gallery: Recent (sort=newest, the default) or Popular (sort=top, most upvoted first, newest breaking ties), optionally within a window. mine=true is My memes, a signed-in session’s own; a key acts for the workspace and has none, so it is refused (403 forbidden) and filters by authorId instead.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

qstringOptional

Search memes by their captions and their template’s name. Every word must appear in one of those fields; case and accents are ignored; at most 100 characters and 8 words. See Searching under Errors and pagination.

searchstringOptionalDeprecated

The older name for q, matched the same way. Deprecated; q wins when both are sent.

minebooleanOptional

true lists only the signed-in person’s memes. A key is refused with 403 forbidden: use authorId.

authorIdstringOptional
templateIdstringOptional
sortenumOptional
Allowed values:
windowenumOptional

With sort=top only: how far back Popular looks. Left out, all time. Ignored for newest; an unknown window is 422.

Allowed values:
limitintegerOptional
cursorstringOptional

Response

This endpoint returns an object.
datalist of objects
hasMoreboolean
nextCursorstringOptional

Errors

401
Unauthorized Error
402
Subscription Required Error
403
Forbidden Error
422
Validation Error
429
Too Many Requests Error