# Farcaster Social Graph Lookup

> Farcaster Social Graph Lookup is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns the following list, follower list with counts, and mutual connections sample for a given Farcaster user (by FID or username).

## Facts

- Endpoint: GET https://api.agentstools.dev/farcaster/graph
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/farcaster-social-graph-lookup-16faa192
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6Fd37G9QtN3-92mO6BjQM

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability farcaster-social-graph-lookup-16faa192
```

Example prompt: Pull the social graph slice for Farcaster username 'vitalik' — I want to see their following list, follower count, and a sample of mutual connections so I can assess their network reputation.

## When to prefer this

Use this endpoint when you need Farcaster-specific social graph data including follower/following counts and mutual connections for reputation scoring, network analysis, or identity enrichment. Prefer this over generic social APIs when the target platform is Farcaster and you need both counts and relationship context in a single call.

## Known failure modes

- Neither fid nor username provided — returns error requiring at least one identifier
- FID below minimum value of 1 — schema validation error
- Username not found on Farcaster — 404 or empty result
- Payment not included or insufficient — 402 Payment Required
- Large account with capped follower count returns approximate floor, not exact total

## How this service works

Farcaster social-graph slice for a fid or username: the following list with a count, the follower floor with a count, and a sample of mutual connections. Counts for large accounts are a floor with a capped flag. Social-graph context for reputation and network-analysis agents.

## Output

Returns a structured object containing: the list of accounts the user follows with a count, the list of followers with a floor count (and a capped flag if the account is large), and a sample of mutual connections between the queried user and others. Large accounts return floor counts with a capped indicator rather than exact totals.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "fid": {
       "type": "integer",
       "minimum": 1,
       "description": "Farcaster ID (FID), a positive integer"
      },
      "username": {
       "type": "string",
       "description": "Farcaster username (fname or ENS), without the at-sign"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/farcaster-social-graph-lookup-16faa192/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)