Go2.gg — Edge-Native URL Shortener

URL shortening, analytics, QR codes, webhooks, galleries (link-in-bio). Built on Cloudflare's edge network with sub-10ms redirects globally.

Setup

Get API key from: (free, no credit card required)

export GO2GG_API_KEY="go2_your_key_here"

API base: **Auth:** Authorization: Bearer $GO2GG_API_KEY **Docs:** --- ## Short Links Create, manage, and track short links with custom slugs, tags, expiration, passwords, and geo/device targeting. ### Create a Link __CODE_BLOCK_1__ **Important:** Field is destinationUrl (not url). Slug is optional (auto-generated if omitted). ### Response __CODE_BLOCK_2__ ### List Links __CODE_BLOCK_3__ **Query params:** page, perPage (max 100), search, domain, tag, archived, sort (created/clicks/updated) ### Update a Link __CODE_BLOCK_4__ ### Delete a Link __CODE_BLOCK_5__ ### Link Analytics __CODE_BLOCK_6__ Returns: totalClicks, byCountry, byDevice, byBrowser, byReferrer, overTime ### Advanced Link Options __CODE_BLOCK_7__ ### Create Link Parameters | Field | Type | Required | Description | |-------|------|----------|-------------| | destinationUrl | string | yes | Target URL to redirect to | | slug | string | no | Custom slug (auto-generated if omitted) | | domain | string | no | Custom domain (default: go2.gg) | | title | string | no | Link title | | description | string | no | Link description | | tags | string[] | no | Tags for filtering | | password | string | no | Password protection | | expiresAt | string | no | ISO 8601 expiration date | | clickLimit | number | no | Max clicks allowed | | geoTargets | object | no | Country → URL mapping | | deviceTargets | object | no | Device → URL mapping | | iosUrl | string | no | iOS app deep link | | androidUrl | string | no | Android app deep link | | utmSource/Medium/Campaign/Term/Content | string | no | UTM parameters | --- ## QR Codes Generate customizable QR codes. **QR generation is free and requires no auth.** ### Generate QR Code (No Auth Required) __CODE_BLOCK_8__ ### QR Parameters | Field | Type | Default | Description | |-------|------|---------|-------------| | url | string | required | URL to encode | | size | number | 256 | Size in pixels (64-2048) | | foregroundColor | string | #000000 | Hex color for modules | | backgroundColor | string | #FFFFFF | Hex color for background | | cornerRadius | number | 0 | Module corner radius (0-50) | | errorCorrection | string | M | L (7%), M (15%), Q (25%), H (30%) | | format | string | svg | svg or png | ### Save & Track QR Codes (Auth Required) __CODE_BLOCK_9__ --- ## Webhooks Receive real-time notifications for link clicks, creations, and updates. __CODE_BLOCK_10__ **Events:** click, link.created, link.updated, link.deleted, domain.verified, qr.scanned, * (all) Webhook payloads include X-Webhook-Signature (HMAC SHA256) for verification. Retries: 5s → 30s → 2m → 10m. --- ## Galleries (Link-in-Bio) Create link-in-bio pages programmatically. __CODE_BLOCK_11__ **Themes:** default, minimal, gradient, dark, neon, custom (with customCss) **Item types:** link, header, divider, embed (youtube), image --- ## Python Example __CODE_BLOCK_12__ --- ## API Endpoint Summary | Service | Endpoint | Method | Auth | |---------|----------|--------|------| | **Links** create | /api/v1/links | POST | yes | | Links list | /api/v1/links | GET | yes | | Links get | /api/v1/links/:id | GET | yes | | Links update | /api/v1/links/:id | PATCH | yes | | Links delete | /api/v1/links/:id | DELETE | yes | | Links stats | /api/v1/links/:id/stats | GET | yes | | **QR** generate | /api/v1/qr/generate | POST | **no** | | QR save | /api/v1/qr | POST | yes | | QR list | /api/v1/qr | GET | yes | | QR download | /api/v1/qr/:id/download | GET | yes | | **Webhooks** | /api/v1/webhooks | CRUD | yes | | Webhook test | /api/v1/webhooks/:id/test | POST | yes | | **Galleries** | /api/v1/galleries | CRUD | yes | | Gallery items | /api/v1/galleries/:id/items | CRUD | yes | | Gallery publish | /api/v1/galleries/:id/publish` | POST | yes |

Rate Limits

Plan	Requests/min

Free	60
Pro	300
Business	1000

Error Codes

Code	Description

SLUG_RESERVED	Slug is reserved
SLUG_EXISTS	Slug already in use on this domain
INVALID_URL	Destination URL is invalid
LIMIT_REACHED	Plan's link limit reached
DOMAIN_NOT_VERIFIED	Custom domain not verified