# Farcaster Intel API – Channel Intelligence

> Farcaster Intel API – Channel Intelligence is a paid API for AI agents from farcaster-intel-api.vercel.app, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-15).

Returns structured intelligence about a Farcaster channel including summary, top casters, top cast, engagement metrics, and trending topics

## Facts

- Endpoint: GET https://farcaster-intel-api.vercel.app/api/channel
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/farcaster-intel-api-channel-intelligence-46c4792e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_09aB6pwJkuuHmXHPX1FYJ

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 farcaster-intel-api-channel-intelligence-46c4792e
```

Example prompt: What's going on in the Farcaster /base channel — who are the top casters, what topics are trending, and what's the most reacted cast recently?

## When to prefer this

Use this endpoint when you need structured, pre-aggregated analytics about a specific Farcaster channel — including who the top contributors are, what's trending, and engagement benchmarks — without having to query the raw Farcaster API yourself. Ideal for AI agents that need channel-level social intelligence on demand with pay-per-query pricing via x402 on Base.

## Known failure modes

- Invalid or non-existent channel name returns error or empty result
- Payment failure (402) if USDC/x402 payment not properly included
- Rate limiting or upstream Farcaster API unavailability
- Channel with very low activity may return sparse data (low cast_count_sampled)
- Network timeout from Vercel edge function

## How this service works

Structured Farcaster intelligence for AI agents. Pay per query in USDC on Base via x402.

## Output

Returns a JSON object with: channel_id, fetched_at timestamp, a natural-language summary, an array of trending topics, top_casters list (fid, username, cast_count, total_reactions), top_cast details (text, author, reactions, timestamp), average engagement score, and sampled cast count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "name"
 ],
 "properties": {
  "name": {
   "type": "string",
   "description": "Channel ID (e.g. base, farcaster, ai, nounsdao)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "topics": {
   "type": "array",
   "items": {
    "type": "string"
   }
  },
  "summary": {
   "type": "string"
  },
  "top_cast": {
   "type": "object",
   "properties": {
    "text": {
     "type": "string"
    },
    "author": {
     "type": "string"
    },
    "reactions": {
     "type": "integer"
    },
    "timestamp": {
     "type": "string"
    }
   }
  },
  "channel_id": {
   "type": "string"
  },
  "fetched_at": {
   "type": "string",
   "format": "date-time"
  },
  "top_casters": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "fid": {
      "type": "integer"
     },
     "username": {
      "type": "string"
     },
     "cast_count": {
      "type": "integer"
     },
     "total_reactions": {
      "type": "integer"
     }
    }
   }
  },
  "avg_engagement": {
   "type": "number"
  },
  "cast_count_sampled": {
   "type": "integer"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/farcaster-intel-api-channel-intelligence-46c4792e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from farcaster-intel-api.vercel.app](https://www.zero.xyz/host/farcaster-intel-api.vercel.app/llms.txt)
