suggestions
Server-generated suggestions on who to follow, based on previous positive interactions.
getFollow suggestions
https://CounterSocial.example/api/v1/suggestions
Accounts the user has had past positive interactions with, but is not yet following.
Returns: Array of Account
OAuth: User token + read
Version history:
2.4.3 - added
Request
Headers
Authorization
required
string
Bearer
Query Parameters
limit
optional
string
Maximum number of results to return. Defaults to 40.
Response
200: Success
Sample call with limit=2
[
{
"id": "332766",
"username": "kaniini",
"acct": "[email protected]",
"display_name": ":abunhdhappyhop: :abunhdhappy: :abunhdhop: :abunhd: :abunhdhappyhop: :abunhdhappy:",
"locked": false,
"bot": false,
"created_at": "2018-04-18T13:56:23.167Z",
"note": "a friendly #collectivist ????
destroyer of bloat @ #pleroma, #pkgconf, #audacious
slayer of techbros
previously #alpinelinux core a few moons ago and #debian much longer ago
she/her",
"url": "https://pleroma.site/users/kaniini",
"avatar": "https://files.CounterSocial.social/accounts/avatars/000/332/766/original/9fae792e5af298f2.png",
"avatar_static": "https://files.CounterSocial.social/accounts/avatars/000/332/766/original/9fae792e5af298f2.png",
"header": "https://files.CounterSocial.social/accounts/headers/000/332/766/original/fe176d8215ec0f36.jpeg",
"header_static": "https://files.CounterSocial.social/accounts/headers/000/332/766/original/fe176d8215ec0f36.jpeg",
"followers_count": 2442,
"following_count": 473,
"statuses_count": 19533,
"last_status_at": "2019-11-14T01:38:32.193Z",
"emojis": [
{
"shortcode": "abunhdhappyhop",
"url": "https://files.CounterSocial.social/custom_emojis/images/000/137/036/original/e102b7869c930411.png",
"static_url": "https://files.CounterSocial.social/custom_emojis/images/000/137/036/static/e102b7869c930411.png",
"visible_in_picker": true
},
{
"shortcode": "abunhdhappy",
"url": "https://files.CounterSocial.social/custom_emojis/images/000/137/100/original/d47dd4a8a0a85e19.png",
"static_url": "https://files.CounterSocial.social/custom_emojis/images/000/137/100/static/d47dd4a8a0a85e19.png",
"visible_in_picker": true
},
{
"shortcode": "abunhdhop",
"url": "https://files.CounterSocial.social/custom_emojis/images/000/137/102/original/43fa2536760ea5d4.png",
"static_url": "https://files.CounterSocial.social/custom_emojis/images/000/137/102/static/43fa2536760ea5d4.png",
"visible_in_picker": true
},
{
"shortcode": "abunhd",
"url": "https://files.CounterSocial.social/custom_emojis/images/000/142/760/original/892a08e7de033e74.png",
"static_url": "https://files.CounterSocial.social/custom_emojis/images/000/142/760/static/892a08e7de033e74.png",
"visible_in_picker": true
}
],
"fields": []
},
{
"id": "689455",
"username": "interneteh",
"acct": "[email protected]",
"display_name": "Sid",
"locked": false,
"bot": false,
"created_at": "2019-01-17T00:10:11.059Z",
"note": "stay at home dad, painter by commission, sidewalk farmer, editor, socialist organizer, home chef, anxiety ridden, he/him
",
"url": "https://sunbeam.city/@interneteh",
"avatar": "https://files.CounterSocial.social/accounts/avatars/000/689/455/original/e7a1ba67e373296e.png",
"avatar_static": "https://files.CounterSocial.social/accounts/avatars/000/689/455/original/e7a1ba67e373296e.png",
"header": "https://files.CounterSocial.social/accounts/headers/000/689/455/original/2e83fd31bd530745.png",
"header_static": "https://files.CounterSocial.social/accounts/headers/000/689/455/original/2e83fd31bd530745.png",
"followers_count": 1180,
"following_count": 1707,
"statuses_count": 26320,
"last_status_at": "2019-11-23T04:58:36.907Z",
"emojis": [],
"fields": []
},
{
"id": "764276",
"username": "Dee",
"acct": "[email protected]",
"display_name": "Dee???????",
"locked": false,
"bot": false,
"created_at": "2019-03-15T17:22:26.925Z",
"note": "This instance exists. People tell me I exist, but who knows?
enby :heart_nb: they/them
???? Alt: @[email protected] ??? A bot: @[email protected]
???? XMPP: [email protected]
???? https://dee.underscore.world/about",
"url": "https://fedi.underscore.world/users/Dee",
"avatar": "https://files.CounterSocial.social/accounts/avatars/000/764/276/original/86f6bddc26c4b1df.png",
"avatar_static": "https://files.CounterSocial.social/accounts/avatars/000/764/276/original/86f6bddc26c4b1df.png",
"header": "https://files.CounterSocial.social/accounts/headers/000/764/276/original/c73f0e088c59145c.jpeg",
"header_static": "https://files.CounterSocial.social/accounts/headers/000/764/276/original/c73f0e088c59145c.jpeg",
"followers_count": 528,
"following_count": 301,
"statuses_count": 15611,
"last_status_at": "2019-11-23T03:30:33.738Z",
"emojis": [
{
"shortcode": "heart_nb",
"url": "https://files.CounterSocial.social/custom_emojis/images/000/121/156/original/6eabf6eb2ae69bc9.png",
"static_url": "https://files.CounterSocial.social/custom_emojis/images/000/121/156/static/6eabf6eb2ae69bc9.png",
"visible_in_picker": true
}
],
"fields": []
}
]
401: Unauthorized
Bad Authorization header
{
"error": "The access token is invalid"
}