Domains API › Quickstart guide

sidebar_position: 2

Introduction

This guide will walk you through retrieving data from providers such as ENS, LENS, and UD using the Domains API.

Prerequisites

Node.js and npm installed on your machine
Basic knowledge of JavaScript, React, and Express.js

Step-by-step guide

Step 1: Initialization

Create a new directory for your project:


         
         
           Bash
         
 
         
         
           
           
             1
           
 
           
           mkdir domains && cd domains

Initialize a new Node.js project:


         
         
           Bash
         
 
         
         
           
           
             1
           
 
           
           npm init -y

Install Express, CORS, and Axios:


         
         
           Bash
         
 
         
         
           
           
             1
           
 
           
           npm install express cors axios

Install dotenv for securely storing environment variables:


         
         
           Bash
         
 
         
         
           
           
             1
           
 
           
           npm install dotenv

Then create a new file called .env and add your DevPortal API key to it:


         
         
           Bash
         
 
         
         
           
           
             1
           
 
           
           API_KEY=YOUR_1INCH_API_KEY

Step 2: Import required libraries

Create a new file named api.js in your project directory.

Add the following code to import necessary packages and initialize your Express application:


         
         
           JavaScript
         
 
         
         
           
           
             1
2
3
4
5
6
7
8
9
10
11
           
 
           
           const express = require("express");
const axios = require("axios");
const dotenv = require("dotenv");
const cors = require("cors");
const path = require("path");

// Load environment variables
dotenv.config({ path: path.resolve(__dirname, ".env") });

const app = express();
app.use(cors());

Step 3: Define API endpoints

Add the following code to define your API endpoints:

Retrieve domain information


         
         
           JavaScript
         
 
         
         
           
           
             1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
           
 
           
           const BASE_URL = "https://api.1inch.com/domains/v2.0";

app.get("/api/:domain/info", async (req, res) => {
  const domain = req.params.domain;
  try {
    const constructedUrl = `${BASE_URL}/${domain}/lookup`;
    const response = await axios.get(constructedUrl, {
      headers: {
        Authorization: `Bearer ${process.env.API_KEY}`
      }
    });
    res.json(response.data);
  } catch (error) {
    res.status(500).json({ error: "API error" });
  }
});

Reverse lookup for a domain:


         
         
           JavaScript
         
 
         
         
           
           
             1
2
3
4
5
6
7
8
9
10
11
12
13
14
           
 
           
           app.get("/api/:domain/reverseinfo", async (req, res) => {
  const domain = req.params.domain;
  try {
    const constructedUrl = `${BASE_URL}/${domain}/reverse-lookup`;
    const response = await axios.get(constructedUrl, {
      headers: {
        Authorization: `Bearer ${process.env.API_KEY}`
      }
    });
    res.json(response.data);
  } catch (error) {
    res.status(500).json({ error: "API error" });
  }
});

Retrieve provider data with avatars:


         
         
           JavaScript
         
 
         
         
           
           
             1
2
3
4
5
6
7
8
9
10
11
12
13
14
           
 
           
           app.get("/api/:domain/get-providers-data-with-avatar", async (req, res) => {
  const domain = req.params.domain;
  try {
    const constructedUrl = `${BASE_URL}/get-providers-data-with-avatar`;
    const response = await axios.get(constructedUrl, {
      headers: {
        Authorization: `Bearer ${process.env.API_KEY}`
      }
    });
    res.json(response.data);
  } catch (error) {
    res.status(500).json({ error: "API error" });
  }
});

Step 4: Start the server

Add the following code to start your Express server and save the file:


         
         
           JavaScript
         
 
         
         
           
           
             1
2
3
4
           
 
           
           const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`Server is running on port ${PORT}`);
});

Run the server by using in your Terminal:


         
         
           Bash
         
 
         
         
           
           
             1
           
 
           
           node api.js

Response models

The API returns structured JSON responses, which you can use to integrate with your application.

Response model: Provider data with avatar


         
         
           JSON
         
 
         
         
           
           
             1
2
3
4
5
6
7
8
           
 
           
           {
  "result": {
    "protocol": "string",
    "domain": "string",
    "address": "string",
    "avatar": {}
  }
}

Response model: Domain or address information


         
         
           JSON
         
 
         
         
           
           
             1
2
3
4
5
6
7
           
 
           
           {
  "result": {
    "protocol": "string",
    "address": "string",
    "checkUrl": "string"
  }
}