Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/followers

A user's followers, each with their profile

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/farcaster-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/farcaster-api/v1/followers" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/farcaster-api/v1/followers", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/farcaster-api/v1/followers");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/farcaster-api/v1/followers",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "fid": 3,
        "count": 25,
        "source": "Farcaster",
        "followers": [
            {
                "bio": "Brandon ⚡\nBuilding DreamNet — a living onchain AI organism 🧬🌐\nNeural lattice • Agents • Nodes • Evolution\nBase-aligned, chaos-friendly, creator-powered 🔥🐉",
                "fid": 1477142,
                "active": false,
                "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/dc02c711-9086-4577-c151-eda7b9b02c00/original",
                "username": "ghostmintops",
                "followers": 679,
                "following": 1112,
                "power_badge": false,
                "profile_url": "https://warpcast.com/ghostmintops",
                "display_name": "ghostmintops"
            },
            {
                "bio": "private property some have no respect for other people's property",
                "fid": 1357302,
                "active": false,
                "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/5a2717bd-8a5e-4596-12ba-67e920d4f600/original",
                "username": "ethergirl646",
                "followers": 36,
                "following": 64,
                "power_badge": false,
                "profile_url": "https://warpcast.com/ethergirl646",
                "display_name": "ethergirl646 Gail Cole"
            },
            {
                "bio": "Doctor❤️🌼",
                "fid": 1117360,
                "active": false,
                "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/7f33282f-edc1-4e05-5a56-bb000892a400/original",
                "username": "shifat007",
                "followers": 5225,
                "following": 19730,
                "power_badge": false,
                "profile_url": "https://warpcast.com/shifat007",
                "display_name": "SHIFAT  🇨🇦"
            },
            {
                "bio": "Api Developer, Poker Player",
                "fid": 2272296,
                "active": false,
                "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/9bbc252f-459e-41f8-70c7-7bc742e25500/original",
                "username": "jdwalka",
                "followers": 22,
                "following": 188,
                "power_badge": false,
                "profile_url": "https://warpcast.com/jdwalka",
                "display_name": "jdwalka"
            },
            {
                "bio": null,
                "fid": 3332974,
                "active": false,
                "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/ff2d6f17-94a8-4e28-79c7-105627504d00/rectcontain2",
                "username": "primeagent",
                "followers": 0,
                "following": 1,
                "power_badge": false,
                "profile_url": "https://warpcast.com/primeagent",
                "display_name": "primeagent"
            },
            {
                "bio": null,
                "fid": 3336426,
                "ac
…