Farcaster
Deploy onchain
Farcaster Hub API
Neynar SDK
curl --request GET \
--url https://api.neynar.com/v2/farcaster/cast/search/ \
--header 'x-api-key: <api-key>'{
"result": {
"casts": [
{
"object": "cast",
"hash": "<string>",
"parent_hash": "<string>",
"parent_url": "<string>",
"root_parent_url": "<string>",
"parent_author": {
"fid": 3
},
"author": {
"object": "user",
"fid": 3,
"username": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"profile": {
"bio": {
"text": "<string>",
"mentioned_profiles": [
{
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
],
"mentioned_profiles_ranges": [
{
"start": 1,
"end": 1
}
],
"mentioned_channels": [
{
"id": "<string>",
"name": "<string>",
"object": "channel_dehydrated",
"image_url": "<string>",
"viewer_context": {
"following": true,
"role": "member"
}
}
],
"mentioned_channels_ranges": [
{
"start": 1,
"end": 1
}
]
},
"location": {
"latitude": 0,
"longitude": 0,
"address": {
"city": "<string>",
"country": "<string>",
"state": "<string>",
"state_code": "<string>",
"country_code": "<string>"
},
"radius": 1
},
"banner": {
"url": "<string>"
}
},
"follower_count": 123,
"following_count": 123,
"verifications": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"auth_addresses": [
{
"address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
}
],
"verified_addresses": {
"eth_addresses": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"sol_addresses": [
"<string>"
],
"primary": {
"eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"sol_address": "<string>"
}
},
"verified_accounts": [
{
"platform": "x",
"username": "<string>"
}
],
"display_name": "<string>",
"pro": {
"status": "subscribed",
"subscribed_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
},
"pfp_url": "<string>",
"experimental": {
"neynar_user_score": 123,
"deprecation_notice": "<string>"
},
"viewer_context": {
"following": true,
"followed_by": true,
"blocking": true,
"blocked_by": true
},
"score": 123
},
"text": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"embeds": [
{
"cast": {
"hash": "<string>",
"parent_hash": "<string>",
"parent_url": "<string>",
"root_parent_url": "<string>",
"parent_author": {
"fid": 3
},
"author": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
},
"text": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"embeds": [
{
"cast": {
"object": "cast_dehydrated",
"hash": "<string>",
"author": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
},
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
},
"cast_id": {
"fid": 3,
"hash": "<string>"
}
}
],
"channel": {
"id": "<string>",
"name": "<string>",
"object": "channel_dehydrated",
"image_url": "<string>",
"viewer_context": {
"following": true,
"role": "member"
}
},
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
},
"cast_id": {
"fid": 3,
"hash": "<string>"
}
}
],
"reactions": {
"likes": [
{
"fid": 3,
"fname": "<string>"
}
],
"recasts": [
{
"fid": 3,
"fname": "<string>"
}
],
"likes_count": 123,
"recasts_count": 123
},
"replies": {
"count": 123
},
"thread_hash": "<string>",
"mentioned_profiles": [
{
"object": "user",
"fid": 3,
"username": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"profile": {
"bio": {
"text": "<string>",
"mentioned_profiles": [
{
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
],
"mentioned_profiles_ranges": [
{
"start": 1,
"end": 1
}
],
"mentioned_channels": [
{
"id": "<string>",
"name": "<string>",
"object": "channel_dehydrated",
"image_url": "<string>",
"viewer_context": {
"following": true,
"role": "member"
}
}
],
"mentioned_channels_ranges": [
{
"start": 1,
"end": 1
}
]
},
"location": {
"latitude": 0,
"longitude": 0,
"address": {
"city": "<string>",
"country": "<string>",
"state": "<string>",
"state_code": "<string>",
"country_code": "<string>"
},
"radius": 1
},
"banner": {
"url": "<string>"
}
},
"follower_count": 123,
"following_count": 123,
"verifications": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"auth_addresses": [
{
"address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
}
],
"verified_addresses": {
"eth_addresses": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"sol_addresses": [
"<string>"
],
"primary": {
"eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"sol_address": "<string>"
}
},
"verified_accounts": [
{
"platform": "x",
"username": "<string>"
}
],
"display_name": "<string>",
"pro": {
"status": "subscribed",
"subscribed_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
},
"pfp_url": "<string>",
"experimental": {
"neynar_user_score": 123,
"deprecation_notice": "<string>"
},
"viewer_context": {
"following": true,
"followed_by": true,
"blocking": true,
"blocked_by": true
},
"score": 123
}
],
"mentioned_profiles_ranges": [
{
"start": 1,
"end": 1
}
],
"mentioned_channels": [
{
"id": "<string>",
"name": "<string>",
"object": "channel_dehydrated",
"image_url": "<string>",
"viewer_context": {
"following": true,
"role": "member"
}
}
],
"mentioned_channels_ranges": [
{
"start": 1,
"end": 1
}
],
"channel": {
"id": "<string>",
"url": "<string>",
"object": "channel",
"created_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"description": "<string>",
"follower_count": 123,
"external_link": {
"title": "<string>",
"url": "<string>"
},
"image_url": "<string>",
"parent_url": "<string>",
"lead": {
"object": "user",
"fid": 3,
"username": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"profile": {
"bio": {
"text": "<string>",
"mentioned_profiles": [
{
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
],
"mentioned_profiles_ranges": [
{
"start": 1,
"end": 1
}
],
"mentioned_channels": [
{
"id": "<string>",
"name": "<string>",
"object": "channel_dehydrated",
"image_url": "<string>",
"viewer_context": {
"following": true,
"role": "member"
}
}
],
"mentioned_channels_ranges": [
{
"start": 1,
"end": 1
}
]
},
"location": {
"latitude": 0,
"longitude": 0,
"address": {
"city": "<string>",
"country": "<string>",
"state": "<string>",
"state_code": "<string>",
"country_code": "<string>"
},
"radius": 1
},
"banner": {
"url": "<string>"
}
},
"follower_count": 123,
"following_count": 123,
"verifications": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"auth_addresses": [
{
"address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
}
],
"verified_addresses": {
"eth_addresses": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"sol_addresses": [
"<string>"
],
"primary": {
"eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"sol_address": "<string>"
}
},
"verified_accounts": [
{
"platform": "x",
"username": "<string>"
}
],
"display_name": "<string>",
"pro": {
"status": "subscribed",
"subscribed_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
},
"pfp_url": "<string>",
"experimental": {
"neynar_user_score": 123,
"deprecation_notice": "<string>"
},
"viewer_context": {
"following": true,
"followed_by": true,
"blocking": true,
"blocked_by": true
},
"score": 123
},
"moderator_fids": [
3
],
"member_count": 123,
"moderator": {
"object": "user",
"fid": 3,
"username": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"profile": {
"bio": {
"text": "<string>",
"mentioned_profiles": [
{
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
],
"mentioned_profiles_ranges": [
{
"start": 1,
"end": 1
}
],
"mentioned_channels": [
{
"id": "<string>",
"name": "<string>",
"object": "channel_dehydrated",
"image_url": "<string>",
"viewer_context": {
"following": true,
"role": "member"
}
}
],
"mentioned_channels_ranges": [
{
"start": 1,
"end": 1
}
]
},
"location": {
"latitude": 0,
"longitude": 0,
"address": {
"city": "<string>",
"country": "<string>",
"state": "<string>",
"state_code": "<string>",
"country_code": "<string>"
},
"radius": 1
},
"banner": {
"url": "<string>"
}
},
"follower_count": 123,
"following_count": 123,
"verifications": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"auth_addresses": [
{
"address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
}
],
"verified_addresses": {
"eth_addresses": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"sol_addresses": [
"<string>"
],
"primary": {
"eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"sol_address": "<string>"
}
},
"verified_accounts": [
{
"platform": "x",
"username": "<string>"
}
],
"display_name": "<string>",
"pro": {
"status": "subscribed",
"subscribed_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
},
"pfp_url": "<string>",
"experimental": {
"neynar_user_score": 123,
"deprecation_notice": "<string>"
},
"viewer_context": {
"following": true,
"followed_by": true,
"blocking": true,
"blocked_by": true
},
"score": 123
},
"pinned_cast_hash": "0x71d5225f77e0164388b1d4c120825f3a2c1f131c",
"hosts": [
{
"object": "user",
"fid": 3,
"username": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"profile": {
"bio": {
"text": "<string>",
"mentioned_profiles": [
{
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
],
"mentioned_profiles_ranges": [
{
"start": 1,
"end": 1
}
],
"mentioned_channels": [
{
"id": "<string>",
"name": "<string>",
"object": "channel_dehydrated",
"image_url": "<string>",
"viewer_context": {
"following": true,
"role": "member"
}
}
],
"mentioned_channels_ranges": [
{
"start": 1,
"end": 1
}
]
},
"location": {
"latitude": 0,
"longitude": 0,
"address": {
"city": "<string>",
"country": "<string>",
"state": "<string>",
"state_code": "<string>",
"country_code": "<string>"
},
"radius": 1
},
"banner": {
"url": "<string>"
}
},
"follower_count": 123,
"following_count": 123,
"verifications": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"auth_addresses": [
{
"address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
}
],
"verified_addresses": {
"eth_addresses": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"sol_addresses": [
"<string>"
],
"primary": {
"eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"sol_address": "<string>"
}
},
"verified_accounts": [
{
"platform": "x",
"username": "<string>"
}
],
"display_name": "<string>",
"pro": {
"status": "subscribed",
"subscribed_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
},
"pfp_url": "<string>",
"experimental": {
"neynar_user_score": 123,
"deprecation_notice": "<string>"
},
"viewer_context": {
"following": true,
"followed_by": true,
"blocking": true,
"blocked_by": true
},
"score": 123
}
],
"viewer_context": {
"following": true,
"role": "member"
},
"description_mentioned_profiles": [
{
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
],
"description_mentioned_profiles_ranges": [
{
"start": 1,
"end": 1
}
]
},
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
},
"type": "cast-mention",
"viewer_context": {
"liked": true,
"recasted": true
},
"author_channel_context": {
"following": true,
"role": "member"
}
}
],
"next": {
"cursor": "<string>"
}
}
}Search for casts
Search for casts based on a query string, with optional AND filters
curl --request GET \
--url https://api.neynar.com/v2/farcaster/cast/search/ \
--header 'x-api-key: <api-key>'{
"result": {
"casts": [
{
"object": "cast",
"hash": "<string>",
"parent_hash": "<string>",
"parent_url": "<string>",
"root_parent_url": "<string>",
"parent_author": {
"fid": 3
},
"author": {
"object": "user",
"fid": 3,
"username": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"profile": {
"bio": {
"text": "<string>",
"mentioned_profiles": [
{
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
],
"mentioned_profiles_ranges": [
{
"start": 1,
"end": 1
}
],
"mentioned_channels": [
{
"id": "<string>",
"name": "<string>",
"object": "channel_dehydrated",
"image_url": "<string>",
"viewer_context": {
"following": true,
"role": "member"
}
}
],
"mentioned_channels_ranges": [
{
"start": 1,
"end": 1
}
]
},
"location": {
"latitude": 0,
"longitude": 0,
"address": {
"city": "<string>",
"country": "<string>",
"state": "<string>",
"state_code": "<string>",
"country_code": "<string>"
},
"radius": 1
},
"banner": {
"url": "<string>"
}
},
"follower_count": 123,
"following_count": 123,
"verifications": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"auth_addresses": [
{
"address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
}
],
"verified_addresses": {
"eth_addresses": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"sol_addresses": [
"<string>"
],
"primary": {
"eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"sol_address": "<string>"
}
},
"verified_accounts": [
{
"platform": "x",
"username": "<string>"
}
],
"display_name": "<string>",
"pro": {
"status": "subscribed",
"subscribed_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
},
"pfp_url": "<string>",
"experimental": {
"neynar_user_score": 123,
"deprecation_notice": "<string>"
},
"viewer_context": {
"following": true,
"followed_by": true,
"blocking": true,
"blocked_by": true
},
"score": 123
},
"text": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"embeds": [
{
"cast": {
"hash": "<string>",
"parent_hash": "<string>",
"parent_url": "<string>",
"root_parent_url": "<string>",
"parent_author": {
"fid": 3
},
"author": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
},
"text": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"embeds": [
{
"cast": {
"object": "cast_dehydrated",
"hash": "<string>",
"author": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
},
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
},
"cast_id": {
"fid": 3,
"hash": "<string>"
}
}
],
"channel": {
"id": "<string>",
"name": "<string>",
"object": "channel_dehydrated",
"image_url": "<string>",
"viewer_context": {
"following": true,
"role": "member"
}
},
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
},
"cast_id": {
"fid": 3,
"hash": "<string>"
}
}
],
"reactions": {
"likes": [
{
"fid": 3,
"fname": "<string>"
}
],
"recasts": [
{
"fid": 3,
"fname": "<string>"
}
],
"likes_count": 123,
"recasts_count": 123
},
"replies": {
"count": 123
},
"thread_hash": "<string>",
"mentioned_profiles": [
{
"object": "user",
"fid": 3,
"username": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"profile": {
"bio": {
"text": "<string>",
"mentioned_profiles": [
{
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
],
"mentioned_profiles_ranges": [
{
"start": 1,
"end": 1
}
],
"mentioned_channels": [
{
"id": "<string>",
"name": "<string>",
"object": "channel_dehydrated",
"image_url": "<string>",
"viewer_context": {
"following": true,
"role": "member"
}
}
],
"mentioned_channels_ranges": [
{
"start": 1,
"end": 1
}
]
},
"location": {
"latitude": 0,
"longitude": 0,
"address": {
"city": "<string>",
"country": "<string>",
"state": "<string>",
"state_code": "<string>",
"country_code": "<string>"
},
"radius": 1
},
"banner": {
"url": "<string>"
}
},
"follower_count": 123,
"following_count": 123,
"verifications": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"auth_addresses": [
{
"address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
}
],
"verified_addresses": {
"eth_addresses": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"sol_addresses": [
"<string>"
],
"primary": {
"eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"sol_address": "<string>"
}
},
"verified_accounts": [
{
"platform": "x",
"username": "<string>"
}
],
"display_name": "<string>",
"pro": {
"status": "subscribed",
"subscribed_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
},
"pfp_url": "<string>",
"experimental": {
"neynar_user_score": 123,
"deprecation_notice": "<string>"
},
"viewer_context": {
"following": true,
"followed_by": true,
"blocking": true,
"blocked_by": true
},
"score": 123
}
],
"mentioned_profiles_ranges": [
{
"start": 1,
"end": 1
}
],
"mentioned_channels": [
{
"id": "<string>",
"name": "<string>",
"object": "channel_dehydrated",
"image_url": "<string>",
"viewer_context": {
"following": true,
"role": "member"
}
}
],
"mentioned_channels_ranges": [
{
"start": 1,
"end": 1
}
],
"channel": {
"id": "<string>",
"url": "<string>",
"object": "channel",
"created_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"description": "<string>",
"follower_count": 123,
"external_link": {
"title": "<string>",
"url": "<string>"
},
"image_url": "<string>",
"parent_url": "<string>",
"lead": {
"object": "user",
"fid": 3,
"username": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"profile": {
"bio": {
"text": "<string>",
"mentioned_profiles": [
{
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
],
"mentioned_profiles_ranges": [
{
"start": 1,
"end": 1
}
],
"mentioned_channels": [
{
"id": "<string>",
"name": "<string>",
"object": "channel_dehydrated",
"image_url": "<string>",
"viewer_context": {
"following": true,
"role": "member"
}
}
],
"mentioned_channels_ranges": [
{
"start": 1,
"end": 1
}
]
},
"location": {
"latitude": 0,
"longitude": 0,
"address": {
"city": "<string>",
"country": "<string>",
"state": "<string>",
"state_code": "<string>",
"country_code": "<string>"
},
"radius": 1
},
"banner": {
"url": "<string>"
}
},
"follower_count": 123,
"following_count": 123,
"verifications": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"auth_addresses": [
{
"address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
}
],
"verified_addresses": {
"eth_addresses": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"sol_addresses": [
"<string>"
],
"primary": {
"eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"sol_address": "<string>"
}
},
"verified_accounts": [
{
"platform": "x",
"username": "<string>"
}
],
"display_name": "<string>",
"pro": {
"status": "subscribed",
"subscribed_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
},
"pfp_url": "<string>",
"experimental": {
"neynar_user_score": 123,
"deprecation_notice": "<string>"
},
"viewer_context": {
"following": true,
"followed_by": true,
"blocking": true,
"blocked_by": true
},
"score": 123
},
"moderator_fids": [
3
],
"member_count": 123,
"moderator": {
"object": "user",
"fid": 3,
"username": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"profile": {
"bio": {
"text": "<string>",
"mentioned_profiles": [
{
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
],
"mentioned_profiles_ranges": [
{
"start": 1,
"end": 1
}
],
"mentioned_channels": [
{
"id": "<string>",
"name": "<string>",
"object": "channel_dehydrated",
"image_url": "<string>",
"viewer_context": {
"following": true,
"role": "member"
}
}
],
"mentioned_channels_ranges": [
{
"start": 1,
"end": 1
}
]
},
"location": {
"latitude": 0,
"longitude": 0,
"address": {
"city": "<string>",
"country": "<string>",
"state": "<string>",
"state_code": "<string>",
"country_code": "<string>"
},
"radius": 1
},
"banner": {
"url": "<string>"
}
},
"follower_count": 123,
"following_count": 123,
"verifications": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"auth_addresses": [
{
"address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
}
],
"verified_addresses": {
"eth_addresses": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"sol_addresses": [
"<string>"
],
"primary": {
"eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"sol_address": "<string>"
}
},
"verified_accounts": [
{
"platform": "x",
"username": "<string>"
}
],
"display_name": "<string>",
"pro": {
"status": "subscribed",
"subscribed_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
},
"pfp_url": "<string>",
"experimental": {
"neynar_user_score": 123,
"deprecation_notice": "<string>"
},
"viewer_context": {
"following": true,
"followed_by": true,
"blocking": true,
"blocked_by": true
},
"score": 123
},
"pinned_cast_hash": "0x71d5225f77e0164388b1d4c120825f3a2c1f131c",
"hosts": [
{
"object": "user",
"fid": 3,
"username": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"profile": {
"bio": {
"text": "<string>",
"mentioned_profiles": [
{
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
],
"mentioned_profiles_ranges": [
{
"start": 1,
"end": 1
}
],
"mentioned_channels": [
{
"id": "<string>",
"name": "<string>",
"object": "channel_dehydrated",
"image_url": "<string>",
"viewer_context": {
"following": true,
"role": "member"
}
}
],
"mentioned_channels_ranges": [
{
"start": 1,
"end": 1
}
]
},
"location": {
"latitude": 0,
"longitude": 0,
"address": {
"city": "<string>",
"country": "<string>",
"state": "<string>",
"state_code": "<string>",
"country_code": "<string>"
},
"radius": 1
},
"banner": {
"url": "<string>"
}
},
"follower_count": 123,
"following_count": 123,
"verifications": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"auth_addresses": [
{
"address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
}
],
"verified_addresses": {
"eth_addresses": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"sol_addresses": [
"<string>"
],
"primary": {
"eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"sol_address": "<string>"
}
},
"verified_accounts": [
{
"platform": "x",
"username": "<string>"
}
],
"display_name": "<string>",
"pro": {
"status": "subscribed",
"subscribed_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z"
},
"pfp_url": "<string>",
"experimental": {
"neynar_user_score": 123,
"deprecation_notice": "<string>"
},
"viewer_context": {
"following": true,
"followed_by": true,
"blocking": true,
"blocked_by": true
},
"score": 123
}
],
"viewer_context": {
"following": true,
"role": "member"
},
"description_mentioned_profiles": [
{
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
}
],
"description_mentioned_profiles_ranges": [
{
"start": 1,
"end": 1
}
]
},
"app": {
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"score": 123
},
"type": "cast-mention",
"viewer_context": {
"liked": true,
"recasted": true
},
"author_channel_context": {
"following": true,
"role": "member"
}
}
],
"next": {
"cursor": "<string>"
}
}
}Searching Casts
You can search for casts using keywords and operators in the search query.Authorizations
API key to authorize requests
Headers
Query Parameters
Query string to search for casts. Supported operators:
| Operator | Description |
|---|---|
+ | Acts as the AND operator. This is the default operator between terms and can usually be omitted. |
| | Acts as the OR operator. |
* | When used at the end of a term, signifies a prefix query. |
" | Wraps several terms into a phrase (for example, "star wars"). |
(, ) | Wrap a clause for precedence (for example, star + (wars | trek)). |
~n | When used after a term (for example, satr~3), sets fuzziness. When used after a phrase, sets slop. |
- | Negates the term. |
before: | Search for casts before a specific date. (e.g. before:2025-04-20 or before:2025-04-20T23:59:59) |
after: | Search for casts after a specific date. (e.g. after:2025-04-20 or after:2025-04-20T00:00:00) |
"star (wars | trek) \"space battle\" after:2024-05-04"
Choices are:
literal- Searches for the words in the query string (default)semantic- Searches for the meaning of the query stringhybrid- Combines both literal and semantic results
literal, semantic, hybrid "literal"
Choices are:
desc_chron- All casts sorted by time in a descending order (default)chron- All casts sorted by time in ascending orderalgorithmic- Casts sorted by engagement and time
desc_chron, chron, algorithmic "desc_chron"
Fid of the user whose casts you want to search
x >= 1Providing this will return search results that respects this user's mutes and blocks and includes viewer_context.
x >= 1Parent URL of the casts you want to search
Channel ID of the casts you want to search
Number of results to fetch
1 <= x <= 10025
Pagination cursor
Response
Success
Show child attributes
Show child attributes
Show child attributes
Show child attributes
cast Show child attributes
Show child attributes
user The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_profiles list.
Show child attributes
Show child attributes
channel_dehydrated Adds context on the viewer's or author's role in the channel.
Show child attributes
Show child attributes
Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_channels list.
Coordinates and place names for a location
Show child attributes
Show child attributes
-90 <= x <= 90-180 <= x <= 180Show child attributes
Show child attributes
The radius in meters for the location search. Any location within this radius will be returned.
x >= 0The number of followers the user has.
The number of users the user is following.
Ethereum address
Show child attributes
Show child attributes
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
List of verified Ethereum addresses of the user sorted by oldest to most recent.
Ethereum address
List of verified Solana addresses of the user sorted by oldest to most recent.
Solana address
The URL of the user's profile picture
Adds context on the viewer's follow relationship with the user.
Show child attributes
Show child attributes
Indicates if the viewer is following the user.
Indicates if the viewer is followed by the user.
Indicates if the viewer is blocking the user.
Indicates if the viewer is blocked by the user.
Score that represents the probability that the account is not spam.
- EmbedCast
- EmbedUrl
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
- EmbedCastDeep
- EmbedUrl
Show child attributes
Show child attributes
Show child attributes
Show child attributes
cast_dehydrated Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
channel_dehydrated Adds context on the viewer's or author's role in the channel.
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
This has been deprecated and will always be an empty array. The property will be removed in the future
This has been deprecated and will always be an empty array. The property will be removed in the future
Show child attributes
Show child attributes
user The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_profiles list.
Show child attributes
Show child attributes
channel_dehydrated Adds context on the viewer's or author's role in the channel.
Show child attributes
Show child attributes
Indicates if the user is following the channel.
The role of a channel member
member, moderator, owner Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_channels list.
Coordinates and place names for a location
Show child attributes
Show child attributes
-90 <= x <= 90-180 <= x <= 180Show child attributes
Show child attributes
The radius in meters for the location search. Any location within this radius will be returned.
x >= 0The number of followers the user has.
The number of users the user is following.
Ethereum address
Show child attributes
Show child attributes
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
List of verified Ethereum addresses of the user sorted by oldest to most recent.
Ethereum address
List of verified Solana addresses of the user sorted by oldest to most recent.
Solana address
Show child attributes
Show child attributes
The URL of the user's profile picture
Adds context on the viewer's follow relationship with the user.
Show child attributes
Show child attributes
Indicates if the viewer is following the user.
Indicates if the viewer is followed by the user.
Indicates if the viewer is blocking the user.
Indicates if the viewer is blocked by the user.
Score that represents the probability that the account is not spam.
Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_profiles list.
Show child attributes
Show child attributes
channel_dehydrated Adds context on the viewer's or author's role in the channel.
Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_channels list.
- Channel
- ChannelDehydrated
Show child attributes
Show child attributes
channel Number of followers the channel has.
Show child attributes
Show child attributes
user The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_profiles list.
Show child attributes
Show child attributes
channel_dehydrated Adds context on the viewer's or author's role in the channel.
Show child attributes
Show child attributes
Indicates if the user is following the channel.
The role of a channel member
member, moderator, owner Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_channels list.
Coordinates and place names for a location
Show child attributes
Show child attributes
-90 <= x <= 90-180 <= x <= 180Show child attributes
Show child attributes
The radius in meters for the location search. Any location within this radius will be returned.
x >= 0The number of followers the user has.
The number of users the user is following.
Ethereum address
Show child attributes
Show child attributes
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
List of verified Ethereum addresses of the user sorted by oldest to most recent.
Ethereum address
List of verified Solana addresses of the user sorted by oldest to most recent.
Solana address
The URL of the user's profile picture
Adds context on the viewer's follow relationship with the user.
Show child attributes
Show child attributes
Indicates if the viewer is following the user.
Indicates if the viewer is followed by the user.
Indicates if the viewer is blocking the user.
Indicates if the viewer is blocked by the user.
Score that represents the probability that the account is not spam.
The unique identifier of a farcaster user or app (unsigned integer)
x >= 0Use lead instead.
Show child attributes
Show child attributes
user The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_profiles list.
Show child attributes
Show child attributes
channel_dehydrated Adds context on the viewer's or author's role in the channel.
Show child attributes
Show child attributes
Indicates if the user is following the channel.
The role of a channel member
member, moderator, owner Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_channels list.
Coordinates and place names for a location
Show child attributes
Show child attributes
-90 <= x <= 90-180 <= x <= 180Show child attributes
Show child attributes
The radius in meters for the location search. Any location within this radius will be returned.
x >= 0The number of followers the user has.
The number of users the user is following.
Ethereum address
Show child attributes
Show child attributes
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
List of verified Ethereum addresses of the user sorted by oldest to most recent.
Ethereum address
List of verified Solana addresses of the user sorted by oldest to most recent.
Solana address
Show child attributes
Show child attributes
The URL of the user's profile picture
Adds context on the viewer's follow relationship with the user.
Show child attributes
Show child attributes
Indicates if the viewer is following the user.
Indicates if the viewer is followed by the user.
Indicates if the viewer is blocking the user.
Indicates if the viewer is blocked by the user.
Score that represents the probability that the account is not spam.
"0x71d5225f77e0164388b1d4c120825f3a2c1f131c"
Show child attributes
Show child attributes
user The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_profiles list.
Show child attributes
Show child attributes
channel_dehydrated Adds context on the viewer's or author's role in the channel.
Show child attributes
Show child attributes
Indicates if the user is following the channel.
The role of a channel member
member, moderator, owner Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_channels list.
Coordinates and place names for a location
Show child attributes
Show child attributes
-90 <= x <= 90-180 <= x <= 180Show child attributes
Show child attributes
The radius in meters for the location search. Any location within this radius will be returned.
x >= 0The number of followers the user has.
The number of users the user is following.
Ethereum address
Show child attributes
Show child attributes
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Show child attributes
Show child attributes
List of verified Ethereum addresses of the user sorted by oldest to most recent.
Ethereum address
List of verified Solana addresses of the user sorted by oldest to most recent.
Solana address
The URL of the user's profile picture
Adds context on the viewer's follow relationship with the user.
Show child attributes
Show child attributes
Indicates if the viewer is following the user.
Indicates if the viewer is followed by the user.
Indicates if the viewer is blocking the user.
Indicates if the viewer is blocked by the user.
Score that represents the probability that the account is not spam.
Adds context on the viewer's or author's role in the channel.
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
Positions within the text (inclusive start, exclusive end) where each mention occurs.
Show child attributes
Show child attributes
user_dehydrated The unique identifier of a farcaster user or app (unsigned integer)
x >= 03
Ethereum address
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
The notification type of a cast.
cast-mention, cast-reply Adds context on the viewer's or author's role in the channel.
Was this page helpful?