GCloudy | API Documentation

GCloudy API Documentation

Integrate GCloudy with your applications using our comprehensive API

Main API
Instant API
Paid API

Your Demo API Key

Keep this key secret. Do not share it in client-side code or public repositories.

Getting Started

The GCloudy API allows you to programmatically generate direct download links from Google Drive URLs. All API requests must include your email and API token. The API supports GET methods.

Your Email Copy 
demo@demo.com
Base URL Copy 
https://www.gcloudy.xyz

API Endpoints

All endpoints require authentication via your email and API token.

GET /api/upload/link
Generate direct download links from Google Drive URLs. Supports both single and multiple URLs in a single request.

Request Parameters

Parameter Type Required Description
email string Yes Your registered email address
api_token string Yes Your API authentication token
url string|array Yes Single Google Drive URL or array of URLs

Example GET Request

URL Copy 
https://www.gcloudy.xyz/api/upload/link?email=demo@demo.com&api_token=tmkc_3567144ece09e914ed20208c2cd9329b&url=https://drive.google.com/file/d/1HAcJvyoqDFY-mXfCt91fjtbAb5/view

Example Response

JSON Copy 
{
  "status": "success",
  "processed": 2,
  "failed": 0,
  "results": [
    {
      "original_url": "https://drive.google.com/file/d/1HAcJvyoqDFY-mXfCt91fjtbAb5/view",
      "short_link": "https://www.gcloudy.xyz/dl/abc123",
      "download_link": "https://GCloudy.dl/abc123?dl=1",
      "short_code": "abc123"
    },
    {
      "original_url": "https://drive.google.com/file/d/1TYhfpH-mXfCt91fjtUIB9/view",
      "short_link": "https://www.gcloudy.xyz/dl/def456",
      "download_link": "https://www.gcloudy.xyz/dl/def456?dl=1",
      "short_code": "def456"
    }
  ],
  "errors": []
}

API Usage Examples

Here are examples of how to use the GCloudy API with different programming languages.

PHP Example

Examples GET methods:

PHP - GET Request Copy 
<?php
// GET request example
$email = 'demo@demo.com';
$apiToken = 'tmkc_3567144ece09e914ed20208c2cd9329b';
$url = 'https://drive.google.com/file/d/1HAcJvyoqDFY-mXfCt91fjtbAb5/view';

$apiUrl = 'https://www.gcloudy.xyz/api/upload/link?email=' . urlencode($email) . 
          '&api_token=' . urlencode($apiToken) . 
          '&url=' . urlencode($url);

$response = file_get_contents($apiUrl);
$data = json_decode($response, true);

print_r($data);
?>

Python Example

Examples GET methods:

Python - GET Request Copy 
import requests
import urllib.parse

email = "demo@demo.com"
api_token = "tmkc_3567144ece09e914ed20208c2cd9329b"
url = "https://drive.google.com/file/d/1HAcJvyoqDFY-mXfCt91fjtbAb5/view"

# URL encode parameters
params = {
    "email": email,
    "api_token": api_token,
    "url": url
}
query_string = urllib.parse.urlencode(params)

response = requests.get(f"https://www.gcloudy.xyz/api/upload/link?{query_string}")
print(response.json())

JavaScript Example

Examples GET methods:

JavaScript - GET Request Copy 
const email = encodeURIComponent('demo@demo.com');
const apiToken = encodeURIComponent('tmkc_3567144ece09e914ed20208c2cd9329b');
const url = encodeURIComponent('https://drive.google.com/file/d/1HAcJvyoqDFY-mXfCt91fjtbAb5/view');

fetch(`https://www.gcloudy.xyz/api/upload/link?email=${email}&api_token=${apiToken}&url=${url}`)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

cURL Example

Example GET request:

cURL - GET Request Copy 
curl -G "https://www.gcloudy.xyz/api/upload/link" \
--data-urlencode "email=demo@demo.com" \
--data-urlencode "api_token=tmkc_3567144ece09e914ed20208c2cd9329b" \
--data-urlencode "url=https://drive.google.com/file/d/1HAcJvyoqDFY-mXfCt91fjtbAb5/view"

Error Handling

The API returns standard HTTP status codes along with JSON error messages.

Status Code Error Code Description
400 invalid_request Invalid request parameters
401 unauthorized Invalid email or API token
403 forbidden Insufficient permissions
429 rate_limit_exceeded Too many requests
500 server_error Internal server error

Example Error Response

JSON Copy 
{
  "status": "error",
  "message": "Invalid email or API token"
}

Instant API

Our Instant API provides a simplified way to integrate GCloudy into your applications with minimal setup. Authentication is optional but provides higher rate limits.

No Rate Limits

The Instant API has absolutely no rate limits for all users. Enjoy unlimited requests without any restrictions.

GET /api/upload/link/instant/v2 With Authentication
Generate direct download links from Google Drive URLs with your API token for enhanced features.

Request Parameters

Parameter Type Required Description
api_token string Yes Your API authentication token
url string Yes Google Drive URL to convert

Example Request

URL Copy 
https://www.gcloudy.xyz/api/upload/link/instant/v2?api_token=tmkc_3567144ece09e914ed20208c2cd9329b&url=https://drive.google.com/file/d/1kVjypFMsBd6wBf6zjd5jsxWesBAly042/view?usp=drive_link

Example Response

JSON Copy 
{
  "status": "success",
  "processed": 1,
  "failed": 0,
  "results": [
    {
      "short_link": "https://www.gcloudy.xyz/dl/2d4KJ4",
      "short_code": "2d4KJ4",
      "download_token_url": "https://www.gcloudy.xyz/Instant?token=TF0whUNKctu91_Rcf4qFR7lOpx6985LXbeVwOF4_aVowi-jYeK7kD7IOOrF-Ez-WDezGJT1LtU2MVDOUJz416t_G4_8YEGq1b4r1xW_fy9DzjcQI_4gSTKsr2lJMmlMP5CFaExPVVg0NQjFron2aGA",
      "is_folder_item": false
    }
  ],
  "errors": []
}
GET /api/upload/link/instant/v2 Without Authentication
Generate direct download links from Google Drive URLs without authentication. No rate limits for all users.

Request Parameters

Parameter Type Required Description
url string Yes Google Drive URL to convert

Example Request

URL Copy 
https://www.gcloudy.xyz/api/upload/link/instant/v2?url=https://drive.google.com/file/d/1kVjypFMsBd6wBf6zjd5jsxWesBAly042/view?usp=drive_link

Example Response

JSON Copy 
{
  "status": "success",
  "processed": 1,
  "failed": 0,
  "results": [
    {
      "short_link": "https://www.gcloudy.xyz/dl/2d4KJ4",
      "short_code": "2d4KJ4",
      "download_token_url": "https://www.gcloudy.xyz/Instant?token=TF0whUNKctu91_Rcf4qFR7lOpx6985LXbeVwOF4_aVowi-jYeK7kD7IOOrF-Ez-WDezGJT1LtU2MVDOUJz416t_G4_8YEGq1b4r1xW_fy9DzjcQI_4gSTKsr2lJMmlMP5CFaExPVVg0NQjFron2aGA",
      "is_folder_item": false
    }
  ],
  "errors": []
}

No Rate Limits

The Instant API has absolutely no rate limits for all users:

Plan Requests Concurrent Requests
Instant API (All Users) Unlimited Unlimited

Use Cases

The Instant API is perfect for:

Developers

Quick prototyping and testing without the need for API key setup

Students

Educational projects and learning API integration

Small Projects

Applications with high-volume API requirements

Operation completed successfully!