Skip to main content

Quick Start Guide

Get started with Joo.nz by following these steps to create and manage your shortened URLs.

Creating Your Account

  1. Visit joo.nz and click "Sign Up"
  2. Choose your sign-up method:
    • Email and password
    • Google account
    • GitHub account
    • Facebook account
  3. Fill in your basic information
  4. Verify your email address

Creating Short URLs

Using the Dashboard

  1. Log in to your Joo.nz account
  2. Click "Create New URL" on your dashboard
  3. Paste your long URL
  4. Click "Shorten"

Using the API

Create a URL:

curl -X POST https://joo.nz/api/v1/url/slim \
-H "x-api-key: YOUR-API-KEY" \
-H "Content-Type: application/json" \
-d '{
"originalUrl": "https://your-long-url.com",
"title": "My URL Title"
}'

Retrieve a URL:

curl -X GET https://joo.nz/api/v1/url/{url_id} \
-H "x-api-key: YOUR-API-KEY"

URL Customization Options

  • Custom path (e.g., joo.nz/my-link)
  • Title for identification
  • Expiration date
  • Password protection
  • Custom preview metadata

Analytics & Tracking

Your dashboard provides insights about:

  • Total clicks
  • Geographic locations
  • Device types
  • Referral sources

Free Plan Features

  • 25 URLs limit
  • Basic analytics
  • QR code generation
  • API access
  • Custom preview options

Support

Next Steps

Explore additional features:

Consider upgrading your plan to access more features and higher URL limits as your needs grow.