API - Gcut URL Shortener

Postman collection

Import the shorten, stats, and list requests into Postman. The easy Auth-Key hit is included.

Downloaded 0 times

Download

Auth-Key

Your Auth-Key:

Login

This is the same Auth-Key shown on your profile. Use it with no spaces.

API Endpoints

GET https://gcut.in/{Auth-Key}&{full-url}

Hit this URL in a browser, curl, or Postman. The response is the short link as plain text. Shortening works only while your paid plan is active.

Example:

https://gcut.in/{Auth-Key}&https://example.com/very/long/url

Response:

https://gcut.in/ab12

The response is plain text. Add &format=json at the end, or send Accept: application/json, for JSON. Same result: https://gcut.in/api/v1/shorten.php?key={Auth-Key}&url={full-url}.

POST https://gcut.in/api/v1/shorten.php

Shorten a long URL into a short link. Returns the shortened URL with analytics data.

Parameter	Type	Required	Description
`url`	string	Yes	The long URL to be shortened
`custom_code`	string	No	Custom short code (2-32 characters, paid plan)
`expires_at`	string	No	Expiration date (ISO 8601, paid plan). Free links expire in 30 days.

Example Request:

POST https://gcut.in/api/v1/shorten.php X-Auth-Key: {Auth-Key} Content-Type: application/json { "url": "https://example.com/very/long/url/path" }

Example Response:

{ "success": true, "data": { "short_url": "https://gcut.in/my-link", "original_url": "https://example.com/very/long/url/path", "short_code": "my-link", "clicks": 0, "created_at": "2024-01-15T10:30:00Z", "expires_at": "2024-12-31T23:59:59Z" } }

GET https://gcut.in/api/v1/stats.php?code={short_code}

Get analytics and statistics for a shortened URL including click counts, location data, and device information.

Parameter	Type	Required	Description
`short_code`	string	Yes	The short code in the URL path (e.g., "GW01")

Example Request:

GET https://gcut.in/api/v1/stats.php?code=ab12 Headers: X-Auth-Key: {Auth-Key}

Example Response:

{ "success": true, "data": { "short_code": "GW01", "short_url": "https://gcut.in/GW01", "original_url": "https://example.com/very/long/url/path", "total_clicks": 143, "created_at": "2024-01-15T10:30:00Z", "expires_at": null, "is_active": true } }

GET https://gcut.in/api/v1/urls.php

Get a list of all your shortened URLs with pagination support.

Parameter	Type	Required	Description
`page`	integer	No	Page number (default: 1)
`limit`	integer	No	Items per page (default: 10, max: 100)
`status`	string	No	Filter by status: "active", "inactive", "expired"

Example Request:

GET https://gcut.in/api/v1/urls.php?page=1&limit=10&status=active Headers: X-Auth-Key: {Auth-Key}

Authentication

REST calls use your Auth-Key. Send it as X-Auth-Key or as a Bearer token. The easy shorten URL puts the same key in the path.

Auth-Key header:

X-Auth-Key: {Auth-Key}

Bearer token:

Authorization: Bearer {Auth-Key}

Rate Limits

Shortening a URL requires an active paid plan. When the plan ends, the API stops creating short links. Other API requests are rate-limited as follows:

Plan	Requests per Minute	Requests per Day
Free	10	1,000
Paid	100	100,000

API Documentation

Postman collection