GET
/
casts
Casts
curl --request GET \
  --url https://api.pinata.cloud/v3/farcaster/casts \
  --header 'Authorization: Bearer <token>'
{
  "casts": [
    {
      "author": {
        "active_status": "inactive",
        "custody_address": "0x7f9a6992a54dc2f23f1105921715bd61811e5b71",
        "display_name": "Justin Hunter",
        "fid": 4823,
        "follower_count": 26787,
        "following_count": 924,
        "object": "user",
        "pfp_url": "https://i.seadn.io/gae/lhGgt7yK1JiBVYz_HBxcAmYLRtP03aw5xKX4FgmFT9Ai7kLD5egzlLvb0lkuRNl28shtjr07DC8IHzLUkTqlWUMndUzC9R5_MSxH3g?w=500&auto=format",
        "power_badge": true,
        "profile": {
          "bio": {
            "mentioned_profiles": [],
            "text": "Writer. Building @pinatacloud. Tinkering with a Farcaster native alternative to GoodReads: https://readcast.xyz \\ https://polluterofminds.com"
          }
        },
        "username": "polluterofminds",
        "verifications": [
          "0xcdcdc174901b12e87cc82471a2a2bd6181c89392",
          "0x1612c6dff0eb5811108b709a30d8150495ce9cc5"
        ],
        "verified_addresses": {
          "eth_addresses": [
            "0xcdcdc174901b12e87cc82471a2a2bd6181c89392",
            "0x1612c6dff0eb5811108b709a30d8150495ce9cc5"
          ],
          "sol_addresses": []
        }
      },
      "embeds": [
        {
          "url": "https://x.com/matthew_d_green/status/1789687898863792453?s=46"
        }
      ],
      "hash": "0xddc971b2ae7188c739627cc3ff519f1a5ce0ffde",
      "mentioned_profiles": [],
      "object": "cast",
      "parent_author": {
        "fid": null
      },
      "parent_hash": null,
      "parent_url": "https://warpcast.com/~/channel/privacy",
      "reactions": {
        "likes": [
          {
            "fid": 2777,
            "fname": "alexbruno.eth"
          },
          {
            "fid": 533877,
            "fname": "bura7501"
          },
          {
            "fid": 288646,
            "fname": "sebek"
          },
          {
            "fid": 5491,
            "fname": "pauldowman.eth"
          },
          {
            "fid": 5016,
            "fname": "stas"
          }
        ],
        "likes_count": 7,
        "recasts": [
          {
            "fid": 533877,
            "fname": "bura7501"
          },
          {
            "fid": 5016,
            "fname": "stas"
          }
        ],
        "recasts_count": 2
      },
      "replies": {
        "count": 2
      },
      "root_parent_url": "https://warpcast.com/~/channel/privacy",
      "text": "Telegram has never made much sense to me. But I’ve largely resigned myself to having lost the battle in crypto and am forced to use it daily. https://x.com/matthew_d_green/status/1789687898863792453?s=46",
      "thread_hash": "0xddc971b2ae7188c739627cc3ff519f1a5ce0ffde",
      "timestamp": "2024-05-13T13:30:18.000Z"
    }
  ],
  "next": {
    "cursor": "eyJ0aW1lc3RhbXAiOiIyMDI0LTA1LTEzIDEzOjMwOjE4LjAwMDAwMDAifQ%3D%3D"
  }
}

This endpoint is great for fetching a particular cast or by combining with query parameters to get specific lists of casts.

​
Casts by FID

/casts?fid=6023

Returns all the casts from user FID 6023

​
Casts by Following

/casts?fid=6023&following=true

Returns all the casts from users that FID 6023 is following

​
Casts by Channel

/casts?channel=pinata

Returns all the casts from a specific channel, e.g. pinata

​
Casts by Parent Hash

Returns all the casts fror a specified parent hash

/casts?parentHash=0x0ab851ba8524eedf9e164b55f6eeec751f74b539

The timestamps returned by the Hub are working off an epoch of 1609459200 or January 1, 2021 UTC. Keep this in mind when parsing the time of posted casts.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
fid
integer

Returns casts from a specific FID

Example:

4823

​
following
boolean

When used in combination of fid will return the casts for who that fid is following

Example:

true

​
reverse
boolean

Will reverse the results giving the most casts recent first

Example:

true

​
channel
string

Specify a channel to fetch casts from

Example:

"pinata"

​
parentHash
string

Returns casts for a specific parent hash

Example:

"0x0ab851ba8524eedf9e164b55f6eeec751f74b539"

​
pageToken
string

Token to be used for the next page of results

Example:

"eyJvZmZzZXQiOiIwIn0"

​
topLevel
boolean

Filter casts that have no parent hash

Example:

true

​
pageSize
integer

Determine the number of results, if not specified default is 100

Example:

10

Response

200 - application/json

OK

The response is of type object.