favourites
View your favourites. See also statuses/:id/{favourite,unfavourite}
get
Favourited statuses
https://mastodon.example/api/v1/favourites
Statuses the user has favourited.
Returns: Array of Status
OAuth: User token + read:favourites
Version:
0.0.0 - added
2.6.0 - min_id added
Request
Headers
Authorization
required
string
Bearer <user token>
Query Parameters
limit
optional
string
min_id
optional
string
Internal parameter. Use HTTP
Link header for pagination instead.
max_id
optional
string
Internal parameter. Use HTTP
Link header for pagination instead.
Response
200: Success
An example call with limit=2. Results will be returned as a Status entity with embedded Account entity. Because the id of a favourite is not public, an HTTP Link header can be parsed for next and previous pages.Internal
Link: <https://mastodon.social/api/v1/favourites?limit=2&max_id=23716836>; rel="next", <https://mastodon.social/api/v1/favourites?limit=2&min_id=23716978>; rel="prev"
[
"id": "103186075217296344",
"created_at": "2019-11-23T07:35:52.000Z",
"in_reply_to_id": null,
"in_reply_to_account_id": null,
"sensitive": false,
"spoiler_text": "",
"visibility": "unlisted",
"language": "enCy",
"uri": "https://cybre.space/users/haskal/statuses/103186075002013902",
"url": "https://cybre.space/@haskal/103186075002013902",
"replies_count": 0,
"reblogs_count": 1,
"favourites_count": 1,
"favourited": true,
"reblogged": false,
"muted": false,
"bookmarked": false,
"content": "<p>the pirate gay</p>",
"reblog": null,
"account": {
"id": "297420",
"username": "haskal",
"acct": "haskal@cybre.space",
"display_name": "soft nb friend :blobcatsleep:",
"locked": false,
"bot": false,
"created_at": "2018-03-16T00:47:36.470Z",
"note": "<p>a very distinctive nya</p><p>systems hecker, -1x engineer, server maid, professional yak shaver<br>free software | digital rights | rhythm games | cyberponk | homelab | ham radio | electronics</p><p>🇺🇸/🇭🇺/🏴☠️<br>21; they/them</p><p>b618ac8ac69b6ac7bae267acb1a81e</p>",
"url": "https://cybre.space/@haskal",
"avatar": "https://files.mastodon.social/accounts/avatars/000/297/420/original/5e2def6e305cecee.png",
"avatar_static": "https://files.mastodon.social/accounts/avatars/000/297/420/original/5e2def6e305cecee.png",
"header": "https://files.mastodon.social/accounts/headers/000/297/420/original/2df598299cc677db.png",
"header_static": "https://files.mastodon.social/accounts/headers/000/297/420/original/2df598299cc677db.png",
"followers_count": 268,
"following_count": 258,
"statuses_count": 8743,
"last_status_at": "2019-11-23T07:49:39.880Z",
"emojis": [
{
"shortcode": "blobcatsleep",
"url": "https://files.mastodon.social/custom_emojis/images/000/077/451/original/fc39ac6778d2ca02.png",
"static_url": "https://files.mastodon.social/custom_emojis/images/000/077/451/static/fc39ac6778d2ca02.png",
"visible_in_picker": true
}
],
"fields": [
{
"name": "web",
"value": "<a href=\"https://tilde.town/~haskal\" rel=\"nofollow noopener noreferrer\" target=\"_blank\"><span class=\"invisible\">https://</span><span class=\"\">tilde.town/~haskal</span><span class=\"invisible\"></span></a>",
"verified_at": "2019-11-22T21:16:30.009+00:00"
},
{
"name": "other web",
"value": "<a href=\"https://awoo.systems\" rel=\"nofollow noopener noreferrer\" target=\"_blank\"><span class=\"invisible\">https://</span><span class=\"\">awoo.systems</span><span class=\"invisible\"></span></a>",
"verified_at": "2019-11-22T21:16:30.578+00:00"
},
{
"name": "xmpp",
"value": "haskal@lain.faith",
"verified_at": null
},
{
"name": "matrix",
"value": "<span class=\"h-card\"><a href=\"https://cybre.space/@haskal\" class=\"u-url mention\" rel=\"nofollow noopener noreferrer\" target=\"_blank\">@<span>haskal</span></a></span>:matrix.org",
"verified_at": null
}
]
},
"media_attachments": [],
"mentions": [],
"tags": [],
"emojis": [],
"card": null,
"poll": null
},
{
"id": "103186044372624124",
"created_at": "2019-11-23T07:28:03.000Z",
"in_reply_to_id": null,
"in_reply_to_account_id": null,
"sensitive": true,
"spoiler_text": "no context",
"visibility": "unlisted",
"language": "enCy",
"uri": "https://cybre.space/users/haskal/statuses/103186044253681902",
"url": "https://cybre.space/@haskal/103186044253681902",
"replies_count": 1,
"reblogs_count": 0,
"favourites_count": 1,
"favourited": true,
"reblogged": false,
"muted": false,
"bookmarked": false,
"content": "<p>cute,,,</p>",
"reblog": null,
"account": {
"id": "297420",
"username": "haskal",
"acct": "haskal@cybre.space",
"display_name": "soft nb friend :blobcatsleep:",
"locked": false,
"bot": false,
"created_at": "2018-03-16T00:47:36.470Z",
"note": "<p>a very distinctive nya</p><p>systems hecker, -1x engineer, server maid, professional yak shaver<br>free software | digital rights | rhythm games | cyberponk | homelab | ham radio | electronics</p><p>🇺🇸/🇭🇺/🏴☠️<br>21; they/them</p><p>b618ac8ac69b6ac7bae267acb1a81e</p>",
"url": "https://cybre.space/@haskal",
"avatar": "https://files.mastodon.social/accounts/avatars/000/297/420/original/5e2def6e305cecee.png",
"avatar_static": "https://files.mastodon.social/accounts/avatars/000/297/420/original/5e2def6e305cecee.png",
"header": "https://files.mastodon.social/accounts/headers/000/297/420/original/2df598299cc677db.png",
"header_static": "https://files.mastodon.social/accounts/headers/000/297/420/original/2df598299cc677db.png",
"followers_count": 268,
"following_count": 258,
"statuses_count": 8743,
"last_status_at": "2019-11-23T07:49:39.880Z",
"emojis": [
{
"shortcode": "blobcatsleep",
"url": "https://files.mastodon.social/custom_emojis/images/000/077/451/original/fc39ac6778d2ca02.png",
"static_url": "https://files.mastodon.social/custom_emojis/images/000/077/451/static/fc39ac6778d2ca02.png",
"visible_in_picker": true
}
],
"fields": [
{
"name": "web",
"value": "<a href=\"https://tilde.town/~haskal\" rel=\"nofollow noopener noreferrer\" target=\"_blank\"><span class=\"invisible\">https://</span><span class=\"\">tilde.town/~haskal</span><span class=\"invisible\"></span></a>",
"verified_at": "2019-11-22T21:16:30.009+00:00"
},
{
"name": "other web",
"value": "<a href=\"https://awoo.systems\" rel=\"nofollow noopener noreferrer\" target=\"_blank\"><span class=\"invisible\">https://</span><span class=\"\">awoo.systems</span><span class=\"invisible\"></span></a>",
"verified_at": "2019-11-22T21:16:30.578+00:00"
},
{
"name": "xmpp",
"value": "haskal@lain.faith",
"verified_at": null
},
{
"name": "matrix",
"value": "<span class=\"h-card\"><a href=\"https://cybre.space/@haskal\" class=\"u-url mention\" rel=\"nofollow noopener noreferrer\" target=\"_blank\">@<span>haskal</span></a></span>:matrix.org",
"verified_at": null
}
]
},
"media_attachments": [],
"mentions": [],
"tags": [],
"emojis": [],
"card": null,
"poll": null
}
]
401: Unauthorized
If a user token is not provided or is incorrect, the request will fail.
{
"error": "The access token is invalid"
}
Last updated December 27, 2020 · Improve this page