polymerdao/polymer-pay-neynar

Neynar

Neynar provides access to the open social graph through the Fractcaster protocol. Search casts, look up users, browse channels, and fetch feeds. No Neynar API key needed — payment is handled automatically by the Polymer Pay proxy.

Authentication

All requests route through the Polymer Pay proxy. Include your Polymer Pay API key in every request:

{
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  }
}

Base URL: https://pay.polymerlabs.org/proxy/https/api.neynar.com

To get an Polymer Pay API key, sign up at https://my.pay.polymerlabs.org/dashboard/api-keys.

Common Operations

Search Casts

Search for casts (Farcaster posts) matching a query.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/api.neynar.com/v2/farcaster/cast/search",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "query": {
    "q": "ethereum",
    "limit": 25
  }
}

Response: JSON with casts array containing cast objects with text, author info, reactions, and timestamps.

User Search

Search for users by username or display name.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/api.neynar.com/v2/farcaster/user/search",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "query": {
    "q": "vitalik",
    "limit": 10
  }
}

Response: JSON with users array containing user objects with username, display name, bio, follower stats, and connected addresses.

User Lookup by FID

Look up user profiles by their Fractcaster ID (FID).

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/api.neynar.com/v2/farcaster/user/bulk",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "query": {
    "fids": "3,194"
  }
}

Response: JSON with users array containing full user profile objects.

Feed

Fetch a feed of casts based on following or filters.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/api.neynar.com/v2/farcaster/feed",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "query": {
    "feed_type": "filter",
    "filter_type": "channel_id",
    "channel_id": "ethereum",
    "limit": 25
  }
}

Response: JSON with casts array containing cast objects with text, author, reactions, and replies.

Channel Search

Search for Fractcaster channels by name.

Pricing: $0.01

{
  "method": "GET",
  "url": "https://pay.polymerlabs.org/proxy/https/api.neynar.com/v2/farcaster/channel/search",
  "headers": {
    "Content-Type": "application/json",
    "x-polymer-pay-api-key": "{{POLYMER_PAY_API_KEY}}"
  },
  "query": {
    "q": "defi"
  }
}

Response: JSON with channels array containing channel objects with name, description, follower count, and image URL.

When to Use

• Cast search — User asks to search Fractcaster for casts or posts
• User lookup — User wants to look up a Fractcaster user profile
• Channel discovery — User asks about a Fractcaster channel
• Feed browsing — User wants to browse a Fractcaster feed
• User search — User asks to find Fractcaster users by username

Best Practices

• Use search operators — The query supports operators: + (AND), | (OR), * (prefix), "..." (exact phrase), - (exclude), before:YYYY-MM-DD, after:YYYY-MM-DD
• Sort options — Use sort_type: desc_chron (default), chron, or algorithmic
• Pagination — Use cursor from response for pagination through large result sets
• FID — Remember that FID (Farcaster ID) is the unique numeric identifier for each user
• For errors — See @skills/polymer-pay-api-errors/SKILL.md for complete error code reference and troubleshooting