Subscribers
Subscribed to
Farcaster API V2
- User
- Signer
- Cast
- Feed
- Reaction
- Notifications
- Channel
- Follows
- Storage
- Mini Apps
- Agents
- Fname
- Webhook
- Action
- Mute
- Block
- Ban
- Onchain
- Login
- Metrics
Onchain
Farcaster Hub API
- Info
- Casts
- Reactions
- Links
- UserData
- Fids
- Storage
- Usernames
- Verifications
- OnChainEvents
- Message
- HubEvents
Neynar SDK
- Getting Started with Neynar NodeJS SDK
- SDK v1 to v2 migration guide
Subscribers
Subscribed to
Fetch what FIDs and contracts a FID is subscribed to.
GET
/
farcaster
/
user
/
subscribed_to
curl --request GET \
--url https://api.neynar.com/v2/farcaster/user/subscribed_to \
--header 'x-api-key: <api-key>'
{
"subscribed_to": [
{
"object": "subscription",
"provider_name": "fabric_stp",
"contract_address": "0xff63fc310d47ef80961056ac8df0b3f1a9e3ef58",
"chain": 8453,
"metadata": {
"title": "/memes channel sub",
"symbol": "MMS",
"art_url": "https://storage.withfabric.xyz/loom/403fdc10-95f3-4b25-9d77-5aac7ccb9fd1.jpg"
},
"owner_address": "0xb6f6dce6000ca88cc936b450cedb16a5c15f157f",
"price": {
"period_duration_seconds": 2592000,
"tokens_per_period": "350574998400000",
"initial_mint_price": "0"
},
"tiers": [
{
"id": 1,
"price": {
"period_duration_seconds": 2592000,
"tokens_per_period": "3000000000000000",
"initial_mint_price": "0"
}
}
],
"protocol_version": 1,
"token": {
"symbol": "ETH",
"address": null,
"decimals": 18,
"erc20": false
},
"expires_at": "2023-09-13T22:10:22.000Z",
"subscribed_at": "2023-09-13T22:10:22.000Z",
"tier": {
"id": 1,
"price": {
"period_duration_seconds": 2592000,
"tokens_per_period": "3000000000000000",
"initial_mint_price": "0"
}
},
"creator": {
"object": "user",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"pfp_url": "<string>",
"profile": {
"bio": {
"text": "<string>",
"mentioned_profiles": [
{
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7"
}
],
"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>",
"state": "<string>",
"state_code": "<string>",
"country": "<string>",
"country_code": "<string>"
}
}
},
"follower_count": 123,
"following_count": 123,
"verifications": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"verified_addresses": {
"eth_addresses": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"sol_addresses": [
"<string>"
],
"primary": {
"eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"sol_address": "<string>"
}
},
"verified_accounts": [
{
"platform": "x",
"username": "<string>"
}
],
"power_badge": true,
"experimental": {
"deprecation_notice": "<string>",
"neynar_user_score": 123
},
"score": 123,
"viewer_context": {
"following": true,
"followed_by": true,
"blocking": true,
"blocked_by": true
}
}
}
]
}
Authorizations
API key to authorize requests
Query Parameters
The unique identifier of a farcaster user (unsigned integer)
Example:
3
The unique identifier of a farcaster user (unsigned integer)
Example:
3
The provider of the subscription.
Available options:
fabric_stp
Response
200
application/json
Successful operation.
The response is of type object
.
Was this page helpful?
curl --request GET \
--url https://api.neynar.com/v2/farcaster/user/subscribed_to \
--header 'x-api-key: <api-key>'
{
"subscribed_to": [
{
"object": "subscription",
"provider_name": "fabric_stp",
"contract_address": "0xff63fc310d47ef80961056ac8df0b3f1a9e3ef58",
"chain": 8453,
"metadata": {
"title": "/memes channel sub",
"symbol": "MMS",
"art_url": "https://storage.withfabric.xyz/loom/403fdc10-95f3-4b25-9d77-5aac7ccb9fd1.jpg"
},
"owner_address": "0xb6f6dce6000ca88cc936b450cedb16a5c15f157f",
"price": {
"period_duration_seconds": 2592000,
"tokens_per_period": "350574998400000",
"initial_mint_price": "0"
},
"tiers": [
{
"id": 1,
"price": {
"period_duration_seconds": 2592000,
"tokens_per_period": "3000000000000000",
"initial_mint_price": "0"
}
}
],
"protocol_version": 1,
"token": {
"symbol": "ETH",
"address": null,
"decimals": 18,
"erc20": false
},
"expires_at": "2023-09-13T22:10:22.000Z",
"subscribed_at": "2023-09-13T22:10:22.000Z",
"tier": {
"id": 1,
"price": {
"period_duration_seconds": 2592000,
"tokens_per_period": "3000000000000000",
"initial_mint_price": "0"
}
},
"creator": {
"object": "user",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"pfp_url": "<string>",
"profile": {
"bio": {
"text": "<string>",
"mentioned_profiles": [
{
"object": "user_dehydrated",
"fid": 3,
"username": "<string>",
"display_name": "<string>",
"pfp_url": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7"
}
],
"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>",
"state": "<string>",
"state_code": "<string>",
"country": "<string>",
"country_code": "<string>"
}
}
},
"follower_count": 123,
"following_count": 123,
"verifications": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"verified_addresses": {
"eth_addresses": [
"0x5a927ac639636e534b678e81768ca19e2c6280b7"
],
"sol_addresses": [
"<string>"
],
"primary": {
"eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"sol_address": "<string>"
}
},
"verified_accounts": [
{
"platform": "x",
"username": "<string>"
}
],
"power_badge": true,
"experimental": {
"deprecation_notice": "<string>",
"neynar_user_score": 123
},
"score": 123,
"viewer_context": {
"following": true,
"followed_by": true,
"blocking": true,
"blocked_by": true
}
}
}
]
}