Who this feed should follow

GET

/v1/feeds/{group}/{id}/suggestions

curl --request GET \
  --url 'http://localhost:3000/v1/feeds/example/example/suggestions?limit=25' \
  --header 'Authorization: Bearer <token>'

Follow suggestions for a feed: user: feeds it does not already follow, ranked by mutual overlap (feeds followed by feeds this feed follows — friends-of-friends), then topped up to limit by global follower_count for cold-start feeds with a thin graph. Reads are open within a tenant (spec §1). Not paginated — a capped top-N, so no cursor.

Authorizations

• bearerAuth

Parameters

Path Parameters

group

required

string

id

required

string

Query Parameters

limit

integer

default: 25 >= 1 <= 50

Responses

200

A capped list of suggested feeds, best first.

Media typeapplication/json

object

results

required

Array<object>

object

group

required

Always ‘user’ in v1 — only people are suggested.

string

id

required

string

mutuals

required

Count of feeds the caller follows that also follow this suggestion (friends-of-friends overlap). 0 for a popularity-fill suggestion.

integer

Example^generated

{
  "results": [
    {
      "group": "example",
      "id": "example",
      "mutuals": 1
    }
  ]
}

401

Invalid, expired, revoked, or absent token.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: VALIDATION_FAILED UNAUTHENTICATED FORBIDDEN NOT_FOUND CONFLICT RATE_LIMITED INTERNAL

message

required

string

requestId

required

string

fields

Present only for VALIDATION_FAILED.

Array<object>

object

path

string

message

string

Example

{
  "error": {
    "code": "VALIDATION_FAILED"
  }
}