# Farcaster Intel API - User Profile Lookup

> Farcaster Intel API - User Profile Lookup is a paid API for AI agents from farcaster-intel-api.vercel.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-12).

Fetches structured intelligence about a Farcaster user including reputation score, interests, verified addresses, and engagement metrics

## Facts

- Endpoint: GET https://farcaster-intel-api.vercel.app/api/user?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/farcaster-intel-api-user-profile-lookup-2bddbff4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EFMIX8DKSABJMSwVF6GBY

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-user-profile-lookup-2bddbff4
```

Example prompt: Can you pull up Farcaster intelligence on the user 'dwr' — I want to know their reputation score, interests, verified wallet addresses, and whether they're considered a high-quality account?

## When to prefer this

Use this endpoint when you need structured, agent-optimized Farcaster user intelligence in a single call, especially when you need reputation scoring, inferred interests, or verified wallet address resolution. Prefer this over raw Farcaster/Neynar APIs when you want pre-processed, normalized output designed for AI agent consumption with pay-per-query pricing.

## Known failure modes

- Username not found — returns 404 or empty result if the Farcaster username does not exist
- Missing username parameter — returns 400 bad request if 'username' is not provided
- Payment failure — x402 payment in USDC on Base not processed, returns 402 Payment Required
- Rate limiting — too many requests may result in throttling
- Stale data — profile data may lag behind real-time Farcaster state if caching is in place

## 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 with the user's Farcaster ID, bio, display name, follower/following counts, engagement rate, inferred interest tags, top channels, verified Ethereum addresses, power badge status, activity status, a composite account quality score (0-100), a Neynar reputation score (0-1), a reputation label (high/medium/low/spam), and a one-line agent-readable summary.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "username"
 ],
 "properties": {
  "username": {
   "type": "string",
   "description": "Farcaster username without the @ symbol"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bio": {
   "type": "string"
  },
  "fid": {
   "type": "integer",
   "description": "Farcaster ID"
  },
  "summary": {
   "type": "string",
   "description": "One-line agent-readable summary"
  },
  "username": {
   "type": "string"
  },
  "interests": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Inferred topic tags from recent casts"
  },
  "power_badge": {
   "type": "boolean"
  },
  "display_name": {
   "type": "string"
  },
  "top_channels": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Up to 3 channel IDs user recently cast in"
  },
  "follower_count": {
   "type": "integer"
  },
  "account_quality": {
   "type": "integer",
   "description": "Composite quality score 0-100"
  },
  "engagement_rate": {
   "type": "number",
   "description": "Avg reactions+replies per cast (last 5 casts)"
  },
  "following_count": {
   "type": "integer"
  },
  "reputation_label": {
   "enum": [
    "high",
    "medium",
    "low",
    "spam"
   ],
   "type": "string"
  },
  "reputation_score": {
   "type": "number",
   "description": "Neynar reputation score 0-1.0"
  },
  "verified_addresses": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Verified Ethereum wallet addresses"
  },
  "active_on_farcaster": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/farcaster-intel-api-user-profile-lookup-2bddbff4/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)