GET /api/farcaster/{identifier}

Get Farcaster Profile

Get Farcaster user profile by FID, username, or connected address.

Identifier Types

• FID: Numeric Farcaster ID (e.g., 5650)
• Username: Farcaster username (e.g., vitalik.eth)
• Address: Connected Ethereum address

Response Includes

• Profile bio and avatar
• Follower/following counts
• Connected addresses
• Power badge status

Pricing

• $0.01 per request

Endpoint

GET https://api.web3identity.com/api/farcaster/{identifier}

Parameters

Name	In	Type	Required	Description
identifier	path	string	✅	FID, username, or address

Example Request

curl -s "https://api.web3identity.com/api/farcaster/:identifier" | jq

Responses

200 Farcaster user profile

400 Bad Request - Invalid parameters or malformed request

{
  "error": "Invalid parameter format",
  "code": "INVALID_PARAMETER"
}

402 Payment Required - Free tier exhausted

{
  "example": "response"
}

404 Not Found - Resource does not exist

{
  "error": "Resource not found",
  "code": "NOT_FOUND"
}

429 Rate Limited

{
  "example": "response"
}

500 Internal Server Error - Something went wrong on our end

{
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}

---

Auto-generated from OpenAPI spec