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"}' const res = await fetch("https://api.blinkhop.com/v1/links", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ url: "https://example.com/a/very/long/link" }),
});
const { short_url } = await res.json(); import requests
r = requests.post(
"https://api.blinkhop.com/v1/links",
json={"url": "https://example.com/a/very/long/link"},
timeout=10,
)
print(r.json()["short_url"]) 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
| What | URL | Notes |
|---|---|---|
| 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..mdversionsAdd.mdto any docs, guide or help URL for clean Markdown./openapi.jsonThe OpenAPI 3.1 description, for tools and code generators.