documentation/content/en/entities/Suggestion.md

---

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

{
  "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 your administration team\ past_interactions = You have 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 your 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 your most recent follows\ friends_of_friends = This account is followed by people you follow\ Version history:\ 4.3.0 - added

account {#account}

Description: The account being recommended to follow.\ Type: 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/" >}}