Sign in
artists

Get a list of artists

Changed on

Returns a list of artists based on search criteria.

get/artists.json

Request

  • Base URL: https://e621.net
  • URL: https://e621.net/artists.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 to retrieve

limitinteger

The number of artists to retrieve per page

search[name]string

Filter by exact artist name

search[any_name_matches]string

Filter by partial name match (searches name, other names, and group name)

search[any_name_or_url_matches]string

Filter by name or URL match

search[url_matches]string

Filter by URL match

search[group_name]string

Filter by group name

search[creator_name]string

Filter by the creator's username

search[creator_id]integer

Filter by the creator's user ID

search[linked_user_name]string

Filter by the linked user's username

search[linked_user_id]integer

Filter by the linked user's ID

search[is_linked]boolean

Filter by whether a user is linked

search[has_tag]boolean

Filter by whether the artist has a tag with posts

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

Sort order

Response

A list of artists matching the search criteria

idinteger required

The unique ID of the artist

namestring required

The artist's tag name

creator_idinteger required

The ID of the user who created the artist entry

is_activeboolean required

Whether the artist is active

is_lockedboolean required

Whether the artist page is locked for editing

other_namesstring[] required

Alternative names for the artist

group_namestring required

The name of the artist group or circle

linked_user_idinteger nullable required

The ID of the linked user account

created_atstring date-time required

The time when the artist was created

updated_atstring date-time required

The last time the artist was updated

Changes