Skip to content
Ethereum Follow Protocol Logo EFP Docs

Followers

/lists/:token_id/followers

Get followers (excluding blocked and muted) of a user by their EFP list id.

Path Parameters

  • token_id (string): The EFP List of the account

Query Parameters

  • limit (number, optional): Specifies the amount of records to return in the response. If not specifed, default value is 10.
  • offset (number, optional): Specifies the starting index of the records to return in the response. If not specifed, default value is 0.
  • tags (string, optional): Specifies an array of comma separated tags, of which each account in the response should have at least one.
  • sort (string, optional): Specifies how the results should be sorted, possible values ‘latest’, ‘earliest’, ‘followers’. If not specified, default sort is ‘latest’
  • cache (string, optional): If set to ‘fresh’ the cache lookup will be skipped, fresh data will be returned and the cache record will be updated with the new data.

Sample Query

Terminal window
curl https://api.ethfollow.xyz/api/v1/lists/4/followers
// sample response
{
  "followers": [
    {
      "efp_list_nft_token_id": "325",
      "address": "0x9b2fb7a8d227cdaa8002f80e8c8a99a19bb1b969",
      "tags": [],
      "is_following": true,
      "is_blocked": false,
      "is_muted": false,
      "updated_at": "2024-09-24T16:45:26.088Z"
    },
    {
      "efp_list_nft_token_id": "728",
      "address": "0xca034d4438719391b5e7589242a36ec535ed6836",
      "tags": [],
      "is_following": false,
      "is_blocked": false,
      "is_muted": false,
      "updated_at": "2024-09-24T16:45:26.088Z"
    },
    {
      "efp_list_nft_token_id": "723",
      "address": "0x8901083bb577b335a5f6fddde705c00efe8c33d9",
      "tags": [],
      "is_following": false,
      "is_blocked": false,
      "is_muted": false,
      "updated_at": "2024-09-24T16:45:26.088Z"
    },
    ...
  ]
}