Favorites

Get Favorites

GET https://e621.net/favorites.json

Authorization Required If user_id is not specified

Moderator+ Required If user_id is blocked, or has privacy mode on

The authenticated user bypasses privacy mode checks, but not block checks (concerning the authenticated user's favorites).

Query Parameters

Name	Type	Description
user_id	Number	The ID of the user whose favorites to get.
limit	Number	See Search Parameters: limit
page	String	See Search Parameters: page

200: OK Success

{
  "posts": [
    {
      "approver_id": null, // user id
      "change_seq": 0,
      "comment_count": 0,
      "created_at": "0000-00-00T00:00:00.000-00:00",
      "description": "",
      "duration": null,
      "fav_count": 0,
      "file": {
        "ext": "png",
        "height": 4000,
        "md5": "dc3a90deef089384f39e45fdaea96e78",
        "size": 3681606,
        "url": "https://static1.e621.net/data/dc/3a/dc3a90deef089384f39e45fdaea96e78.png",
        "width": 4000
      },
      "flags": {
        "pending": false,
        "flagged": false,
        "note_locked": false,
        "status_locked": false,
        "rating_locked": true,
        "deleted": false
      },
      "has_notes": false,
      "id": 3405794,
      "is_favorited": false,
      "locked_tags": [],
      "pools": [], // numeric pool ids
      "preview": { // width/height may not be correct
        "height": 150,
        "url": "https://static1.e621.net/data/preview/dc/3a/dc3a90deef089384f39e45fdaea96e78.jpg",
        "width": 150
      },
      "rating": "s",
      "relationships": {
        "children": [], // numeric post ids
        "has_active_children": false,
        "has_children": false,
        "parent_id": null // post id
      },
      "sample": {
        "alternates": {},
        "has": false,
        "height": 850,
        "width": 850,
        "url": "https://static1.e621.net/data/sample/dc/3a/dc3a90deef089384f39e45fdaea96e78.jpg"
      },
      "score": {
        "up": 0,
        "down": 0,
        "total": 0
      },
      "sources": "https://twitter.com/broitsCody/status/1532629699083481088",
      "tags": {
        "general": [],
        "species": [],
        "character": [],
        "artist": [],
        "invalid": [],
        "lore": [],
        "meta": []
      },
      "updated_at": "0000-00-00T00:00:00.000-00:00",
      "uploader_id": 0
    }
  ]
}

403: Forbidden Favorites Hidden

{
  "success": false,
  "reason": "Access Denied: This users favorites are hidden"
}

404: Not Found Invalid User/No Auth

{
  "success": false,
  "reason": "not found"
}

Add Favorite

POST https://e621.net/favorites.json

Authorization Required

Request Body

Name	Type	Description
post_id*	Number	The ID of the post to favorite.

200: OK Success

{
  "post": {
    "approver_id": null, // user id
    "change_seq": 0,
    "comment_count": 0,
    "created_at": "0000-00-00T00:00:00.000-00:00",
    "description": "",
    "duration": null,
    "fav_count": 0,
    "file": {
      "ext": "png",
      "height": 4000,
      "md5": "dc3a90deef089384f39e45fdaea96e78",
      "size": 3681606,
      "url": "https://static1.e621.net/data/dc/3a/dc3a90deef089384f39e45fdaea96e78.png",
      "width": 4000
    },
    "flags": {
      "pending": false,
      "flagged": false,
      "note_locked": false,
      "status_locked": false,
      "rating_locked": true,
      "deleted": false
    },
    "has_notes": false,
    "id": 3405794,
    "is_favorited": false,
    "locked_tags": [],
    "pools": [], // numeric pool ids
    "preview": { // width/height may not be correct
      "height": 150,
      "url": "https://static1.e621.net/data/preview/dc/3a/dc3a90deef089384f39e45fdaea96e78.jpg",
      "width": 150
    },
    "rating": "s",
    "relationships": {
      "children": [], // numeric post ids
      "has_active_children": false,
      "has_children": false,
      "parent_id": null // post id
    },
    "sample": {
      "alternates": {},
      "has": false,
      "height": 850,
      "width": 850,
      "url": "https://static1.e621.net/data/sample/dc/3a/dc3a90deef089384f39e45fdaea96e78.jpg"
    },
    "score": {
      "up": 0,
      "down": 0,
      "total": 0
    },
    "sources": "https://twitter.com/broitsCody/status/1532629699083481088",
    "tags": {
      "general": [],
      "species": [],
      "character": [],
      "artist": [],
      "invalid": [],
      "lore": [],
      "meta": []
    },
    "updated_at": "0000-00-00T00:00:00.000-00:00",
    "uploader_id": 0
  }
}

403: Forbidden Access Denied

{
  "success": false,
  "reason": "Access Denied"
}

404: Not Found Invalid Post

{
  "success": false,
  "reason": "not found"
}

422: Unprocessable Entity Post Already Favorited

{
  "success": false,
  "message": "You have already favorited this post",
  "code": null
}

Remove Favorite

DELETE https://e621.net/favorites/{id}.json

Authorization Required

This operation is idempotent.

A success will be returned even if the post has not been favorited, or if the post does not exist.

Path Parameters

Name	Type	Description
id*	Number	The ID of the post to unfavorite.

204: No Content Success

403: Forbidden Access Denied

{
  "success": false,
  "reason": "Access Denied"
}