Quickstart

Follow these five steps to make your first Words Cloud API call.

1. Create an Account

Go to the Aspose Dashboard
Click Sign In with GitHub or Sign In with Google, or create an account with your email
Verify your email address

Your account includes 150 free API calls per month.

2. Create a Storage

Words Cloud processes documents from cloud storage. Create a storage container for your files:

In the dashboard sidebar, open Files
Click the storage dropdown and select Create New Storage
Choose Internal Storage (Aspose-managed) — simplest for getting started
Name it (e.g., my-documents)

For Azure, AWS S3, or other storage backends, see the deployment guides.

You can upload test documents through the Files page in the dashboard sidebar.

3. Create an API Client App

In the dashboard sidebar, open Applications
Click Create New Application
Enter a name (e.g., My Words App) and a description
Select your storage as the default
Click Save

Copy your Client Id and Client Secret — these are separate from your dashboard login. You will use them to authenticate API requests.

4. Install an SDK

Python

pip install aspose-words-cloud

.NET

dotnet add package Aspose.Words-Cloud

Java

Add the Aspose Maven repository (https://releases.aspose.cloud/java/repo/) and dependency com.aspose:aspose-words-cloud.

Node.js

npm install asposewordscloud

→ All 10 SDKs with install commands

5. Make an API Request

Replace CLIENT_ID and CLIENT_SECRET with your credentials.

Python

import asposewordscloud

api = asposewordscloud.WordsApi("CLIENT_ID", "CLIENT_SECRET")
result = api.get_info()
print(f"Words Cloud version: {result.version}")

.NET

using Aspose.Words.Cloud.Sdk;

var config = new Configuration
{
    ClientId = "CLIENT_ID",
    ClientSecret = "CLIENT_SECRET"
};
var api = new WordsApi(config);
var result = await api.GetInfo();
Console.WriteLine($"Version: {result.Version}");

Java

import com.aspose.words.cloud.*;

WordsApi api = new WordsApi(
    "CLIENT_ID", "CLIENT_SECRET", "https://api.aspose.cloud"
);
InfoResponse result = api.getInfo();
System.out.println("Version: " + result.getVersion());

cURL

# Get access token
TOKEN=$(curl -s -X POST "https://api.aspose.cloud/connect/token" \
  -d "grant_type=client_credentials&client_id=CLIENT_ID&client_secret=CLIENT_SECRET" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  | grep -o '"access_token":"[^"]*"' | cut -d'"' -f4)

# Call the API
curl -s "https://api.aspose.cloud/v4.0/words/info" \
  -H "Authorization: Bearer $TOKEN"

Next Steps

Developer Guide — all API operations
API Reference — interactive API explorer
Authentication Guide — token details and best practices
Rate Limits — understand usage limits

Overview Authentication