---
title: Suggestion
description: Represents a suggested account to follow and an associated reason for the suggestion.
menu:
  docs:
    parent: entities
aliases: [
  "/entities/suggestion",
  "/entities/Suggestion",
  "/api/entities/suggestion",
  "/api/entities/Suggestion",
]
---

## Example

```json
{
  "source": "staff",
  "account": {
    "id": "109031732217496096",
    "username": "alice",
    "acct": "alice",
    // ...
  }
}
```

## Attributes

### `source` {#source}

**Description:** The reason this account is being suggested.\
**Type:** String (Enumerable oneOf)\
`staff` = This account was manually recommended by the administration team\
`past_interactions` = The authenticated account has interacted with this account previously\
`global` = This account has many reblogs, favourites, and active local followers within the last 30 days\
**Version history:**\
3.4.0 - added\
4.3.0 - deprecated, use `sources` instead

### `sources` {#sources}

**Description:** A list of reasons this account is being suggested. This replaces `source`\
**Type:** Array of String (Enumerable oneOf)\
`featured` = This account was manually recommended by the administration team. Equivalent to the `staff` value for `source`\
`most_followed` = This account has many active local followers\
`most_interactions` = This account had many reblogs and favourites within the last 30 days\
`similar_to_recently_followed` = This account's profile is similar to the authenticated account's most recent follows\
`friends_of_friends` = This account is followed by people followed by the authenticated account\
**Version history:**\
4.3.0 - added

### `account` {#account}

**Description:** The account being recommended to follow.\
**Type:** [Account]({{< relref "entities/Account" >}})\
**Version history:**\
3.4.0 - added

## See also

{{< page-relref ref="methods/suggestions#v2" caption="GET /api/v2/suggestions" >}}

{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/suggestion_serializer.rb" caption="app/serializers/rest/suggestion_serializer.rb" >}}

{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/models/account_suggestions.rb" caption="app/models/account_suggestions.rb" >}}

{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/models/account_suggestions/" caption="app/models/account_suggestions/" >}}
