A small API for useful link workflows.
Create, update, route, and measure personal branded links. Every response is JSON; every error has a stable code.
Authentication
Send your personal API key as a bearer token. Keys are scoped to your account and can be revoked instantly.
curl -X POST https://api.bissto.app/api/v1/links \
+ -H "Authorization: Bearer bst_live_your_key" \
+ -H "Content-Type: application/json" \
+ -d '{"urls":["https://example.com/a","https://example.com/b"],"redirect_type":"302","slug":"launch"}'Keep keys server-side. Never expose a live key in browser code.
Create a link
POST
/api/v1/links| Field | Type | Description |
|---|---|---|
| url | string | Legacy single HTTP or HTTPS destination. |
| urls | string[] | One to ten unique destinations; do not combine with url. |
| redirect_type | string | 302, meta_refresh, or javascript. Defaults to 302. |
| slug | string | Optional unique alias. |
| domain_id | string | Optional verified personal domain. |
Link analytics
Returns totals, unique visits, time series, destination selection shares, country, referrer, device, browser, and operating-system breakdowns.
Domains
Create and inspect branded-domain onboarding through the versioned endpoints.
Errors
Errors include request IDs and stable machine-readable codes.