View Categories

Record Lookup API

This API allows fetching an associated ODude Name based on a given key-value pair. It queries the ODude Name database (not on-chain) and returns the first matching domain.

API Endpoint:

https://web3domain.org/endpoint/v3/record.php?key={KEY}&value={VALUE}

Example Queries & Responses:

  • Lookup by ID:
https://web3domain.org/endpoint/v3/record.php?key=id&value=542063947402

Response:

{
  "domain": "hello@web3"
}
  • Lookup by Email:
https://web3domain.org/endpoint/v3/record.php?key=email&value=web3yak@gmail.com

Response:

{
  "domain": "jack@odude"
}

Allowed Keys:

The following keys can be used for lookups:

["id", "img", "uri", "email", "website", "notes", "eth", "bsc", "matic", "btc", "fil", "sol", "twitter", "telegram", "youtube", "instagram", "facebook", "web2", "web3"]

Alternative Integration Methods

For developers building dApps or working with JavaScript-based environments, ODude Name also offers an NPM package for seamless integration without relying on cURL.

Refer to the ODude Name NPM Package for more details.