Docs

Find the documentation for the Januus API, below. In order to begin making requests, you must first requisition an API Key. You can do so by sending us an email at [email protected]. Payment will be via crypto or Stripe. Once you've received an API key, you can begin making requests.

Overview

We retain several data points on cryptowallets as well as identities — you can query any combination of these and obtain a result for your query.

An outline of the data we retain:

• Email
• Full Name
• Organization
• Physical Address
• Phone Number
• Domain
• Forums
• Social Media
• Usernames
• Tags
• Source
• Cryptowallet(s)

You can search our database for any one of these data points and have the rest filled in.

Making Requests

As Januus functions on an internal credit economy, you should make sure you have enough credits for the request you're making. You can learn how the credit system works, here. Once you're ready, make a request to the following endpoint.

POST /transform/1
      

The data is expected in JSON and the key/value pairs in the JSON detail the piece of information you would like to search and also the fields you'd like to fetch.

{
  "query": {
      /* Queried fields */
  },
  "fields": {
      /* Requested fields */
  }
}
      

For an exhaustive list of legal queries, refer here. For an exhaustive list of the fields available, refer here. This list, it should be noted, is subject to frequent change as we improve and expand our capabilities.

Examples

You may find examples of queries in several languages here

curl -X POST -H "Content-Type: application/json" -H "Authorization: APIKEY 73gd5a1hd53iud5dh38ddt3gd7dq52hoq" -d '{"query": { "full_name": "Bilbo Baggins", "wallet_address_btc": "1r1ngt0ru13th3ma1l0n3rin6t0fin6th3m" }, "fields": { "emails": true, "social_media": true } }' https://api.januus.io/transform/1
      

requests.post(
  "https://api.januus.io/transform/1",
  data = '{
      "query": {
          "full_name": "Bilbo Baggins",
          "wallet_address_btc": "1r1ngt0ru13th3ma1l0n3rin6t0fin6th3m",
          "organization": "Thorin & Co.",
      },
      "fields": {
          "emails": true,
          "social_media": true,
      },
  }'
)
"""
Note how the `data` argument is supplied as a string. 
This is because the `requests` library fails to serialize nested dictionaries into equivalent JSON. You may either supply the argument as a string or encode as JSON manually.
"""
      

Queries

• full_name
• email
• forum_username
• phone_number
• facebook
• telegram
• instagram
• reddit
• linkedin
• youtube
• twitter
• organization
• domain
• wallet_address_btc
• wallet_address_eth
• wallet_address_bch
• wallet_address_xmr
• wallet_address_ltc
• wallet_address_dash

Note: a) Social media fields require you to search for their respective usernames.

Fields

• full_name
• forums
• wallet_addresses
• physical_address
• emails
• social_media
• owns_wallet
• domain
• source
• tags

Credits

When you first sign up for a plan, you are issued an API key as well as a fixed number of credits. The cost of a request is the sum of all the fields you request. Once you've exceeded your credit limit, you may make additional requests for a per-credit fee. The following table lists all the fields as well as their corresponding credit costs.

• full_name 3
• forums 3
• wallet_addresses 5
• physical_address 5
• emails 2
• social_media 4
• owns_wallet 1
• domain 3
• tags 3
• source 4