Neynar Casts API

Operations related to casts.

Documentation Provider Profile APIs.io OpenAPI GitHub

This API exposes 4 operations across 4 paths, and defines 17 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.

4 operations 4 paths 17 schemas 4 GET

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 Casts 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 4

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

Casts 4

Operations related to casts.

GET

/v1/castById

By FID and Hash

lookup-cast-by-hash-and-fid 2 params → 200default

GET

/v1/castsByFid

By FID

fetch-users-casts 4 params → 200default

GET

/v1/castsByMention

Mentioning an FID

fetch-casts-mentioning-user 4 params → 200default

GET

/v1/castsByParent

By parent cast

fetch-casts-by-parent 6 params → 200default

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are CastAddBody (7 properties), ErrorResponse (6 properties), MessageCommon (5 properties), MessageDataCommon (4 properties). Each schema is shown below with its type and property counts.

PaginationResponse

object

1 property 1 required

CastAdd

CastEmbed

object

1 property 1 required

Embed

FidSchema

integer

Farcaster ID (FID). A unique identifier assigned to each user in the Farcaster network. This number is permanent and cannot be changed. FIDs are assigned seque…

SignatureScheme

string

Type of signature scheme used to sign the Message hash - SIGNATURESCHEMEED25519: Ed25519 signature (default) - SIGNATURESCHEMEEIP712: ECDSA signature using EIP…

FarcasterNetwork

string

Farcaster network the message is intended for. - FARCASTERNETWORKMAINNET: Public primary network - FARCASTERNETWORKTESTNET: Public test network - FARCASTERNETW…

MessageCommon

object

5 properties 5 required

UrlEmbed

object

1 property 1 required

MessageType

string

Type of the MessageBody. - MESSAGETYPECASTADD: Add a new Cast - MESSAGETYPECASTREMOVE: Remove an existing Cast - MESSAGETYPEREACTIONADD: Add a Reaction to a Ca…

HashScheme

string

Type of hashing scheme used to produce a digest of MessageData. - HASHSCHEMEBLAKE3: Default scheme for hashing MessageData

CastHash

string

A unique hash that identifies a specific cast within the creator's posts. Generated using HASHSCHEMEBLAKE3 of the cast's content.

ErrorResponse

object

6 properties 6 required

MessageDataCastAdd

Represents a new cast (post) being created in the Farcaster network. A cast can include text content, mentions of other users, embedded URLs, and references to…

MessageDataCommon

object

Common properties shared by all Farcaster message types. These properties provide essential metadata about the message's origin, timing, and network context.

4 properties 3 required

CastId

object

A unique identifier for a cast (post) in the Farcaster network, consisting of the creator's FID and a hash of the cast's content. This combination ensures glob…

2 properties 2 required

CastAddBody

object

Adds a new Cast

7 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

#Casts

← Back to N APIs

Discovery

Learnings

Guidance

Toolbox

Alignment

API Evangelist LLC

Neynar Casts API

Metadata

Authentication & Security 1

Paths & Operations 4

Schemas 17

Specification

Source

API Details

Provider

Explore more