# Agent402 Farcaster Channel Lookup

> Agent402 Farcaster Channel Lookup is a paid API for AI agents from agent402.tools, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Fetches metadata for a Farcaster channel by its ID or parent URL, including follower count, member count, moderators, and description.

## Facts

- Endpoint: POST https://agent402.tools/api/fc-channel
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-farcaster-channel-lookup-c1b0e165
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3WjxNktqeW1oehOPHFPB9

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 agent402-farcaster-channel-lookup-c1b0e165 -d '<json body>'
```

Example prompt: Can you look up the Farcaster channel with ID 'base' and tell me its follower count, member count, lead user, and description?

## When to prefer this

Use this endpoint when you need structured metadata about a specific Farcaster/Warpcast channel — its follower count, member list size, moderators, or description — and you have the channel ID or its parent URL. It's backed by Neynar, a leading Farcaster indexer, and returns richer per-channel detail than a general social graph search. Prefer it over scraping Warpcast directly or using a generic social API that doesn't understand Farcaster's channel model.

## Known failure modes

- Invalid or unknown channel ID returns an error or empty result
- Malformed parent URL input may fail to resolve to a channel
- Rate limit exceeded: rateLimit.remaining reaches 0 before resetAt
- Neynar upstream outage causes lookup failure
- Channel ID string typo returns null or not-found response

## How this service works

Details for one Farcaster channel by id (e.g. base) or FIP-2 parent URL: name, description, follower and member counts, public-casting flag, creation date, lead and moderator fids, pinned cast. Use to validate a channel id before pulling its feed, or to size a community.

## Output

Returns a JSON object with the channel's id, name, URL, description, imageUrl, createdAt timestamp, parentUrl, memberCount, followerCount, publicCasting flag, pinnedCastHash, moderatorFids, and lead user details (fid, username, displayName, followerCount). Also includes a fetchedAt timestamp, cache status, source attribution (Neynar), and rate limit info (limit, remaining, resetAt).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "id": {
   "type": "string",
   "description": "Channel id (e.g. base) or its https parent URL."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cached": false,
  "source": "neynar",
  "channel": {
   "id": "base",
   "url": "https://warpcast.com/~/channel/base",
   "lead": {
    "fid": 12142,
    "username": "base.base.eth",
    "displayName": "Base",
    "followerCount": 194536
   },
   "name": "Base",
   "imageUrl": "https://warpcast.com/~/channel-images/base.png",
   "createdAt": "2023-08-17T19:23:11.150Z",
   "parentUrl": "https://onchainsummer.xyz",
   "description": "Bringing the world onchain - a community of builders on Base",
   "memberCount": 813,
   "followerCount": 481202,
   "moderatorFids": [
    12142,
    15211,
    99
   ],
   "publicCasting": false,
   "pinnedCastHash": null
  },
  "fetchedAt": "2026-08-22T13:19:12.000Z",
  "rateLimit": {
   "limit": 300,
   "resetAt": "2026-08-22T13:20:00.000Z",
   "remaining": 299
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-farcaster-channel-lookup-c1b0e165/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)