Sign in
uploads

Get a list of uploads

Changed on

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: 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 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]string

Matched against the upload status with SQL LIKE, where * is the wildcard. completed, processing and pending match exactly. The duplicate and error statuses carry a suffix (duplicate: <post_id>, error: <message>), so matching those needs a wildcard, as in duplicate*.

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 post (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

statusstring required

The current status of the upload. May include details like "duplicate: 12345" or "error: message"

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

  • 7eb984be63caRevision changes
    • ▲

      removed the enum value completed from the query request parameter search[status]

    • ▲

      removed the enum value duplicate from the query request parameter search[status]

    • ▲

      removed the enum value error from the query request parameter search[status]

    • ▲

      removed the enum value pending from the query request parameter search[status]

    • ▲

      removed the enum value processing from the query request parameter search[status]

  • d1d05ce5fa8fRevision changes
    • ○

      removed the completed enum value from the / response property for the response status

    • ○

      removed the duplicate enum value from the / response property for the response status

    • ○

      removed the error enum value from the / response property for the response status

    • ○

      removed the pending enum value from the / response property for the response status

    • ○

      removed the processing enum value from the / response property for the response status