Short Link API

Short Link API
Create short URLs on guguurl.com, manage destination URLs and expiration times, disable links when needed, and track total clicks through a simple REST API.

Method: POST
Path: /v1/shortLinks
Demo: https://api.gugudata.io/v1/shortLinks/demo
OpenAPI: https://gugudata.io/assets/openapi/gugudata.openapi.3.1.json

Request Parameters:

appkey (string, required): Application key used for request authentication. Supply the value as a query parameter, form field, or multipart field according to the request content type.

longUrl (string, required): Destination URL. Must use HTTP or HTTPS.

shortLinkId (string, optional): Optional custom short link ID. Use 4 to 32 letters, numbers, underscores, or hyphens.

expireTime (string, optional): Optional expiration time.

Response Fields:

data.name (string, required): Resource name of the created short link.

data.shortLinkId (string, required): Short link ID.

data.shortUrl (string, required): Generated short URL.

data.longUrl (string, required): Destination URL.

data.state (string, required): Short link state. ACTIVE links redirect; DISABLED links do not redirect.

data.clickCount (integer, required): Total redirect count.

data.expireTime (string, optional): Expiration time, if set.

HTTP Status Codes:

200: Request processed successfully. Some endpoints expose a separate application-level status field in the response body, such as dataStatus.statusCode.

400: Invalid request parameters or request format. Check required fields, data types, and request body format.

401: Missing or unknown application key. Provide a valid appkey with the request.

403: The application key is recognized but access is not allowed. The key may be expired, inactive, or not permitted for the requested API.

429: Request rate or trial usage limit exceeded. Reduce concurrency or retry after the limit window resets.

500: Internal service error. Retry later or contact support if the error persists.

503: Upstream service unavailable. Retry later; the requested upstream dependency is temporarily unavailable.

Business Status Codes:

200 Normal return: Short link created or returned successfully

400 Parameter error: Missing or invalid request parameters

403 Permission denied: A paid API key is required

404 Short link not found: The requested short link does not exist or is not available to the current account

409 Short link ID already exists: The requested custom short link ID is already in use

410 Short link unavailable: The short link is disabled or expired

Key Features:

Create short URLs on guguurl.com for sharing, campaigns, and app redirects.

Use custom short link IDs or automatically generated codes.

Set optional expiration times for temporary links.

Update destination URLs or disable links when campaigns end.

Track total click counts and last access time.

Keep public short links on a dedicated short domain.

Details:
https://gugudata.io/details/shortlink

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Request

Request Code Samples

Responses