{"uid":"cap_wQNGW36PM1XxZAwGZCk4K","slug":"neynar-farcaster-bulk-user-lookup-e65fdf5b","name":"Neynar Farcaster Bulk User Lookup","description":"Complete Farcaster developer platform","url":"https://api.neynar.com/v2/farcaster/user/bulk/","method":"GET","headers":{},"bodySchema":null,"responseSchema":null,"example":{"request":{"fids":[2,194,3621]},"response":{"next":{"cursor":null},"users":[{"fid":2,"pro":{"status":"subscribed","expires_at":"2026-06-16T17:21:25.000Z","subscribed_at":"2025-06-16T17:21:25.000Z"},"score":0.99,"object":"user","pfp_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/e3d80f99-f7c0-4b04-dcad-557593d85500/original","profile":{"bio":{"text":"Technowatermelon. Elder Millenial. Building Farcaster. \n\nnf.td/varun"},"location":{"address":{"city":"Los Angeles","state":"California","country":"United States of America","state_code":"ca","country_code":"us"},"latitude":34.05,"longitude":-118.24}},"username":"v","display_name":"Varun Srinivasan","experimental":{"neynar_user_score":0.99,"deprecation_notice":"The `neynar_user_score` field under `experimental` will be deprecated after June 1, 2025, as it will be formally promoted to a stable field named `score` within the user object."},"registered_at":"2023-11-07T19:42:51.000Z","verifications":["0x91031dcfdea024b4d51e775486111d2b2a715871","0x182327170fc284caaa5b1bc3e3878233f529d741","0xf86a7a5b7c703b1fd8d93c500ac4cc75b67477f0","0x661e2209b9c6b06c1f32a0639f60d3294185ab35","0xd33fa9b999d59722b82c1cc52db9d74e109cda2f"],"auth_addresses":[{"app":{"fid":9152,"object":"user_dehydrated"},"address":"0x661e2209b9c6b06c1f32a0639f60d3294185ab35"}],"follower_count":482249,"custody_address":"0x4114e33eb831858649ea3702e1c9a2db3f626446","following_count":1854,"verified_accounts":[{"platform":"x","username":"varunsrin"}],"verified_addresses":{"primary":{"eth_address":"0x661e2209b9c6b06c1f32a0639f60d3294185ab35","sol_address":"97c51MXLjrHBMzSZSNVWXmnXPzKWkQ6jSNWxJFPDdKuN"},"eth_addresses":["0x91031dcfdea024b4d51e775486111d2b2a715871","0x182327170fc284caaa5b1bc3e3878233f529d741","0xf86a7a5b7c703b1fd8d93c500ac4cc75b67477f0","0x661e2209b9c6b06c1f32a0639f60d3294185ab35","0xd33fa9b999d59722b82c1cc52db9d74e109cda2f"],"sol_addresses":["9t92xZy9q5SyfKBH4rZwEDFXjaZKgzj5PgviPhKtBjyy","97c51MXLjrHBMzSZSNVWXmnXPzKWkQ6jSNWxJFPDdKuN"]}},{"fid":194,"pro":{"status":"subscribed","expires_at":"2026-06-16T17:19:23.000Z","subscribed_at":"2025-06-16T17:19:23.000Z"},"url":"https://rish.org","score":0.99,"object":"user","pfp_url":"https://i.imgur.com/naZWL9n.gif","profile":{"bio":{"text":"i do customer support around here"},"banner":{"url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/729ccc5f-6337-475a-cd78-4fc6afe5e700/original"}},"username":"rish","display_name":"rish","experimental":{"neynar_user_score":0.99,"deprecation_notice":"The `neynar_user_score` field under `experimental` will be deprecated after June 1, 2025, as it will be formally promoted to a stable field named `score` within the user object."},"registered_at":"2023-11-07T19:42:51.000Z","verifications":["0x5a927ac639636e534b678e81768ca19e2c6280b7","0xe9e261852ea62150eee685807df8fe3f211310a0","0xe1fac64cebe0855d984ac7c3feb8b7612c6b4176","0xa84bc380aeb35836500216c243ab16ef24f9f2f0","0x11d5d3f2feccb882947bf8ff6599beb823986e75","0x8cb13a5967d4a9f84bab350ae8328db195b1e173"],"auth_addresses":[{"app":{"fid":9152,"object":"user_dehydrated"},"address":"0x11d5d3f2feccb882947bf8ff6599beb823986e75"},{"app":{"fid":16999,"object":"user_dehydrated"},"address":"0x33560629a00b2ed47f9eaeb3a18d41af69181f43"},{"app":{"fid":309857,"object":"user_dehydrated"},"address":"0xe1fac64cebe0855d984ac7c3feb8b7612c6b4176"}],"follower_count":299138,"custody_address":"0xb95dc10483be18f7c69ddf78d4baafecc01c5530","following_count":1257,"verified_accounts":[{"platform":"x","username":"rish_neynar"}],"verified_addresses":{"primary":{"eth_address":"0x11d5d3f2feccb882947bf8ff6599beb823986e75","sol_address":"9HVQS8Q4cR2yTdTcwDJKG4GBkp9wKVMwmHkzXfER62ik"},"eth_addresses":["0x5a927ac639636e534b678e81768ca19e2c6280b7","0xe9e261852ea62150eee685807df8fe3f211310a0","0xe1fac64cebe0855d984ac7c3feb8b7612c6b4176","0xa84bc380aeb35836500216c243ab16ef24f9f2f0","0x11d5d3f2feccb882947bf8ff6599beb823986e75","0x8cb13a5967d4a9f84bab350ae8328db195b1e173"],"sol_addresses":["7EeGPnP1dqjXhPwqLmTR1h89txKwLuuciJH6yFPHThCE","9HVQS8Q4cR2yTdTcwDJKG4GBkp9wKVMwmHkzXfER62ik"]}},{"fid":3621,"pro":{"status":"subscribed","expires_at":"2026-07-16T17:21:25.000Z","subscribed_at":"2025-06-16T17:21:25.000Z"},"url":"https://terminally.online","score":1,"object":"user","pfp_url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/ccc417d2-f00b-4bc6-8597-156429f32e00/original","profile":{"bio":{"text":"I work at the posts office."},"banner":{"url":"https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/709c5d59-7025-4840-7c8d-8adc4095b000/original"},"location":{"address":{"city":"New York","state":"New York","country":"United States of America","state_code":"ny","country_code":"us"},"latitude":40.71,"longitude":-74.01}},"username":"horsefacts.eth","display_name":"horsefacts","experimental":{"neynar_user_score":1,"deprecation_notice":"The `neynar_user_score` field under `experimental` will be deprecated after June 1, 2025, as it will be formally promoted to a stable field named `score` within the user object."},"registered_at":"2023-11-07T20:01:57.000Z","verifications":["0x79d31bfca5fda7a4f15b36763d2e44c99d811a6c","0x4d940b31dee0db0ce75af30878d9ce30dc7bd109","0x1a8b7cee23e54d8c3891fcc5409842c9cde345e1","0xcfe57ca65bca3c9218bb379065cddfb69bd1dcb4","0x3f56e996934c952a074672ffdbe51042e046c80a","0x075b108fc0a6426f9dec9a5c18e87eb577d1346a","0xe36d2f95a9b69df60dbf029bf7c4fa7d1ff56b90","0x13a0120d2c9baed53ccca01c49cf5cea97f933b8","0xe8c088f750544b434573825769a5fc79d96cc83a","0xbc134b792dc96954607ae43668e39c134351cb74","0x514d66d5091b94b91976be8f44d7e4022bf42d5b"],"auth_addresses":[{"app":{"fid":9152,"object":"user_dehydrated"},"address":"0xe36d2f95a9b69df60dbf029bf7c4fa7d1ff56b90"},{"app":{"fid":309857,"object":"user_dehydrated"},"address":"0xe8c088f750544b434573825769a5fc79d96cc83a"}],"follower_count":389854,"custody_address":"0x2cd85a093261f59270804a6ea697cea4cebecafe","following_count":6502,"verified_accounts":[{"platform":"x","username":"eth_call"}],"verified_addresses":{"primary":{"eth_address":"0xe36d2f95a9b69df60dbf029bf7c4fa7d1ff56b90","sol_address":"4NzbDQK773ni6J1jnNTRPLe1zQHtaTwEPp6mnKV8bFrK"},"eth_addresses":["0x79d31bfca5fda7a4f15b36763d2e44c99d811a6c","0x4d940b31dee0db0ce75af30878d9ce30dc7bd109","0x1a8b7cee23e54d8c3891fcc5409842c9cde345e1","0xcfe57ca65bca3c9218bb379065cddfb69bd1dcb4","0x3f56e996934c952a074672ffdbe51042e046c80a","0x075b108fc0a6426f9dec9a5c18e87eb577d1346a","0xe36d2f95a9b69df60dbf029bf7c4fa7d1ff56b90","0x13a0120d2c9baed53ccca01c49cf5cea97f933b8","0xe8c088f750544b434573825769a5fc79d96cc83a","0xbc134b792dc96954607ae43668e39c134351cb74","0x514d66d5091b94b91976be8f44d7e4022bf42d5b"],"sol_addresses":["GAR98Ray1ewPvCrhayunzSaV6N39nckGsD3dKh5UwG4n","4NzbDQK773ni6J1jnNTRPLe1zQHtaTwEPp6mnKV8bFrK"]}}]}},"exampleRequest":{"fids":[2,194,3621]},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_XDNmXjPtC1k9eFDGneqMy","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":"Fetches profile data for multiple Farcaster users in a single bulk GET request by FID or address","exampleAgentPrompt":"Look up the Farcaster profiles for FIDs 2, 194, and 3621 — I need their display names, bios, follower counts, and verified Ethereum addresses.","exampleUseCases":[{"title":"Hydrate leaderboard with Farcaster profiles","prompt":"I have a list of FIDs from our top 20 most active casters this week — can you pull all their Farcaster profiles at once so I can show their display names, avatars, and follower counts on the leaderboard?"},{"title":"Resolve addresses to Farcaster identities","prompt":"I've got these Ethereum wallet addresses from our on-chain event attendees and I want to know which ones have Farcaster accounts — fetch their profiles so I can see their usernames, bios, and whether they're verified."},{"title":"Audit influencer profiles before campaign","prompt":"Before we kick off the campaign, can you batch fetch the Farcaster profiles for these 15 FIDs we shortlisted as potential partners? I need their follower counts, display names, and bios to compare them side by side."}],"resultDescription":"Returns an array of Farcaster user objects, each containing FID, username, display name, bio, profile picture URL, follower/following counts, verified Ethereum addresses, and other profile metadata for each requested user.","failureModes":["Invalid or non-existent FIDs return empty or error entries","Too many FIDs in one request may hit size limits","Missing or invalid API key returns 401 unauthorized","Rate limit exceeded returns 429 too many requests","Payment not provided or insufficient returns 402 payment required"],"whenToPreferThis":"Use this endpoint when you need to hydrate profile data for multiple known Farcaster users simultaneously (by FID or address) without making individual per-user calls. Prefer this over single-user lookup when you already have a list of FIDs and need to minimize round trips.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:35:57.867Z","isFirstParty":false}