curl --request GET \
--url https://api.neynar.com/v2/farcaster/user/by_username/ \
--header 'x-api-key: <api-key>'{
"user": {
"object": "user",
"fid": 3,
"username": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"registered_at": "2023-11-07T05:31:56Z",
"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>"
}
],
"mentioned_channels_ranges": [
{
"start": 1,
"end": 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>",
"pfp_url": "<string>",
"score": 123
}
}Fetches a single hydrated user object given a username
curl --request GET \
--url https://api.neynar.com/v2/farcaster/user/by_username/ \
--header 'x-api-key: <api-key>'{
"user": {
"object": "user",
"fid": 3,
"username": "<string>",
"custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"registered_at": "2023-11-07T05:31:56Z",
"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>"
}
],
"mentioned_channels_ranges": [
{
"start": 1,
"end": 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>",
"pfp_url": "<string>",
"score": 123
}
}API key to authorize requests
Username of the user to fetch
"neynar"
x >= 1Success
Show child attributes
Was this page helpful?