ens.vision APIens.vision ↗
Access ENS domain details, marketplace listings, offers, activity feeds, name resolution, and portfolio lookups via the ens.vision API.
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'
Retrieve full details for a specific ENS domain, including ownership, registration dates, token info, categories, and avatar URL.
| 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 (id, chainId, contract, tokenId)",
"expires": "string, ISO datetime of expiry",
"avatarUrl": "string or null, URL of the domain avatar",
"categories": "array of category objects"
},
"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"
}
]
},
"status": "success"
}
}About the ens.vision 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.
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.
- 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 | 250 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.