posts

Get popular posts

Changed on

Returns a list of popular posts for a given date and time scale.

Accepts the same v2 and mode parameters as /posts.json.

get/popular.json

Request

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

Query parameters

datestring date

The date to get popular posts for (YYYY-MM-DD format)

scale'day' | 'week' | 'month'

The time scale for popularity

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

A list of popular posts

OR
OR
OR

Changes

    • ▲

      added subschema #1 subschema #2 subschema #3 subschema #4 to the response body oneOf list for the response status

    • ○

      removed subschema #1 subschema #2 subschema #3 subschema #4 from the response body oneOf list for the response status

    • ▲

      added subschema #2 subschema #3 subschema #4 to the response body oneOf list for the response status

    • ○

      removed subschema #2 subschema #3 subschema #4 from the response body oneOf list for the response status