Neynar Agents API

Operations for building AI agents

Documentation Provider Profile APIs.io OpenAPI GitHub

This API exposes 3 operations across 3 paths, and defines 61 schemas. It is described by OpenAPI 3.0.4, at version 3.176.0.

Requests are made against a single base URL, https://api.neynar.com.

3 operations 3 paths 61 schemas 2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification

OpenAPI 3.0.4

API Version

3.176.0

Base URL

https://api.neynar.com

Authentication

API Key

Contact

Neynar

Resource Areas

Authentication & Security 1

Neynar Agents API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (ApiKeyAuth). By default, every request must be authenticated.

ApiKeyAuth — API key to authorize requests

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 2 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Agents 3

Operations for building AI agents

GET

/v2/farcaster/cast/conversation/summary/

Cast conversation summary

lookup-cast-conversation-summary 3 params → 200400

POST

/v2/farcaster/frame/transaction/pay/

Create transaction pay mini app

create-transaction-pay-frame body → 200400401500

GET

/v2/farcaster/user/interactions/

User interactions

fetch-user-interactions 2 params → 200400

Schemas 61

The contract defines 61 schemas that model the data the API accepts and returns. The most detailed are HtmlMetadata (50 properties), Cast (22 properties), Channel (19 properties), User (18 properties). Each schema is shown below with its type and property counts.

ChannelUserContext

object

Adds context on the viewer's or author's role in the channel.

2 properties 1 required

TransactionFramePay

object

6 properties 6 required

Follower

object

3 properties 2 required

CastEmbedded

object

11 properties 10 required

TransactionFrameAction

object

Action button for primary CTA on the transaction mini app

3 properties

SolAddress

string

Solana address

FrameV1

object

Mini app v1 object

9 properties 3 required

Notification

object

8 properties 4 required

FrameButtonActionType

string

The action type of a mini app button. Action types "mint" & "link" are to be handled on the client side only and so they will produce a no/op for POST /farcast…

User

object

18 properties 12 required

Embed

TransactionFrameResponse

object

1 property 1 required

ChannelMemberRole

string

The role of a channel member

OembedVideoData

object

Video OEmbed data

14 properties 3 required

UserViewerContext

object

Adds context on the viewer's follow relationship with the user.

4 properties 4 required

TransactionFrame

object

EmbedUrl

object

2 properties 1 required

CastDehydrated

object

4 properties 2 required

EthAddress

string

Ethereum address

FarcasterManifest

object

3 properties 1 required

OembedRichData

object

Rich OEmbed data

14 properties 3 required

Location

object

Coordinates and place names for a location

4 properties 2 required

FramePayTransactionReqBody

object

3 properties 2 required

ImageObject

object

5 properties 1 required

ChannelOrChannelDehydrated

object

UserDehydrated

object

7 properties 2 required

FrameV2

object

Mini app v2 object

7 properties 3 required

ChannelDehydrated

object

5 properties 3 required

OembedLinkData

object

Link OEmbed data

11 properties 2 required

EmbedCastDeep

object

2 properties 1 required

CastReplies

object

1 property 1 required

Network

string

A blockchain network e.g. "ethereum", "optimism", "base", "arbitrum"

LocationAddress

object

5 properties 2 required

VideoObject

object

4 properties 1 required

TransactionFrameDestination

object

4 properties 4 required

HtmlMetadata

object

50 properties

EmbedCast

object

2 properties 1 required

Frame

EmbedUrlMetadata

object

7 properties 1 required

ReactionRecast

object

2 properties 2 required

Idem

string

An Idempotency key is a unique identifier for the request. Note: 1) This is used to prevent duplicate requests. Use the same idem key on retry attempts. 2) Thi…

ConversationSummary

object

1 property 1 required

ErrorRes

object

Details for the error response

4 properties 1 required

OembedPhotoData

object

Photo OEmbed data

14 properties 3 required

TextRange

object

2 properties 2 required

TransactionFrameLineItem

object

3 properties 2 required

EmbedDeep

CastViewerContext

object

Adds context on interactions the viewer has made with the cast.

2 properties 2 required

CastReactions

object

4 properties 4 required

TransactionFrameType

string

Type of transaction mini app

TransactionFrameStatus

string

Cast

object

22 properties 18 required

FrameActionButton

object

5 properties 2 required

ReactionLike

object

2 properties 2 required

TransactionFrameConfig

object

3 properties 1 required

EncodedJsonFarcasterSignature

object

Encoded JSON Farcaster signature

3 properties 3 required

CastNotificationType

string

The notification type of a cast.

Channel

object

19 properties 4 required

CastId

object

[DEPRECATED: Use "cast" key instead]

2 properties 2 required

ReactionWithUserInfo

object

3 properties 3 required

Fid

integer

The unique identifier of a farcaster user or app (unsigned integer)

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

#Agents

← Back to N APIs

Discovery

Learnings

Guidance

Toolbox

Alignment

API Evangelist LLC

Neynar Agents API

Metadata

Authentication & Security 1

Paths & Operations 3

Schemas 61

Specification

Source

API Details

Provider

Explore more