# Farcaster Intel API - Trending Topics

> Farcaster Intel API - Trending Topics is a paid API for AI agents from farcaster-intel-api.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns trending topics, top casts, and a summary of what's popular on Farcaster within a specified time window

## Facts

- Endpoint: GET https://farcaster-intel-api.vercel.app/api/trending
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/farcaster-intel-api-trending-topics-ccd34ba4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tDWCJHgwLv4TMeuYBCHoj

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-trending-topics-ccd34ba4
```

Example prompt: What's trending on Farcaster right now? Pull the top topics and most-reacted casts from the last 6 hours and give me a summary.

## When to prefer this

Use this endpoint when you need structured, agent-ready trend intelligence from Farcaster — particularly for monitoring what topics and casts are gaining traction on the decentralized social network. Prefer this over scraping Farcaster directly or using generic social listening tools when you need clean, pre-aggregated data with cast counts and reaction metrics in a single API call.

## Known failure modes

- Invalid time window format returns a 400 error
- Payment not included or rejected results in a 402 Payment Required response
- Farcaster data source temporarily unavailable causes 503 or empty results
- Rate limiting if too many requests are made in quick succession
- No trending data available for the specified window returns empty arrays

## How this service works

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

## Output

Returns a structured JSON object containing: an array of trending topics (each with topic name, top cast text, and cast count), the time window queried, a human-readable summary of trends, an array of top casts (with text, author, reaction count, and timestamp), and a fetched_at datetime.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "window": {
   "enum": [
    "1h",
    "6h",
    "24h"
   ],
   "type": "string",
   "description": "Time window for trending data (default: 6h)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "topics": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "topic": {
      "type": "string"
     },
     "top_cast": {
      "type": "string"
     },
     "cast_count": {
      "type": "integer"
     }
    }
   }
  },
  "window": {
   "type": "string"
  },
  "summary": {
   "type": "string"
  },
  "top_casts": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "text": {
      "type": "string"
     },
     "author": {
      "type": "string"
     },
     "reactions": {
      "type": "integer"
     },
     "timestamp": {
      "type": "string"
     }
    }
   }
  },
  "fetched_at": {
   "type": "string",
   "format": "date-time"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/farcaster-intel-api-trending-topics-ccd34ba4/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)