Help CenterAPI & Developers
Help Center

API & Developers

Integrate URL shortening into your applications using the HidURL REST API.

How do I get an API key?

Go to Dashboard → Settings → API Keys tab. Click Create API Key, give it a name, and your key will be generated and shown once. Copy it immediately - for security, the full key is only shown once. You can create multiple keys and manage them from the same page.

How do I shorten a URL via API?

Send a POST request to https://api.hidurl.com/v1/shorten with your API key in the Authorization header: curl -X POST https://api.hidurl.com/v1/shorten \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url": "https://example.com/long-url"}' See the full API documentation at hidurl.com/app/docs/api.

What are the API rate limits?

Rate limits depend on your plan: • Free: 5 requests/minute, 50 requests/day • Starter: 60 requests/minute, 10,000 requests/day • Pro: 120 requests/minute, 50,000 requests/day • Bulk: 300 requests/minute, 100,000 requests/day • Enterprise: Unlimited Exceeding limits returns a 429 Too Many Requests response.

What is bulk URL creation?

Bulk URL creation lets you shorten multiple URLs in a single API call. Send a POST to /v1/bulk with an array of URLs. Available on Bulk and Enterprise plans. Maximum 100 URLs per bulk request.

How do I rotate or revoke an API key?

In Dashboard → Settings → API Keys, click the rotate icon (↺) next to a key to generate a new token. The old token stops working immediately. To disable a key temporarily without deleting it, click Enable/Disable. To permanently remove a key, click the trash icon.