Developer Portal

Manage your API integrations and OAuth applications.

API Documentation

Integrate ds.click into your workflow or application using our fast, RESTful API.

Authentication

The Developer API has two tiers: the Personal API and the Enterprise API. All requests must include an authorization header:

Authorization: Bearer <TOKEN>

Personal API Keys

Use these for personal scripts and automation. They give access to your own servers and data.

  • Free to use
  • Rate limit: 60 req / min

OAuth2 Tokens

Use these for public applications. They allow your app to perform actions on behalf of other users.

  • Requires Enterprise Team Subscription ($49.99/mo)
  • Rate limit: 120 req / min

Endpoints

GET/api/v1/servers

List all servers that the authenticated user owns or manages.

Response JSON

{
  "success": true,
  "data": [
    {
      "id": "123456789",
      "name": "My Discord Server",
      "memberCount": 150,
      "isPremium": true
    }
  ]
}
GET /api/v1/servers/:guildId/stats

Get detailed analytics for a specific server over the last 7 days (or 30 days if the server is Premium).

GET /api/v1/stats

Get overall aggregate analytics across all links owned by the user.

POST /api/v1/links

Create a new shortened link for a server. The user must have permission to manage the server.

Request Body (JSON)

{
  "originalUrl": "https://discord.gg/yourinvite",
  "guildId": "123456789",
  "description": "Optional description",
  "isNsfw": false
}

Response JSON

{
  "success": true,
  "data": {
    "id": "...",
    "shortCode": "abcd",
    "shortUrl": "https://ds.click/s/abcd",
    "originalUrl": "https://discord.gg/yourinvite"
  }
}