Documentation Index
Fetch the complete documentation index at: https://docs.neynar.com/llms.txt
Use this file to discover all available pages before exploring further.
Hub HTTP APIs
Casts
| Version | Type | Method | Credits |
|---|
| v1 | GET | /v1/castById | 1 |
| | /v1/castsByFid | 200 |
| | /v1/castsByParent | 200 |
| Version | Type | Method | Credits |
|---|
| v1 | GET | /v1/reactionById | 1 |
| | /v1/reactionsByFid | 200 |
| | /v1/reactionsByCast | 150 |
| | /v1/reactionsByTarget | 150 |
| Version | Type | Method | Credits |
|---|
| v1 | GET | /v1/linkById | 1 |
| | /v1/linksByFid | 200 |
| | /v1/linksByTargetFid | 200 |
| Version | Type | Method | Credits |
|---|
| v1 | GET | /v1/userDataByFid | 1 |
| | /v1/fids | 2000 |
| | /v1/storageLimitsByFid | 5 |
| | /v1/userNameProofByName | 2 |
| | /v1/userNameProofsByFid | 2 |
| | /v1/verificationsByFid | 5 |
| | /v1/onChainSignersByFid | 15 |
| Version | Type | Method | Credits |
|---|
| v1 | POST | /v1/submitMessage | 150 |
| | /v1/validateMessage | 4 |
| Version | Type | Method | Credits |
|---|
| v1 | GET | /v1/onChainIdRegistryEventByAddress | 2 |
| | /v1/eventById | 1 |
| | /v1/events | 2000 |
Hub gRPC APIs
WIP
Hub gRPC APIs and Hub gRPC streaming pricing will be added soon.
Neynar APIs
User
| Version | Type | Method | Credits | Multiplier |
|---|
| v2 | GET | /v2/farcaster/user/search | 10 | |
| | /v2/farcaster/user/bulk | 1 | number of fids |
| | /v2/farcaster/user/bulk-by-address | 1 | number of addresses |
| | /v2/farcaster/user/custody-address | 1 | |
| | /v2/farcaster/user/active | 1 | page limit |
| PATCH | /v2/farcaster/user | 20 | |
| POST | /v2/farcaster/user/verification | 10 | |
| | /v2/farcaster/user/follow | 10 | |
| DELETE | /v2/farcaster/user/verification | 10 | |
| | /v2/farcaster/user/follow | 10 | |
| | /v2/farcaster/reaction | 10 | |
| Version | Type | Method | Credits | Multiplier |
|---|
| v2 | GET | /v2/farcaster/cast | 2 | |
| | /v2/farcaster/casts | 50 | |
| POST | /v2/farcaster/cast | 150 | |
| DELETE | /v2/farcaster/cast | 10 | |
| Version | Type | Method | Credits | Multiplier |
|---|
| v2 | GET | /v2/farcaster/feed | 4 | page limit |
| | /v2/farcaster/feed/following | 4 | page limit |
| | /v2/farcaster/feed/channels | 4 | page limit |
| | /v2/farcaster/feed/frames | 4 | page limit |
| | /v2/farcaster/feed/user/{fid}/popular | 4 | page limit |
| | /v2/farcaster/feed/user/{fid}/replies_and_recasts | 4 | page limit |
| Version | Type | Method | Credits | Multiplier |
|---|
| v2 | GET | /v2/farcaster/reactions/user | 2 | page limit |
| GET | /v2/farcaster/reactions/cast | 2 | page limit |
| POST | /v2/farcaster/reaction | 10 | |
| Version | Type | Method | Credits | Multiplier |
|---|
| v2 | POST | /v2/farcaster/frame/action | 20 | |
| | /v2/farcaster/frame/validate | 0 | |
| Version | Type | Method | Credits | Multiplier |
|---|
| v2 | GET | /v2/farcaster/notifications | 5 | page limit |
| | /v2/farcaster/notifications/parent_url | 5 | page limit |
| | /v2/farcaster/notifications/channel | 5 | page limit |
| Version | Type | Method | Credits | Multiplier |
|---|
| v2 | GET | /v2/farcaster/channel/list | 2 | page limit |
| | /v2/farcaster/channel/search | 20 | |
| | /v2/farcaster/channel | 2 | |
| | /v2/farcaster/channel/followers | 1 | page limit |
| | /v2/farcaster/channel/users | 1 | page limit |
| | /v2/farcaster/channel/trending | 4 | page limit |
| Version | Type | Method | Credits | Multiplier |
|---|
| v2 | GET | v2/farcaster/followers/relevant | 20 | |
| Version | Type | Method | Credits | Multiplier |
|---|
| v2 | GET | /v2/farcaster/fname/availability | 1 | |
| Version | Type | Method | Credits | Multiplier |
|---|
| v2 | GET | /v2/farcaster/storage/allocations | 1 | |
| | /v2/farcaster/storage/usage | 1 | |
| Version | Type | Method | Credits | Multiplier |
|---|
| v2 | GET | /v2/farcaster/signer | 0 | |
| GET | /v2/farcaster/signer/developer_managed | 0 | |
| POST | /v2/farcaster/signer | 2 | |
| | /v2/farcaster/signer/signed_key | 5 | |
| | /v2/farcaster/signer/developer_managed/signed_key | 5 | |
| Version | Type | Method | Credits |
|---|
| v2 | POST | v2/farcaster/message | 150 |
Webhooks
| Event type | Filter | Credits |
|---|
| user.created | | 5 |
| user.updated | fids | 10 |
| cast.created | fids | 15 |
| mention_fids | 15 |
| author_fids | 15 |
| root_parent_urls | 15 |
| parent_url | 15 |
| embeds | 15 |
| reaction.created | fids | 15 |
| target_fids | 15 |
| reaction.deleted | fids | 15 |
| target_fids | 15 |
| follow.created | fids | 15 |
| target_fids | 15 |
| follow.deleted | fids | 15 |
| target_fids | 15 |
