{"uid":"cap_6Fd37G9QtN3-92mO6BjQM","slug":"farcaster-social-graph-lookup-16faa192","name":"Farcaster Social Graph Lookup","description":"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.","url":"https://api.agentstools.dev/farcaster/graph","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yBQgR1UxosDHAvqdwFwNt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the following list, follower list with counts, and mutual connections sample for a given Farcaster user (by FID or username).","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:08:58.022Z","isFirstParty":false}