v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB

Links

To target FID

Fetch a list of users that are following a user.

get/v1/linksByTargetFid

Query parameters

target_fidinteger required

Farcaster ID (FID). A unique identifier assigned to each user in the Farcaster network. This number is permanent and cannot be changed. FIDs are assigned sequentially when users register on the network.

Example:1

The FID of the target user for this link

link_type'follow'

Defines the type of social connection between users.

follow: Establishes a following relationship where the user will receive updates from the target user in their feed

Example:follow

pageSizeinteger

Maximum number of messages to return in a single response

reverseboolean

Reverse the sort order, returning latest messages first

pageTokenstring

The page token returned by the previous query, to fetch the next page. If this parameter is empty, fetch the first page

Response

The requested Links.

nextPageTokenstring byte required

Base64-encoded pagination token for fetching the next page of results. An empty value indicates there are no more pages to return. Used in conjunction with the pageSize parameter to implement pagination across large result sets.

Example response

{
  "messages": [
    {
      "hash": "0xd2b1ddc6c88e865a33cb1a565e0058d757042974",
      "data": {
        "fid": 2,
        "timestamp": 48994466,
        "linkBody": {
          "type": "follow",
          "displayTimestamp": 48994466,
          "targetFid": 1
        }
      }
    }
  ],
  "nextPageToken": "AuzO1V0DtaItCwwa10X6YsfStlynsGWT"
}