Sign in
posts

Get a list of posts

Changed on

Returns a list of posts filtered by tags.

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

get/posts.json

Request

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

Query parameters

pageinteger

The page number for pagination

limitinteger

The number of posts to retrieve per page

tagsstring

Filter posts by 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

A list of posts matching the search criteria

OR
OR
OR

Changes

  • 7eb984be63caRevision 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

  • eddd14ade7b6Revision changes
    • ▲

      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