v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB

Links

From source FID

Fetch a list of users that a user is following.

get/v1/linksByFid

Query parameters

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 link's originator

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"
}