Search

Recognise a Discord ID, a username or an invite link, decode what the input itself tells (a Discord ID carries the account’s creation date), and run every lookup module. Answering 200 takes 1 search from your daily quota; 400, 451 and 429 take none.

GET /v1/search

Full search

cURL

curl --request GET \
  --url https://api.dis.dog/v1/search \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "srch_a1b2c3",
  "createdAt": "2023-11-07T05:31:56Z",
  "query": "80351110224678912",
  "kind": "discord_id",
  "value": "<string>",
  "account": {
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z"
  },
  "lookup": {
    "resolvedId": "<string>",
    "matches": [
      {
        "id": "<string>",
        "username": "<string>",
        "displayName": "<string>",
        "avatarUrl": "<string>",
        "serverCount": 123,
        "lastSeenAt": "2023-11-07T05:31:56Z"
      }
    ]
  },
  "invite": {
    "code": "discord-developers",
    "url": "<string>",
    "memberCount": 862000,
    "onlineCount": 123,
    "expiresAt": "2023-11-07T05:31:56Z",
    "server": {
      "id": "<string>",
      "name": "Discord Developers",
      "description": "<string>",
      "iconUrl": "<string>",
      "bannerUrl": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "vanityCode": "<string>",
      "boostCount": 123,
      "boostTier": 123,
      "verificationLevel": 123
    }
  },
  "modules": [
    {
      "id": "<string>",
      "name": "<string>",
      "status": "found",
      "data": {}
    }
  ]
}

Give it a Discord ID, a username or an invite link in q: DisDog recognises which, decodes what the input itself tells, and runs every lookup module. A search that answers 200 takes 1 search from your quota; every refusal is free. What takes a search →

Accepted inputs

Input	Rule	Examples	kind	value
Discord ID	17 to 20 digits, a real snowflake (not in the future)	80351110224678912	discord_id	the ID
Invite link	discord.gg/<code> or discord.com/invite/<code>, with or without https://	discord.gg/disdog	invite	the code alone: disdog
Username	2 to 32 letters, digits, _ or ., not only digits; a leading @ is dropped	disdog, @DisDog	username	lowercase, without @
Legacy tag	a name of 2 to 32 characters, then # and 4 digits	name#1234	username	as typed

Anything else answers 400 invalid_query. A bare code like disdog, without discord.gg/, is read as a username.

For a Discord ID, account.createdAt is the exact moment the account was created: Discord encodes it in the ID. A removed ID answers 451 removed_by_owner.

Usernames

A username is looked up by name: lookup.matches lists the accounts whose username or display name contains it (up to 20, best first). When one has exactly this username, it becomes the account: lookup.resolvedId and account hold its ID, and every module runs on it. Without an exact match, the modules answer no_data: pick an ID from matches and search again. Same thing on its own: GET /v1/lookup/{name}.

Invite links

For an invite, invite holds what’s behind it, straight from Discord: the server (name, icon, description, boosts), the channel, who created the invite, member and online counts, expiry. null when the invite doesn’t exist or has expired. Same thing on its own: GET /v1/invite/{code}.

Module results

Each entry of modules has a status:

status	Meaning
found	Results are in data. For profile, the same object as GET /v1/profile/{id}.
not_found	The source has nothing for this input.
no_data	The module can’t answer this kind of input (the profile module needs a Discord ID).
error	The source didn’t answer. The search still counts; try again later.
soon	The module is being connected and answers nothing yet. Check GET /v1/modules.

Authorizations

Authorization · string · header · required

Your access key, DD-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX. The same key is your website login. Keep it server-side.

Query Parameters

q · string · required

Discord ID, username or invite link.

Required string length: 1 - 100

Example:

"80351110224678912"

Response

200

application/json

Search result

id · string

The saved result's id; its page is dis.dog/search/.

Example:

"srch_a1b2c3"

createdAt · string<date-time>

query · string

Example:

"80351110224678912"

kind · enum<string>

Available options: discord_id, username, invite

value · string

account · object | null

Show child attributes

lookup · object | null

Username searches: the matching accounts.

Show child attributes

invite · object | null

Show child attributes

modules · object[]

One entry per module. status: found carries a data field shaped like the matching standalone endpoint.

Show child attributes