# Neynar Farcaster Bulk User Lookup

> Neynar Farcaster Bulk User Lookup is a paid API for AI agents from api.neynar.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Fetches profile data for multiple Farcaster users in a single bulk GET request by FID or address

## Facts

- Endpoint: GET https://api.neynar.com/v2/farcaster/user/bulk/
- 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/neynar-farcaster-bulk-user-lookup-e65fdf5b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wQNGW36PM1XxZAwGZCk4K

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 neynar-farcaster-bulk-user-lookup-e65fdf5b
```

Example prompt: Look up the Farcaster profiles for FIDs 2, 194, and 3621 — I need their display names, bios, follower counts, and verified Ethereum addresses.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Complete Farcaster developer platform

## Output

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.

## Example request

```json
{
 "fids": [
  2,
  194,
  3621
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/neynar-farcaster-bulk-user-lookup-e65fdf5b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.neynar.com](https://www.zero.xyz/host/api.neynar.com/llms.txt)