API reference

The Discapedia REST API lets you manage your listings and ad campaigns programmatically. Base URL:

https://diswork.15.204.158.166.sslip.io/api/v1

Authentication

Create a key in your dashboard → API keys. Pass it as a Bearer token:

Authorization: Bearer nctk_xxxxxxxx_xxxxxxxx...

Keys are scoped (account:read, directory:read, servers:read, servers:write, ads:read, ads:write, reports:write) and rate-limited to 600 requests / 5 minutes.

Responses

Success returns { "data": ... } (with "meta" for paginated lists). Errors return { "error": { "code", "message" } } with an appropriate HTTP status.

No bump endpoint

Bumping is Discord-only with a 2-hour cooldown. There is intentionally no bump endpoint — it can't be automated via the API. See Bumping.

Endpoints

Account

• GET /me — your account + the key's scopes.

Listings

• GET /servers — your listings.
• POST /servers — create a listing (AI-reviewed).
• GET /servers/{id} — one listing.
• PATCH /servers/{id} — edit (triggers AI re-scan).
• GET /servers/{id}/analytics — views, join clicks, bumps.
• GET /servers/{id}/reviews — reviews on your listing.
• POST /reviews/{id}/respond — owner response.

Ad campaigns

• GET /campaigns — your campaigns.
• POST /campaigns — create a campaign (AI-reviewed).
• GET /campaigns/{id} — one campaign.
• PATCH /campaigns/{id} — pause/resume, budget, bid.
• GET /campaigns/{id}/analytics — impressions, clicks, CTR, spend.
• GET /wallet — balance + transactions.
• POST /wallet/topup — add ad credit.

Reports & directory

• POST /reports — report a server/review/ad.
• GET /directory/search — public search (q, category, tag, sort, page, perPage).
• GET /directory/servers/{slug} — public listing.
• GET /meta — categories, tags, languages.

Example

curl -H "Authorization: Bearer $DISCAPEDIA_API_KEY" \
  "https://diswork.15.204.158.166.sslip.io/api/v1/servers"

Prefer a typed client? Use the SDK. Want it in an AI agent? Use the MCP server.