Retrieve the conversation for a given cast

farcasterCast.getConversation

Overview

Gets all casts related to a conversation surrounding a cast by passing in a cast hash or Warpcast URL. Includes all the ancestors of a cast up to the root parent in a chronological order. Includes all direct_replies to the cast up to the reply_depth specified in the query parameter.

Parameters

name
type
required
Note

identifier

string

true

ex) "https://warpcast.com/lum0x/0xfa6e2aad" or "0xfa6e2aad1b1cb8fd7037b93382c68264f77c00be"

type

string

true

"url" or "hash"

reply_depth

number

false

default: 2, max: 5

include_chronological_parent_casts

boolean

false

true or false

viewer_fid

number

false

ex) 3

limit

number

false

default: 20, max: 50

cursor

string

false

ex) eyJwYWdlIjoyfQ==

Usage

let res = await Lum0x.farcasterCast.getConversation({
    identifier: "0xfa6e2aad1b1cb8fd7037b93382c68264f77c00be",
    type: "hash"
});
console.log(JSON.stringify(res, null, 2));

Response

{
  "conversation": {
    "cast": {
      "object": "cast",
      "hash": "0xfa6e2aad1b1cb8fd7037b93382c68264f77c00be",
      "thread_hash": "0xfa6e2aad1b1cb8fd7037b93382c68264f77c00be",
      "parent_hash": null,
      "parent_url": null,
      "root_parent_url": null,
      "parent_author": {
        "fid": null
      },
      "author": {
        "object": "user",
        "fid": 721870,
        "custody_address": "0x63cd09948b05e5d8367226b0c83a16b583862191",
        "username": "lum0x",
        "display_name": "Lum0x",
        "pfp_url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/74970e01-bcf7-4ef7-31d7-238f5814b200/original",
        "profile": {
          "bio": {
            "text": "illuminate your builder journey with Lum0x πŸ’‘\n\nhttps://lum0x.com/"
          }
        },
        "follower_count": 37,
        "following_count": 2,
        "verifications": [],
        "verified_addresses": {
          "eth_addresses": [],
          "sol_addresses": []
        },
        "active_status": "inactive",
        "power_badge": false
      },
      "text": "πŸ‘€βœ¨ Something luminous is coming to Farcaster... \n\nBuilders, are you ready to see your data in a whole new light?",
      "timestamp": "2024-06-27T06:01:14.000Z",
      "embeds": [
        {
          "url": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/1b45d600-0075-4494-969c-db5c6f6ce500/original",
          "metadata": {
            "content_type": "image/jpeg",
            "content_length": "169601",
            "_status": "RESOLVED",
            "image": {
              "width_px": 800,
              "height_px": 600
            }
          }
        }
      ],
      "reactions": {
        "likes_count": 1,
        "recasts_count": 1,
        "likes": [
          {
            "fid": 5303,
            "fname": "zk-yuki.eth"
          }
        ],
        "recasts": [
          {
            "fid": 373908,
            "fname": "ty-kindleplus"
          }
        ]
      },
      "replies": {
        "count": 0
      },
      "channel": null,
      "mentioned_profiles": [],
      "direct_replies": []
    }
  },
  "next": {
    "cursor": null
  }
}

ν•­λͺ©

κ°’

Cast Hash

0xfa6e2aad1b1cb8fd7037b93382c68264f77c00be

Thread Hash

0xfa6e2aad1b1cb8fd7037b93382c68264f77c00be

Parent Hash

μ—†μŒ

Parent URL

μ—†μŒ

Root Parent URL

μ—†μŒ

Parent Author

μ—†μŒ

Author FID

721870

Custody Address

0x63cd09948b05e5d8367226b0c83a16b583862191

Username

lum0x

Display Name

Lum0x

Profile Picture URL

Bio

illuminate your builder journey with Lum0x πŸ’‘\n\nhttps://lum0x.com/

Follower Count

37

Following Count

2

Verifications

μ—†μŒ

Verified ETH Addresses

μ—†μŒ

Verified SOL Addresses

μ—†μŒ

Active Status

inactive

Text

πŸ‘€βœ¨ Something luminous is coming to Farcaster... \n\nBuilders, are you ready to see your data in a whole new light?

Timestamp

2024-06-27T06:01:14.000Z

Embeds URL

Likes Count

1

Recasts Count

1

Likes

zk-yuki.eth (FID: 5303)

Recasts

ty-kindleplus (FID: 373908)

Replies Count

0

Channel

μ—†μŒ

Mentioned Profiles

μ—†μŒ

Direct Replies

μ—†μŒ

Field Description

  • Cast Hash: The unique hash value of the cast.

  • Thread Hash: The hash value of the thread containing the cast.

  • Parent Hash: The hash value of the parent cast (currently none).

  • Parent URL: The URL of the parent cast (currently none).

  • Root Parent URL: The URL of the root parent cast (currently none).

  • Parent Author: The author of the parent cast (currently none).

  • Author FID: The author's unique identifier (FID).

  • Custody Address: The author's wallet address.

  • Username: The author's username.

  • Display Name: The author's display name.

  • Profile Picture URL: The URL of the author's profile picture.

  • Bio: The author's introduction text.

  • Follower Count: The number of followers the author has.

  • Following Count: The number of people the author is following.

  • Verifications: The author's verification information (currently none).

  • Verified ETH Addresses: List of verified Ethereum addresses (currently none).

  • Verified SOL Addresses: List of verified Solana addresses (currently none).

  • Active Status: The author's activity status.

  • Text: The content of the cast.

  • Timestamp: The time when the cast was created.

  • Embeds URL: URL of the embedded image.

  • Likes Count: The number of likes on the cast.

  • Recasts Count: The number of recasts of the cast.

  • Likes: List of users who liked the cast.

  • Recasts: List of users who recast the cast.

  • Replies Count: The number of replies to the cast.

  • Channel: The channel containing the cast (currently none).

  • Mentioned Profiles: List of profiles mentioned in the cast (currently none).

  • Direct Replies: Direct replies to the cast (currently none).

Last updated