ENS APIens.vision ↗
Access ENS domain details, marketplace listings, offers, activity feeds, name resolution, and portfolio lookups via the ens.vision API.
What is the ENS API?
The ens.vision API provides 10 endpoints covering ENS domain search, marketplace listings, activity feeds, name and address resolution, and portfolio lookups. Use get_domain_details to retrieve ownership, expiry, avatar URL, and NFT token info for any .eth name, or call resolve_name to map an ENS name to its Ethereum address alongside text records like avatar, email, and Twitter handle.
curl -X GET 'https://api.parse.bot/scraper/89ed6eba-2968-4f53-8af0-1d5d4a77ff27/get_domain_details?name=vitalik.eth' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace ens-vision-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.ens_vision_api import ENSVision, SortField, Sort, EventType
ens = ENSVision()
# Search for domains by keyword, sorted by registration date descending
for domain in ens.domains.search(query="app", sort_by=SortField.REGISTRATION_DATE, sort_order=Sort.DESC, limit=5):
print(domain.name, domain.owner, domain.tags)
# Get full details for a specific domain
vitalik = ens.domains.get(name="vitalik.eth")
print(vitalik.name, vitalik.expires, vitalik.avatar_url)
# Browse categories and list their marketplace offerings
for category in ens.categories.list(limit=3):
print(category.name, category.count, category.floor_price)
# Get recommendations for a domain
for rec in vitalik.recommendations(limit=3):
print(rec.name, rec.reason, rec.score)
# List activity on a specific domain filtered by event type
for event in vitalik.activity.list(event_types=EventType.SALE, limit=5):
print(event.id, event.type, event.block_timestamp)
# Resolve an ENS name to an Ethereum address
for resolution in ens.resolutions.by_name(name="vitalik.eth"):
print(resolution.query, resolution.success, resolution.result)
# Look up a wallet's portfolio
wallet = ens.wallet(address="0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045")
for owned in wallet.portfolio(limit=5):
print(owned.name, owned.expires, owned.floor_price)Retrieve full details for a specific ENS domain, including ownership, registration dates, token info, categories, and avatar URL. Returns a single Domain resource keyed by its hash id.
| Param | Type | Description |
|---|---|---|
| namerequired | string | ENS domain name (e.g., 'vitalik.eth') |
{
"type": "object",
"fields": {
"id": "string, domain identifier hash",
"tld": "string, top-level domain",
"name": "string, full domain name",
"tags": "array of string tags",
"label": "string, domain label without TLD",
"owner": "string, Ethereum address of the owner",
"token": "object with NFT token details",
"expires": "string, ISO datetime of expiry",
"avatarUrl": "string or null, URL of the domain avatar",
"categories": "array of category objects",
"floorPrice": "object or null, listing floor price",
"highestOffer": "object or null, highest offer",
"registrationDate": "string, ISO datetime of registration"
},
"sample": {
"data": {
"id": "0xee6c4522aab0003e8d14cd40a6af439055fd2577951148c14b6cea9a53475835",
"tld": "eth",
"name": "vitalik.eth",
"tags": [
"LETTER",
"LETTERS_ONLY"
],
"label": "vitalik",
"owner": "0x220866b1a2219f40e72f5c628b65d54268ca3a9d",
"token": {
"id": "1-0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85-79233663829379634837589865448569342784712482819484549289560981379859480642508",
"chainId": 1,
"tokenId": "79233663829379634837589865448569342784712482819484549289560981379859480642508",
"contract": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85"
},
"expires": "2047-12-28T13:25:30.000Z",
"avatarUrl": "https://pub-07c3064f42454133ad6bc90e6ab64f36.r2.dev/ens-images/avatar/vitalik.eth_e02de4c53ff191b9",
"categories": [
{
"id": 18,
"name": "Pre-Punk Club",
"slug": "pre-punk-club"
}
],
"floorPrice": null,
"highestOffer": null,
"registrationDate": "2020-02-06T18:23:40.000Z"
},
"status": "success"
}
}About the ENS API
Domain Data and Search
The search_domains endpoint accepts a query string, optional owner address filter, category_ids, is_subdomain flag, and pagination via limit and offset. Results include a total count and an array of domain objects. get_domain_details returns richer per-domain data: the owner Ethereum address, ISO expiry datetime, a token object containing chainId, contract, and tokenId, an avatarUrl, and an array of categories. browse_categories lists all ENS clubs with floorPrice, count, slug, and description fields — useful for building category-filtered search UIs.
Marketplace Listings, Offers, and Activity
get_marketplace_listings returns only domains with expiry status TAKEN (i.e., registered names actively listed for sale), each with a floorPrice and listingId. You can sort by price and filter by category_ids or a keyword query. get_domain_offers returns active per-domain offers with price, maker address, expiry, and currency — note that offer availability is transient and many domains carry no active offers at a given moment. The get_activity endpoint surfaces a platform-wide or domain-scoped event feed filtered by event_types (LISTING_CREATED, OFFER_CREATED, SALE, MINT), paginated with a hasMore cursor field.
Name and Address Resolution
resolve_name maps an ENS name to its Ethereum address plus any requested records (comma-separated fields such as avatar, email, twitter, url). The response includes totalQueries and successfulQueries counts alongside a timestamp. resolve_address performs the reverse lookup: given a wallet address it returns the primary ENS name and the same configurable text records. Default records differ between the two endpoints, so check the records parameter documentation for each.
Recommendations and Portfolios
get_recommendations returns related domain names for a given ENS name with a reason string and numeric score per result. The strategy parameter (e.g., hybrid) controls how recommendations are ranked. get_address_portfolio paginates all domains owned by a wallet, returning a total count and the same domain object shape used across other endpoints.
The ENS API is a managed, monitored endpoint for ens.vision — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ens.vision changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ens.vision API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor ENS marketplace listings by category to track floor price movements using get_marketplace_listings with category_ids.
- Build a wallet profile page that resolves an address to its primary ENS name, avatar, and social links via resolve_address.
- Alert users when a specific ENS domain receives a new offer by polling get_domain_offers for changes in the offers array.
- Display a full ownership history and recent sales for a domain using get_activity filtered to SALE and LISTING_CREATED event types.
- Populate an ENS club directory with counts, floor prices, and descriptions pulled from browse_categories.
- Suggest related ENS names to buyers by calling get_recommendations with a hybrid strategy and surfacing the reason and score fields.
- Show a wallet's complete ENS portfolio with expiry dates and avatar URLs by paginating get_address_portfolio.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.