Sign in
posts

Get a random post

Changed on

Returns a single random post matching the tags search.

When v2=true, the response uses the v2 Post format selected by mode (basic default, extended, or thumbnail). Otherwise the legacy format wrapped in { "post": {...} } is returned.

get/posts/random.json

Request

  • Base URL: https://e621.net
  • URL: https://e621.net/posts/random.json
  • Auth: one of:
    • none
    • HTTP basic
    • API key in query parameter login and API key in query parameter api_key

Query parameters

tagsstring

Restrict the random pick to posts matching these tags

v2'true'

If "true", the response uses the v2 Post format. Otherwise the legacy format is returned.

mode'basic' | 'extended' | 'thumbnail' | 'thumbnails'

Selects the v2 Post payload shape. Only effective when v2=true. Default basic.

Response

Successful response containing a random post

OR
OR
OR

Changes