Partner API

The Shortner API lets partner accounts create and manage links programmatically — useful for publishing pipelines, newsletter tooling, and anywhere links are generated in volume. Access tokens are issued per account; contact us if your account needs one.

Authentication

All requests are HTTPS and authenticated with a bearer token:

Authorization: Bearer <your-api-token>

Create a link

POST /v1/links
Content-Type: application/json

{
  "destination": "https://example.com/very/long/page?utm_source=newsletter",
  "slug": "spring-sale"        // optional; omit for a random code
}

Response:

{
  "short_url": "https://website-shortner.link/spring-sale",
  "destination": "https://example.com/very/long/page?utm_source=newsletter",
  "created_at": "2026-10-02T14:11:08Z"
}

Update a destination

PATCH /v1/links/spring-sale
Content-Type: application/json

{ "destination": "https://example.com/new/landing" }

The short URL stays the same; future clicks redirect to the new destination immediately.

Read statistics

GET /v1/links/spring-sale/stats?range=30d

{
  "clicks": 1482,
  "by_day": [ ... ],
  "top_referrers": [ ... ],
  "by_country": [ ... ]
}

Limits & conduct

• Default rate limit: 60 requests per minute per token. Higher limits by arrangement.
• Every link created via the API is subject to the Acceptable Use Policy, exactly as in the dashboard.
• Tokens are secrets — keep them out of client-side code and public repositories. Compromised tokens can be rotated from the dashboard or via support.

Full endpoint reference documentation is provided to partner accounts at onboarding.