imup.cc v1 REST API & Native MCP

Developer REST API & Rate Limits

Integrate URL shortening, unshortening security analysis, live polls, reactive forms, and QR generation directly into your apps and AI agents.

Sliding Window Rate Limit Bearer / X-API-Key JSON-RPC 2.0 MCP SSRF Protected

Rate Limiting & Quota Policy

To guarantee high availability and fair usage, all REST and MCP endpoints are protected by millisecond-precision sliding window rate limiting.

60s Window
Membership & API Key Required Required

To access REST API endpoints, membership and a valid API key (Bearer or X-API-Key) are strictly required. Unauthenticated requests are rejected with HTTP 401.

Rate Limits & Quotas (Sliding Window) 120 - 300 req / min

Authenticated API keys and member accounts receive a high-speed quota of 120 to 300 requests per 1-minute sliding window.

Standard HTTP Rate Limit Headers

Header Description Sample Value
X-RateLimit-Limit Total allowed requests in the current sliding window 120
X-RateLimit-Remaining Remaining request allowance until window reset 119
X-RateLimit-Reset Unix timestamp when the window resets (seconds) 1760618400
Retry-After Seconds to wait before retrying after HTTP 429 42
REST API HTTP 401 (Key Required) Response
{
  "success": false,
  "error": "API key or membership is required to access the REST API. Please sign in or pass an API key.",
  "code": "API_KEY_REQUIRED"
}
REST API HTTP 429 Response
{
  "success": false,
  "error": "Rate limit exceeded. Try again in 42 seconds.",
  "retryAfter": 42,
  "limit": 120
}
MCP (JSON-RPC 2.0) HTTP 429 Response
{
  "jsonrpc": "2.0",
  "id": "req-1",
  "error": {
    "code": -32000,
    "message": "Rate limit exceeded. Try again in 42 seconds."
  }
}

Authentication

Membership and a valid API key are required to access all REST API endpoints. You can pass your API key in HTTP requests using either of the following formats:

Format 1: Bearer Token
Authorization: Bearer imup_live_xxxxxxxxxxxxxxxx
Format 2: X-API-Key Header
X-API-Key: imup_live_xxxxxxxxxxxxxxxx
You can generate your API key instantly from the Management Dashboard or via the MCP Hub integration.

REST API v1 Endpoints

All endpoints accept and return JSON payloads.

15 Active Endpoints
GET /api/v1
Cost: 1 120 - 300/min (Key/Member)

API Discovery & Rate Limit Status

Returns API version, client IP / authentication state, and current sliding window rate limit quotas.

Sample cURL Request
curl -X GET "https://imup.cc/api/v1" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /api/v1/links
Cost: 1 120 - 300/min (Key/Member)

Create Short Link

Shortens a long target URL with optional custom slug, password, title, and expiration.

Sample cURL Request
curl -X POST "https://imup.cc/api/v1/links" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target_url": "https://example.com/very-long-url", "title": "My Link"}'
GET /api/v1/links/:id
Cost: 1 120 - 300/min (Key/Member)

Get Link Details & Stats

Retrieves link details, destination URL, active status, creation date, and total click counter.

Sample cURL Request
curl -X GET "https://imup.cc/api/v1/links/LINK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
PATCH /api/v1/links/:id
Cost: 1 120 - 300/min (Key/Member)

Update Short Link

Updates destination target URL, status (active/inactive), and title.

Sample cURL Request
curl -X PATCH "https://imup.cc/api/v1/links/LINK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target_url": "https://example.com/updated-url"}'
DELETE /api/v1/links/:id
Cost: 1 120 - 300/min (Key/Member)

Delete Short Link

Permanently removes a short link from the registry.

Sample cURL Request
curl -X DELETE "https://imup.cc/api/v1/links/LINK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /api/v1/links/unshorten
Cost: 1 120 - 300/min (Key/Member)

Unshorten & Security Analysis

Resolves redirect chains for any shortened URL, validates safety, and strips UTM/tracking params.

Sample cURL Request
curl -X POST "https://imup.cc/api/v1/links/unshorten" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://bit.ly/3xyz?utm_source=test"}'
POST /api/v1/links/bulk
Cost: N (1 per URL) 120 - 300/min (Key/Member)

Bulk Shorten Links

Creates up to 50 short links in a single atomic transaction. Rate limit cost equals number of URLs.

Sample cURL Request
curl -X POST "https://imup.cc/api/v1/links/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://site1.com", "https://site2.com"]}'
POST /api/v1/polls
Cost: 1 120 - 300/min (Key/Member)

Create Live Poll

Creates a real-time polling widget with custom question and up to 10 choices.

Sample cURL Request
curl -X POST "https://imup.cc/api/v1/polls" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Favorite stack?", "options": ["Node.js", "Next.js", "Django"]}'
GET /api/v1/polls/:uuid
Cost: 1 120 - 300/min (Key/Member)

Get Poll & Live Results

Retrieves poll questions, option vote counts, and calculated percentage distribution.

Sample cURL Request
curl -X GET "https://imup.cc/api/v1/polls/POLL_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /api/v1/polls/:uuid/vote
Cost: 1 120 - 300/min (Key/Member)

Cast Poll Vote

Submits a vote for a specific option ID with anti-ballot stuffing validation.

Sample cURL Request
curl -X POST "https://imup.cc/api/v1/polls/POLL_UUID/vote" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"option_ids": [1]}'
POST /api/v1/forms
Cost: 1 120 - 300/min (Key/Member)

Create Reactive Form

Creates a custom form with flexible fields (text, email, select, rating, textarea).

Sample cURL Request
curl -X POST "https://imup.cc/api/v1/forms" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Customer Feedback", "description": "Quick survey"}'
GET /api/v1/forms/:uuid
Cost: 1 120 - 300/min (Key/Member)

Get Form Schema & Stats

Fetches form fields, configuration, status, and response counts.

Sample cURL Request
curl -X GET "https://imup.cc/api/v1/forms/FORM_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /api/v1/forms/:uuid/submit
Cost: 1 120 - 300/min (Key/Member)

Submit Form Response

Submits validated answers for form fields with optional idempotency key.

Sample cURL Request
curl -X POST "https://imup.cc/api/v1/forms/FORM_UUID/submit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"answers": {"FIELD_ID_1": "Ahmet", "FIELD_ID_2": "user@example.com"}}'
GET /api/v1/qr
Cost: 1 120 - 300/min (Key/Member)

Generate QR Code

Generates high-resolution QR codes in PNG (binary), SVG (vector), or JSON (base64 data URL).

Sample cURL Request
curl -X GET "https://imup.cc/api/v1/qr?text=https://imup.cc&format=png&size=300" \
  -H "Authorization: Bearer YOUR_API_KEY" --output qr.png
POST / GET /api/mcp
Cost: 1 60/min (IP), 300/min (Key)

Model Context Protocol (MCP) Endpoint

JSON-RPC 2.0 endpoint for AI assistants (Claude Desktop, Cursor, Windsurf) featuring 14 native tools. Governed by identical sliding window rate limits.

Sample cURL Request
curl -X POST "https://imup.cc/api/mcp" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": "1", "method": "tools/list"}'
Model Context Protocol

MCP Server for AI Agents

Manage short links, polls, and forms directly from Cursor, Claude Desktop, or Windsurf. Protected by the same high-speed sliding window rate limits.

Explore MCP Hub