Installation

The package is available at nuget.org and it can be installed via package manager console by executing following command:

PM> NuGet\Install-Package GroupDocs.Classification-Cloud

Document Classification .NET Cloud REST API

GroupDocs.Classification Cloud is a powerful REST API designed for developers needing advanced text and document classification capabilities. Supporting multiple document formats and a wide range of taxonomies, this API allows you to classify raw text, documents, and batches of texts across various categories, including IAB-2, sentiment, and documents taxonomy. The API is secured with JWT authentication, and SDKs are available for multiple programming languages to simplify integration. With easy-to-use features and extensive documentation, GroupDocs.Classification Cloud is ideal for integrating classification capabilities into your applications.

Document Classification Features

File Format Support - Classify text and documents in many formats like PDF, DOCX, TXT.
Multi-language Support - Classify documents in multiple languages.
Custom Classification - Create custom classification categories to fit your needs.
Batch Classification - Classify multiple documents with one request.
Content-Based Classification - Classify documents based on their body content.

Taxonomy Classification Features

IAB-2 Taxonomy - Classify using the IAB-2 standard taxonomy.
Document Taxonomy - Classify documents into categories like ADVE, Email, Form, Letter, Memo.
Sentiment Taxonomy - Classify text into Positive or Negative sentiment.
Sentiment3 Taxonomy - Classify text into Positive, Neutral, or Negative sentiment.

API Integration Features

RESTful API - Access classification via a REST API for easy integration.
SDK Support - SDKs for .NET, Java, Python, PHP, etc., simplify integration.
Real-time Classification - Perform real-time classification of text and documents.
JSON and XML Responses - Receive results in JSON or XML for easy system integration.

Security and Authentication Features

JWT Authentication - Secure API access with JWT authentication.
Client ID and Secret - Use Client ID and Secret for secure API calls.
Data Encryption - Encrypt communication between client apps and Classification Cloud API.

Performance Features

Scalable Infrastructure - Handles large document volumes efficiently.
High Accuracy - Delivers highly accurate results using advanced ML algorithms.
Fast Processing - Optimized for fast classification for high‑performance apps.

Usability Features

API Explorer - Use the built‑in API Explorer to test functionality in your browser.
Comprehensive Documentation - Extensive docs and code samples to help you start quickly.
Multi-Platform Support - Works on Windows, Linux, macOS and other platforms.

Storage and File Management Features

Cloud Storage Integration - Integrates with cloud storage like AWS S3 and Google Cloud.
File Versioning - Manage different versions of classified documents.
Folder Management - Create, move, copy, and delete folders in your cloud storage.

Deployment and Hosting Features

Docker Support - Deploy Classification Cloud in Docker for private cloud or on‑premises.
Self-hosting - Run the API on your own infrastructure with full environment control.
Automatic Scaling - Automatically scales to handle workloads and ensure high availability.

Supported Document Formats

Supported Taxonomy

IAB-2 Taxonomy - Categories like Automotive, Books & Literature, Business & Finance, etc.
Documents Taxonomy - Classifications like ADVE, Email, Form, Letter, Memo, etc.
Sentiment Taxonomy - Binary sentiment classification: Negative and Positive.
Sentiment3 Taxonomy - Three‑class sentiment: Negative, Neutral, Positive.

Supported Taxonomies in Detail

IAB-2 Taxonomy

The IAB-2 taxonomy is an industry-standard classification used to categorize digital content, particularly in the context of advertising. This taxonomy includes a wide range of categories, some of which are:

Automotive

Includes content related to cars, motorcycles, and other vehicles.

Books and Literature

Covers content focused on books, authors, literary reviews, and related topics.

Business and Finance

Encompasses financial markets, business news, investment, and corporate information.

Health and Fitness

Pertains to content on health, wellness, fitness, and medical information.

Food and Drink

Covers recipes, restaurants, cooking tips, and related content.

Technology and Computing

Includes information on software, hardware, gadgets, and tech news.

Travel

Covers travel guides, tips, destinations, and tourism-related content.

This taxonomy helps in categorizing content for targeted advertising and content management purposes.

Documents Taxonomy

The Documents Taxonomy is designed to classify various types of documents based on their content and purpose. Key categories include:

ADVE (Advertisements)

Documents that are primarily focused on advertisements and promotional content.

Email

Classification of email documents, including both formal and informal emails.

Form

Documents designed as forms to be filled out by users, including applications, surveys, and questionnaires.

Letter

Formal and informal letters, including business correspondence, personal letters, and memos.

Memo

Brief documents used within organizations for internal communication.

This taxonomy is particularly useful for managing and organizing large collections of documents by their functional type.

Sentiment Taxonomy

The Sentiment Taxonomy is used to classify text based on the sentiment expressed within it. This taxonomy includes:

Negative Sentiment

Classifies text that conveys negative emotions, dissatisfaction, or criticism.

Positive Sentiment

Classifies text that conveys positive emotions, satisfaction, or praise.

This binary sentiment classification is useful for analyzing customer feedback, reviews, social media content, and other forms of textual data where sentiment plays a crucial role.

Sentiment3 Taxonomy

The Sentiment3 Taxonomy provides a more granular classification of sentiment, with three distinct categories:

Negative Sentiment

Text that conveys negative emotions, criticism, or dissatisfaction.

Neutral Sentiment

Text that is neutral in tone, neither positive nor negative, often informational or factual.

Positive Sentiment

Text that conveys positive emotions, praise, or satisfaction.

This taxonomy allows for a more nuanced understanding of sentiment in textual content, making it ideal for applications where more detailed sentiment analysis is required, such as in customer feedback, product reviews, and social media monitoring.

Get Started

You do not need to install anything to get started with GroupDocs.Classification Cloud SDK for .Net. Just create an account at GroupDocs for Cloud and get your application information.

Simply execute Install-Package GroupDocs.Classification-Cloud from Package Manager Console in Visual Studio to fetch & reference GroupDocs.Classification assembly in your project. If you already have GroupDocs.Classification Cloud SDK for .Net and want to upgrade it, please execute Update-Package GroupDocs.Classification-Cloud to get the latest version.

Please check the GitHub Repository for common usage scenarios.

Classify Raw Text Using GroupDocs.Classification Cloud

Learn how to classify raw text into specific categories using the GroupDocs.Classification Cloud API. This example demonstrates the classification process in C# with detailed comments.

using System;
using GroupDocs.Classification.Cloud.Sdk.Api;
using GroupDocs.Classification.Cloud.Sdk.Model;
using GroupDocs.Classification.Cloud.Sdk.Model.Requests;

namespace GroupDocs.Classification.Cloud.Sdk.Examples
{
    class Classification_CSharp_Classify_Raw_Text
    {
        public static void Run()
        {
            // Get your AppSID and AppKey from https://dashboard.groupdocs.cloud/ (free registration required)
            var configuration = new Configuration
            {
                AppSid = "YOUR_APP_SID",
                AppKey = "YOUR_APP_KEY"
            };

            // Initialize the Classification API instance
            var apiInstance = new ClassificationApi(configuration);

            try
            {
                // Create a classify request with the text to be classified and the taxonomy type
                var request = new ClassifyRequest(new BaseRequest() { Description = "Medicine is an important part of our life" }, "default");

                // Get classification results
                var response = apiInstance.Classify(request);
                
                // Output the classification result to the console
                Console.WriteLine("Best Class Name: " + response.BestClassName);
                Console.WriteLine("Best Class Probability: " + response.BestClassProbability);
            }
            catch (Exception e)
            {
                // Handle any exceptions that occur during the API call
                Console.WriteLine("Exception when calling ClassificationApi.Classify: " + e.Message);
            }
        }
    }
}

Get Supported File Formats Using GroupDocs.Classification Cloud API

Discover how to list all the supported file formats using the GroupDocs.Classification Cloud API. This example shows how to retrieve this information in C#.

using System;
using GroupDocs.Classification.Cloud.Sdk.Api;
using GroupDocs.Classification.Cloud.Sdk.Model.Requests;

namespace GroupDocs.Classification.Cloud.Sdk.Examples
{
    class Classification_CSharp_Classify_Get_Supported_File_Formats
    {
        public static void Run()
        {
            // Get your AppSID and AppKey from https://dashboard.groupdocs.cloud/ (free registration required)
            var configuration = new Configuration
            {
                AppSid = "YOUR_APP_SID",
                AppKey = "YOUR_APP_KEY"
            };

            // Initialize the Classification API instance
            var apiInstance = new ClassificationApi(configuration);

            try
            {
                // Create a request to get the list of supported file formats
                var request = new GetSupportedFileFormatsRequest();

                // Retrieve the supported file formats
                var response = apiInstance.GetSupportedFileFormats(request);

                // Loop through and output each supported format
                foreach (var format in response.Formats)
                {
                    Console.WriteLine("File Format: " + format.FileFormat + ", Extension: " + format.Extension);
                }
            }
            catch (Exception e)
            {
                // Handle any exceptions that occur during the API call
                Console.WriteLine("Exception when calling ClassificationApi.GetSupportedFileFormats: " + e.Message);
            }
        }
    }
}

Classify Document Using IAB-2 Taxonomy in GroupDocs.Classification

Learn how to classify documents into IAB-2 taxonomy categories using the GroupDocs.Classification Cloud API. This example illustrates the process in C#.

using System;
using GroupDocs.Classification.Cloud.Sdk.Api;
using GroupDocs.Classification.Cloud.Sdk.Model;
using GroupDocs.Classification.Cloud.Sdk.Model.Requests;

namespace GroupDocs.Classification.Cloud.Sdk.Examples
{
    class Classification_CSharp_Classify_Document_IAB2
    {
        public static void Run()
        {
            // Get your AppSID and AppKey from https://dashboard.groupdocs.cloud/ (free registration required)
            var configuration = new Configuration
            {
                AppSid = "YOUR_APP_SID",
                AppKey = "YOUR_APP_KEY"
            };

            // Initialize the Classification API instance
            var apiInstance = new ClassificationApi(configuration);

            try
            {
                // Define the document to classify
                var documentInfo = new FileInfo { Folder = "path/to/folder", Name = "document.docx" };

                // Create a classify request with the document info and specify the IAB-2 taxonomy
                var request = new ClassifyRequest(new BaseRequest() { Document = documentInfo }, "default");

                // Get classification results
                var response = apiInstance.Classify(request);
                
                // Output the classification result to the console
                Console.WriteLine("Best Class Name: " + response.BestClassName);
                Console.WriteLine("Best Class Probability: " + response.BestClassProbability);
            }
            catch (Exception e)
            {
                // Handle any exceptions that occur during the API call
                Console.WriteLine("Exception when calling ClassificationApi.Classify: " + e.Message);
            }
        }
    }
}

Tags

Document Classification API | .NET Cloud API | GroupDocs.Classification Cloud | REST API | Text Classification | Document Taxonomy | IAB-2 Taxonomy | Sentiment Taxonomy | Sentiment3 Taxonomy | JWT Authentication | Multi-language Support | Custom Classification | Batch Classification | Content-Based Classification | Real-time Classification | JSON Responses | XML Responses | High Accuracy Classification | Machine Learning Classification | Cloud Storage Integration | File Versioning | Folder Management | Docker Support | Self-hosting API | Automatic Scaling | Portable Document Format | Words Document Formats | Rich Text Formats | Plain Text Files | OpenDocument Formats | API Explorer | Comprehensive Documentation | Multi-Platform Support | SDK Support | Secure API Access | Data Encryption | Client ID and Secret | Scalable Infrastructure | Fast Processing | Advanced Text Classification | Real-time API Integration | Targeted Advertising | Content Management | Customer Feedback Analysis | Sentiment Analysis | Social Media Monitoring | GitHub Repository