Skip to content

Instantly share code, notes, and snippets.

@bunseokbot
Last active September 28, 2018 10:36
Show Gist options
  • Save bunseokbot/9132101b6ff0310743411d78d8b069ba to your computer and use it in GitHub Desktop.
Save bunseokbot/9132101b6ff0310743411d78d8b069ba to your computer and use it in GitHub Desktop.
DarkLight API Reference

DarkLight API Reference

DarkLight supports RESTful API for all user. If you want to use API service, go to user page and generate API key.

Pre-required

You have to define HTTP Content-Type as 'application/x-www-form-urlencoded' before using DarkLight API.

Search

You can search whatever you want.

Search by Domain

No Limitation

POST /api/search/domain

Request Body

key value
key Your API Key
query Domain

Response

{
  "result": [
    {
      "report_id": "Unique Report ID",
      "domain": "Domain you request",
      "scanned_time": "Domain last scanned time (UTC+0)"
    }
  ],
  "count": 1
}

Search by Metadata

20 requests per hour to normal user

POST /api/search/metadata

Request Body

key value
key Your API Key
query Metadata value
start start index (default value is 0)
size result size (default value is 50)

Response

{
  "result": [
    {
      "report_id": "Unique Report ID",
      "domain": "Domain value",
      "scanned_time": "Domain last scanned time (UTC+0)"
    }
  ],
  "count": 1
}

Search by Keyword

30 requests per hour to normal user

POST /api/search/keyword

Request Body

key value
key Your API Key
query Keyword value
start start index (default value is 0)
size result size (default value is 50)

Response

{
  "result": [
    {
      "report_id": "Unique Report ID",
      "domain": "Domain value",
      "scanned_time": "Domain last scanned time (UTC+0)"
    }
  ],
  "count": 1
}

Search by Wallet address

Premium User Only

GET /api/search/wallet/<wallet_address>?key=<YOUR_API_KEY>

Response

{
  "address": "Wallet address",
  "domains": [
      {
          "domain": "Domain value",
          "report_id": "Unique Report ID"
      }
  ]
}

Report

Query by Report ID for specific information about darkweb information.

GET /api/report/<report_id>?key=<YOUR_API_KEY>

Response

{
  "report_id": "Unique Report ID",
  "domain": "Domain value",
  "scanned_time": "Domain last scanned time (UTC+0)",
  "title": "Website title",
  "server": "Server information",
  "language": {
    "html": "html language code",
    "detector": "darklight detector detect code"
  },
  "screenshot": "screenshot link (premium only)"
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment