API reference

The Snipvio API lets you create links from your own scripts, tools, and automations.

Authentication

Generate a key at Dashboard → API Keys. The full key is shown once at creation and never again, because only a hash of it is stored. Copy it somewhere safe immediately.

Send it as a bearer token:

Authorization: Bearer snip_your_key_here

Revoke a key at any time from the same page. Revocation takes effect instantly.

Create a link

POST /api/v1/links
Content-Type: application/json
Authorization: Bearer snip_your_key_here

{ "url": "https://example.com/a/very/long/link" }

Response:

{
  "code": "x7Kp2",
  "shortUrl": "https://snipvio.com/x7Kp2",
  "destination": "https://example.com/a/very/long/link"
}

List your links

GET /api/v1/links
Authorization: Bearer snip_your_key_here

Returns your hundred most recent links, newest first:

{
  "links": [
    {
      "code": "x7Kp2",
      "destination": "https://example.com/page",
      "shortUrl": "https://snipvio.com/x7Kp2",
      "createdAt": "2026-08-07T12:59:13.000Z"
    }
  ]
}

Example: curl

curl -X POST https://snipvio.com/api/v1/links \
  -H "Authorization: Bearer snip_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/page"}'

Example: JavaScript

const res = await fetch("https://snipvio.com/api/v1/links", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SNIPVIO_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ url: "https://example.com/page" }),
});
const { shortUrl } = await res.json();

Example: Python

import os, requests

r = requests.post(
    "https://snipvio.com/api/v1/links",
    headers={"Authorization": f"Bearer {os.environ['SNIPVIO_KEY']}"},
    json={"url": "https://example.com/page"},
)
print(r.json()["shortUrl"])

Status codes

Notes

• Links created through the API appear in your dashboard like any other and count toward your monthly allowance.
• Keep keys server-side. A key in browser JavaScript can be read and used by anyone.
• API access requires a Premium plan or higher.