Scoped keys
Create one key per integration and revoke it without touching the rest.
Developers
Build with PerfectLink.
A small, predictable REST API for creating and managing links from your own applications.
Authentication
Every request carries a bearer token. Keys are created in the dashboard, scoped to one account, and can be revoked without affecting the others.
# Send the key as a bearer token
Authorization: Bearer pl_live_3f9a…
# Keys are shown once at creation and
# stored only as a hash on our side.Create a link
POST a destination and get the short URL back. Aliases are optional; leave it out and a code is generated for you.
curl -X POST https://perfectlink.com/api/v1/links \
-H "Authorization: Bearer pl_live_key" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com","alias":"launch"}'Endpoints
Everything in version one of the API.
POST
/api/v1/linksCreate a short linkGET
/api/v1/linksList your linksGET
/api/v1/links/{id}Fetch one linkGET
/api/v1/links/{id}/analyticsClick breakdown for a linkDELETE
/api/v1/links/{id}Delete a linkRate limits are applied per key and returned in the response headers.
Built to be predictable
Clear rate limits
Documented per-key limits, with a Retry-After header when you hit one.
Honest errors
Failures explain what was wrong with the request, not just a status code.
Analytics endpoint
The same breakdown the dashboard shows, as JSON.