All features
Short URL API

Shorten links from inside your own product

A clean, predictable REST API that lets you shorten URLs, retrieve stats, and manage links programmatically — in any language, any stack.

curl -X POST https://api.hidurl.com/v1/public/shorten \
  -H "Authorization: Bearer your_api_token" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/very-long-url"}'

# Response
{
  "short_url": "https://hidurl.com/abc123",
  "short_code": "abc123",
  "original_url": "https://example.com/very-long-url"
}

What the API gives you

Shorten in one request

POST a URL and receive a short link, short code, and original URL back in a single JSON response.

Bulk creation

Send up to hundreds of URLs in a single request. Ideal for batch imports, data pipelines, or content migrations.

Click stats endpoint

Pull device, browser, OS, and referrer data for any of your short links directly from the API.

Simple Bearer token auth

Authenticate with an API key from your settings page. One header, zero OAuth flows.

Predictable JSON responses

Every endpoint returns consistent JSON. Errors include human-readable messages and standard HTTP codes.

Per-plan rate limits

Rate limits scale with your plan, from 5 req/min on Free up to unlimited on Enterprise.

Rate limits by plan

Free

5 / min

50 / day

Pro

60 / min

10,000 / day

Bulk

300 / min

100,000 / day

Enterprise

Unlimited

Unlimited

Start building with the HidURL API

Free API access included on all plans.