v1.0 — Public API

Rinkuru API

Create and manage short URLs programmatically. A simple, fast, and privacy-first URL shortening API — no authentication required for creating links.

Quick Start

The fastest way to create a short link — send a POST request with your URL and you're done.

cURL

curl -X POST https://rinkuru.kurusano.net/api/shortlink \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Base URL

The Rinkuru API is a URL shortener service. All endpoints use JSON. No authentication is needed to create short links — just send your request and receive a short URL instantly.

cURL

https://rinkuru.kurusano.net/api

Create Shortlink

Create a new short URL for any valid link

Endpoint

POST/api/shortlink

Request Body

urlrequiredThe URL to shorten (must be valid http/https)

titleoptionalA title for the shortlink

descriptionoptionalA description for the shortlink

imageUrloptionalAn image URL for OpenGraph previews

JSON

{
  "url": "https://example.com/very/long/url/that/needs/shortening",
  "title": "My Cool Link (optional)",
  "description": "An optional description (optional)",
  "imageUrl": "https://example.com/image.jpg (optional)"
}

Response

200 OKon success

JSON

{
  "id": "abc123",
  "shortUrl": "https://rinkuru.kurusano.net/abc123",
  "originalUrl": "https://example.com/very/long/url/that/needs/shortening",
  "title": "My Cool Link",
  "description": "An optional description",
  "imageUrl": "",
  "createdAt": "2026-07-27T12:00:00.000Z"
}

Error Responses

400Invalid URL format

429Rate limit exceeded

500Server error

JSON

{
  "error": "Invalid URL format"
}

Rate Limiting

To protect the service, the Rinkuru API enforces a rate limit of 20 requests per minute per IP address for link creation. If you exceed this limit, you will receive a 429 Too Many Requests response.

Tip: If you need higher rate limits for production use, consider implementing request queuing with exponential backoff on the client side.

Admin API

Rinkuru also provides authenticated admin endpoints for managing links (list, update, delete). These endpoints require session-based authentication and are not part of the public API.

Admin endpoints are available at /api/admin/links. Authentication is required — see the admin dashboard for details.

Code Examples

Ready-to-use examples in your preferred language

cURL

curl -X POST https://rinkuru.kurusano.net/api/shortlink \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/very/long/url/that/needs/shortening",
    "title": "My Cool Link",
    "description": "An optional description"
  }'