Sign in
uploads

Get a list of uploads

Returns a list of uploads based on search criteria.

get/uploads.json

Request

  • Base URL: https://e621.net
  • URL: https://e621.net/uploads.json
  • Auth: none declared

Query parameters

pageinteger

The page number to retrieve

limitinteger

The number of uploads to retrieve per page

search[uploader_name]string

Filter uploads by uploader's username

search[post_tags_match]string

Filter uploads by post tags

search[source_matches]string

Filter uploads by source

search[status]'completed' | 'processing' | 'pending' | 'duplicate' | 'error'

Filter uploads by status

search[created_at]string

Filter by the creation date of the upload

search[updated_at]string

Filter by the last update date of the upload

Response

A list of uploads matching the search criteria

idinteger required

The unique ID of the upload

sourcestring required

The source URL of the upload, if provided

rating's' | 'q' | 'e' required

The rating of the upload (e.g., safe, questionable, explicit)

uploader_idinteger required

The ID of the user who uploaded the content

tag_stringstring

The tags associated with the upload

status'completed' | 'processing' | 'pending' | 'duplicate' | 'error' required

The current status of the upload

backtracestring nullable

Any backtrace or error details if applicable

post_idinteger nullable

The ID of the post generated by this upload, if applicable

md5_confirmationstring nullable

The MD5 confirmation hash for the upload, if applicable

created_atstring date-time required

The timestamp when the upload was created

updated_atstring date-time required

The timestamp when the upload was last updated

parent_idinteger nullable

The ID of the parent post, if applicable

md5string

The MD5 hash of the file

file_extstring required

The file extension (e.g., jpg, png, webm)

file_sizeinteger required

The size of the file in bytes

image_widthinteger required

The width of the uploaded image in pixels

image_heightinteger required

The height of the uploaded image in pixels

descriptionstring

A description of the uploaded content

uploader_namestring required

The username of the uploader

Changes

No recorded changes to this operation across all 13 revisions of this API.