Developer docs

Build with Blinkhop.

A REST API and an MCP server to create, batch and check short links from code or from an AI assistant. No key needed to start.

API at a glance

Base URL
https://api.blinkhop.com/v1
MCP server
https://mcp.blinkhop.com/mcp
API key
Not needed to start
Limits
20 links/min, 300/day per IP

Where to start

  • Quickstart

    Your first short link from code in 60 seconds, with a live console to try it.

  • API reference

    Every endpoint, parameter, response and error code.

  • Code samples

    JavaScript, Python, Go, PHP, PowerShell, Google Sheets and the shell.

  • MCP server

    Let Claude, ChatGPT, Cursor or VS Code shorten links for you.

The API in one request

Send a URL, get a short link back. No key, no SDK, no sign-up.

curl https://api.blinkhop.com/v1/links \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/a/very/long/link"}'

201 Created response

{
  "id": "lnk_7Kp2x",
  "code": "7Kp2x",
  "short_url": "https://zou.sh/7Kp2x",
  "url": "https://example.com/a/very/long/link",
  "qr_url": "https://zou.sh/7Kp2x/qr",
  "preview_url": "https://zou.sh/7Kp2x+",
  "clicks": 0,
  "created_at": "2026-10-11T14:02:11Z"
}

Base URLs

WhatURLNotes
REST API https://api.blinkhop.com/v1 CORS open
REST API on the main domain https://blinkhop.com/api/v1 Same origin as the website
MCP server https://mcp.blinkhop.com/mcp Streamable HTTP, no auth
Short links https://zou.sh/<code> Add + to preview, /qr for a QR code
OpenAPI 3.1 https://api.blinkhop.com/v1/openapi.json Also at blinkhop.com/openapi.json

Limits without a key

20

links per minute

300

links per day

100

URLs per bulk call

120

MCP calls per minute

Limits apply per IP address, and each create or expand response tells you how many calls you have left. API keys with higher limits come with accounts, now in early access. Details in the API reference.

Docs for AI assistants

  • /llms.txtAn index of our docs, guides and help articles, in the llms.txt format.
  • /llms-full.txtThe full developer documentation in one Markdown file.
  • .md versionsAdd .md to any docs, guide or help URL for clean Markdown.
  • /openapi.jsonThe OpenAPI 3.1 description, for tools and code generators.

Common questions