Sign in
post_sets

Search post sets

Changed on

Returns a paginated list of post sets matching the given search criteria.

get/post_sets.json

Request

  • Base URL: https://e621.net
  • URL: https://e621.net/post_sets.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 sets to retrieve per page

post_idinteger

Filter sets containing this post ID

maintainer_idinteger

Filter sets maintained by this user ID

search[name]string

Filter by set name (wildcards supported)

search[shortname]string

Filter by shortname

search[creator_id]integer

Filter by creator user ID

search[creator_name]string

Filter by creator username

search[order]'name' | 'shortname' | 'post_count' | 'created_at' | 'updated_at'

Sort order

Response

A list of post sets

idinteger required

The unique ID of the post set

namestring required

The name of the post set

shortnamestring required

The short name of the post set

descriptionstring

The post set description

is_publicboolean required

Whether the post set is publicly visible

transfer_on_deleteboolean

Whether to transfer favorites on delete

creator_idinteger required

The ID of the set creator

post_idsinteger[] required

Ordered array of post IDs in the set

post_countinteger required

The number of posts in the set

created_atstring date-time required

When the post set was created

updated_atstring date-time required

When the post set was last updated

Changes