DocsAPIListsFollowers

/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

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"
    },
    ...
  ]
}