Short link API - documentation

JSON API for creating and inspecting short links. Use the API key issued for your account (or the platform API_TOKEN where applicable).

Public API: https://anyurl.bond - JSON under /api/v1/.

Authorization

Authorization: Bearer YOUR_API_KEY

Send the exact API key we provided as a Bearer token. Dashboard sign-in defaults to API key only; use the email sign-in page for your password.

POST /api/v1/shorten

{"long_url":"https://example.com","expiration_time":"24h","max_uses":100,"allow_bots":false}

{"long_url":"https://example.com","permanent":true}

Paid API (your account key): new links default to a 24-hour expiry when you omit expiration_time and permanent. Set "permanent": true for no expiry (paid only; uses one monthly smart edit, same bucket as PATCH/PUT). You may still send expiration_time and/or max_uses. Unpaid API tier: monthly new-link cap (UTC) and ~10 minute expiry per link, unchanged.

GET /api/v1/info/{short_code}

Returns metadata and validity for a short code without incrementing click counts.

GET /api/v1/me

Returns your plan tier, effective limits from the control-panel, and this month’s usage (new links and API edits, UTC month).

GET /api/v1/links

?limit=50&offset=0

Lists short links for your account API key only (owner_id matches that key; same scope as GET /info). The platform API token cannot use this endpoint. Optional query: limit (default 50, max 100), offset (default 0, max 100000). JSON: links (same fields as GET /info per item), total, limit, offset. Listing does not delete rows or increment clicks.

PUT / PATCH /api/v1/info/{short_code}

{"long_url":"https://example.com/new","expiration_time":"24h","max_uses":20,"allow_bots":false}

To change an existing short code, use PUT or PATCH on /api/v1/info/{short_code} - not POST /shorten. Body (JSON): any of long_url, expiration_time, max_uses, allow_bots. Omit a field to leave it unchanged. Clear time expiry with expiration_time "". max_uses must be >= 0 when provided (use a larger value to add allowed clicks). Response shape matches GET /info.

Command-line examples (curl)

YOUR_API_KEY is only a placeholder. Use your real API key. Examples use https://anyurl.bond.

POST /api/v1/shorten - full JSON (host https://anyurl.bond)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"expiration_time\":\"24h\",\"max_uses\":100,\"allow_bots\":false}"

POST /api/v1/shorten - minimal body (paid: defaults to 24 h expiry)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

POST /api/v1/shorten - permanent (paid; uses a smart edit)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"permanent\":true}"

GET /api/v1/info/{short_code} - example short code abc123

curl -sS 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer YOUR_API_KEY'

GET /api/v1/me

curl -sS 'https://anyurl.bond/api/v1/me' \
  -H 'Authorization: Bearer YOUR_API_KEY'

GET /api/v1/links - paginate your short links

curl -sS 'https://anyurl.bond/api/v1/links?limit=50&offset=0' \
  -H 'Authorization: Bearer YOUR_API_KEY'

PATCH /api/v1/info/{short_code}

curl -sS -X PATCH 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated-destination\"}"

PUT /api/v1/info/{short_code}

curl -sS -X PUT 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated\",\"expiration_time\":\"7d\",\"max_uses\":50,\"allow_bots\":true}"

Verbose (-v) for debugging

curl -v -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

Free API tier: up to 100 new short links per calendar month (UTC), with the allowance resetting on the 1st. Each link expires after about 10 minutes. Paid plans use the same monthly cycle.

Back to home · Terms and conditions