URLW Documentation

1. Introduction

URLW is a URL shortening service hosted in France 🇫🇷, designed for marketing teams and developers. It lets you:

• Transform any long URL into a shareable short link
• Track the number of clicks in real-time
• Automate link creation via the REST API
• Manage your links from a simple, clean dashboard

URLW is GDPR compliant. Your data never leaves Europe and is never sold to third parties.

2. Create an account

1. Go to urlw.fr/register
2. Enter your email address and a password
3. Click Create my account
4. You are logged in, your Free plan is active immediately

3. Shorten a link (dashboard)

1. Sign in and go to the Dashboard
2. Paste your long URL in the Shorten a URL field
3. Click Shorten
4. Your short link appears immediately in the list
5. Copy it in one click using the Copy button

4. Shorten a link via the API

See the full API Reference for all endpoints.

In summary, two steps:

Step 1 — Get an API key

curl -s -X POST https://urlw.fr/api/links \
  -H "Authorization: Bearer uw_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/url-tres-longue"}'

Response:

{
  "id": 42,
  "short_code": "aB3xYz",
  "short_url": "https://urlw.fr/aB3xYz",
  "original_url": "https://example.com/url-tres-longue",
  "clicks": 0,
  "created_at": "2026-04-18T12:00:00+00:00"
}

5. Track clicks

Every access to a short link is automatically counted. You can track clicks:

• Dashboard — The Clicks column updates in real-time
• API — The GET /api/links/{id} endpoint returns the click counter

6. Plans and quotas

* When quota is exceeded, new link creation is temporarily blocked until the start of the next month.

7. Quick FAQ

Are my links permanent?

Yes, as long as your account is active. You can delete a link at any time.

Can I customize the short code?

This feature is under development (coming soon).

What happens if I cancel my subscription?

You revert to the Free plan. Your existing links remain active but you can no longer create more beyond the Free limit.

How do I delete my account?

Contact us at %email%. All your data will be erased within 30 days.