Quickstart

Create your account

Open dis.dog/register, enter your email and confirm it with the 6-digit code we send you. There is no password: at the end, DisDog shows your access key. It looks like this:

DD-7KQ2M-X9C4T-HB3RZ-W8N6P-YF5VA

The API comes with the Hound ($10 / 30 days, 500 searches a day) and **Alpha** ($30 / 30 days, unlimited) plans: upgrade here. A Pup (free) key can already call /v1/me to check that it works.

The key is your login on the website and your API key. Anyone who has it can use your account and your quota. Keep it in a password manager or your server’s environment. You can show it again any time from your account page, where it is blurred by default. Lost access? Get a new one with your email.

Store it in an environment variable

Keep the key out of your code:

export DISDOG_KEY="DD-7KQ2M-X9C4T-HB3RZ-W8N6P-YF5VA"

Check that it works

GET /v1/me returns your plan and what is left of today’s quota. It never spends a search.

curl https://api.dis.dog/v1/me \
  -H "Authorization: Bearer $DISDOG_KEY"

{
  "plan": "hound",
  "planExpiresAt": "2026-12-01T10:00:00.000Z",
  "usage": { "used": 0, "limit": 500, "remaining": 500, "resetAt": "2026-11-01T00:00:00.000Z" }
}

Run a search

curl "https://api.dis.dog/v1/search?q=80351110224678912" \
  -H "Authorization: Bearer $DISDOG_KEY"

import os
import requests

response = requests.get(
    "https://api.dis.dog/v1/search",
    params={"q": "80351110224678912"},
    headers={"Authorization": f"Bearer {os.environ['DISDOG_KEY']}"},
    timeout=60,
)
data = response.json()
if not response.ok:
    raise RuntimeError(data["error"])

print(data["kind"], data["value"])
if data["account"]:
    print("Created:", data["account"]["createdAt"])
print("Searches left today:", response.headers["X-RateLimit-Remaining"])

const url = new URL("https://api.dis.dog/v1/search");
url.searchParams.set("q", "80351110224678912");

const response = await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.DISDOG_KEY}` },
  signal: AbortSignal.timeout(60_000),
});

const data = await response.json();
if (!response.ok) throw new Error(data.error);

console.log(data.kind, data.value);
if (data.account) console.log("Created:", data.account.createdAt);
console.log("Searches left today:", response.headers.get("X-RateLimit-Remaining"));

Read the answer

{
  "query": "80351110224678912",
  "kind": "discord_id",
  "value": "80351110224678912",
  "account": { "id": "80351110224678912", "createdAt": "2015-08-10T17:26:37.529Z" },
  "modules": [
    { "id": "profile", "name": "Discord profile", "status": "found", "data": { "…": "…" } },
    { "id": "connections", "name": "Connected accounts", "status": "found", "data": { "…": "…" } },
    { "id": "servers", "name": "Server memberships", "status": "found", "data": { "…": "…" } },
    { "id": "messages", "name": "Message logs", "status": "not_found" },
    { "id": "roblox", "name": "Discord → Roblox", "status": "found", "data": { "…": "…" } },
    { "id": "gunslol", "name": "Discord → guns.lol", "status": "not_found" },
    { "id": "fivem", "name": "FiveM database", "status": "no_data" }
  ]
}

kind says what DisDog recognised, account.createdAt is decoded from the ID, and modules lists every lookup module with its status and, when it found something, its data. Every field →

Limits & quotas

What a search costs, and how to handle 429.

Errors

Every error code, and what to do about it.

Get started

Essentials

Modules

Privacy

Next

Limits & quotas

Errors