cut2

API

Plain JSON over HTTPS. Base URL https://cut2.co/api. CORS is open, so you can call it from a browser too.

Authentication

Every request except key creation sends your key as a bearer token. Get a key by shortening any link on the home page, then click "show" next to API key under Your links. The key is your account: keep it secret, and we can't recover it.

Authorization: Bearer ck_…

Errors come back as {"error": "message"} with a matching HTTP status: 400 bad input, 401 bad key, 403 not allowed on your plan, 404 not found, 409 alias taken, 422 destination flagged as malware or phishing, 429 slow down.

Create a link

curl https://cut2.co/api/links \
  -H "Authorization: Bearer $CUT2_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/spring-sale?ref=x", "alias": "spring"}'
201 {"short_url":"https://cut2.co/spring","slug":"spring","url":"https://example.com/spring-sale?ref=x","qr":"https://cut2.co/spring.qr"}
FieldTypeWhat it does
urlstring, requiredDestination, http or https.
aliasstringCustom slug, 3–64 of A-Z a-z 0-9 _ -. Random 7 characters if omitted.
domainstringOne of your connected custom domains. Default cut2.co.
osobjectPer-platform destinations. Keys: ios, android, windows, macos, linux. Values can be store URLs, universal links, or app schemes like myapp://item/42. On Android, intent://…#Intent;scheme=myapp;package=com.example;S.browser_fallback_url=…;end opens the app and falls back to the web.
geoobjectPer-country destinations, keyed by ISO code: {"IN": "https://example.in", "DE": "https://example.de"}.
ogobjectWhat Slack, WhatsApp, X and others show in previews: {"title", "description", "image"}.
passwordstringVisitors must enter it before the redirect.
expires_atintegerUnix time in milliseconds. The link returns 410 after this.
max_clicksintegerThe link stops working after this many human clicks.

Rules apply in this order: platform, then country, then url. iPads on iPadOS 13+ identify as Mac, so set the same destination for macos if iPad users matter.

{"url": "https://example.com/app",
 "os": {"ios": "https://apps.apple.com/app/id123", "android": "https://play.google.com/store/apps/details?id=com.example",
        "windows": "https://apps.microsoft.com/detail/9abc", "macos": "https://apps.apple.com/app/id456"},
 "geo": {"IN": "https://example.in"},
 "og": {"title": "Get the app", "image": "https://example.com/card.png"}}

Create in bulk

Send up to 20 links per request (100 on Pro and Business). They're written in a single database round trip. Each item succeeds or fails on its own.

curl https://cut2.co/api/links -H "Authorization: Bearer $CUT2_KEY" -H "Content-Type: application/json" \
  -d '{"links": [{"url": "https://example.com/a"}, {"url": "https://example.com/b", "alias": "bee"}]}'
201 {"links":[{"short_url":"https://cut2.co/x7Gk2Qa",…},{"error":"alias \"bee\" is taken","url":"https://example.com/b"}]}

List, read, update, delete

GET    /api/links?limit=50&before=<created_at>   newest first; pass "next" back as before= to page
GET    /api/links/{slug}?host=cut2.co
PATCH  /api/links/{slug}?host=cut2.co               any create field except alias; send null to clear
DELETE /api/links/{slug}?host=cut2.co               204; the slug is retired and never reissued

Edits take effect worldwide within 5 minutes; most visitors see them at once.

Analytics

GET /api/links/{slug}/stats?days=30&host=cut2.co     days: 1–90
{"total":1840,
 "days":{"2026-11-16":212,"2026-11-17":95},
 "countries":{"IN":1100,"US":402},
 "referrers":{"direct":900,"t.co":512},
 "platforms":{"android":900,"ios":500,"windows":300,"macos":120},
 "devices":{"mobile":1400,"desktop":420,"tablet":20},
 "browsers":{"Chrome":1000,"Safari":700}}

Bots and link-preview crawlers aren't counted. Results are cached for 5 minutes.

QR codes

Add .qr to any short link to get an SVG. It needs no key, it's free on every plan, and it never expires. Change colours with hex fg and bg:

https://cut2.co/spring.qr
https://cut2.co/spring.qr?fg=1f3a5f&bg=ffffff

Add + to any short link (cut2.co/spring+) to see where it goes without visiting it.

Custom domains

POST   /api/domains        {"host": "go.example.com"}
GET    /api/domains
GET    /api/domains/{host}  status and SSL progress
PATCH  /api/domains/{host}  app association files (below)
DELETE /api/domains/{host}  also deletes that domain's links

After adding a domain, create the DNS record shown in the response:

go.example.com  CNAME  domains.cut2.co

SSL is issued automatically, usually within a few minutes. Then pass "domain": "go.example.com" when creating links.

App links (iOS universal links and Android App Links)

Make your short links open your app directly, with no browser hop. Upload your association files, and cut2 serves them at /.well-known/ on your domain:

PATCH /api/domains/go.example.com
{"apple_app_site_association": {"applinks": {"details": [{"appIDs": ["TEAMID.com.example.app"], "components": [{"/": "/*"}]}]}},
 "assetlinks": [{"relation": ["delegate_permission/common.handle_all_urls"],
   "target": {"namespace": "android_app", "package_name": "com.example.app", "sha256_cert_fingerprints": ["AB:CD:…"]}}]}

Then add applinks:go.example.com to your iOS app's Associated Domains and an autoVerify intent filter for go.example.com in your Android manifest. Send null to remove a file.

Rate limits

30 link-create requests per minute per IP, which is up to 600 links a minute on the free plan with bulk. Redirects are never rate-limited.

Pricing

FreePro · $9/moBusiness · $39/mo
RedirectsUnlimited, no ads, everUnlimitedUnlimited
Links per bulk request20100100
QR codesUnlimited, never expireUnlimitedUnlimited
Custom domains110100
Deep links, geo, password, expiryIncludedIncludedIncluded
Analytics history90 days90 days90 days
APIIncludedIncludedIncluded

Our promises: links and QR codes keep working even if you downgrade, a deleted slug is never given to anyone else, and your price is locked for as long as you stay subscribed. Paid plans open soon. Email us to get on the list.