Skip to main content

GET /api/ens/{name}

Get ENS Profile

Retrieve comprehensive ENS profile data including address, avatar, and text records.

Features​

  • Resolves ENS name to Ethereum address
  • Fetches avatar URL (supports NFT avatars)
  • Returns all text records (description, twitter, github, etc.)
  • Includes registration and expiration dates

Pricing​

  • $0.005 per request (free tier: 100/day)

Endpoint​

GET https://api.web3identity.com/api/ens/{name}

Parameters​

NameInTypeRequiredDescription
namepathstringâś…ENS name (e.g., vitalik.eth)

Example Request​

curl -s "https://api.web3identity.com/api/ens/:name" | jq

Responses​

200 Full ENS profile​

400 Bad Request - Invalid parameters or malformed request​

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

402 Payment required​

{
"example": "response"
}

404 ENS name 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