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 across a wide range of file formats including PDF, DOCX, TXT, and more.

Multi-language Support

Classify documents in multiple languages.

Custom Classification

Define custom classification categories according to your specific needs.

Batch Classification

Classify multiple documents in a single request.

Content-Based Classification

Classify documents based on the content within the document body.

Taxonomy Classification Features

IAB-2 Taxonomy

Supports classification based on the IAB-2 standard taxonomy for categorizing content.

Document Taxonomy

Classify documents into specific categories like ADVE (advertisements), Email, Form, Letter, Memo, etc.

Sentiment Taxonomy

Classify text into binary sentiment categories such as Positive and Negative.

Sentiment3 Taxonomy

Classify text into three sentiment categories: Positive, Neutral, and Negative.

API Integration Features

RESTful API

Access classification features via a REST API for seamless integration.

SDK Support

Available SDKs for .NET, Java, Python, PHP, and other languages to simplify API integration.

Real-time Classification

Perform real-time classification of text and documents.

JSON and XML Responses

Get results in both JSON and XML formats for easy integration with various systems.

Security and Authentication Features

JWT Authentication

Secure API access with JSON Web Token (JWT) authentication.

Client ID and Secret

Use Client ID and Client Secret for secure API calls.

Data Encryption

Supports encrypted communication between client applications and the GroupDocs.Classification Cloud API.

Performance Features

Scalable Infrastructure

Handles large volumes of documents efficiently.

High Accuracy

Provides highly accurate classification results using advanced machine learning algorithms.

Fast Processing

Optimized for fast classification to meet the needs of high-performance applications.

Usability Features

API Explorer

Use the built-in API Explorer to test and explore API functionality directly in your browser.

Comprehensive Documentation

Extensive documentation and code samples to help you get started quickly.

Multi-Platform Support

Works on various platforms including Windows, Linux, and macOS.

Storage and File Management Features

Cloud Storage Integration

Supports integration with cloud storage providers like AWS S3 and Google Cloud Storage.

File Versioning

Manage different versions of classified documents.

Folder Management

Create, move, copy, and delete folders in the cloud storage associated with your account.

Deployment and Hosting Features

Docker Support

Deploy GroupDocs.Classification Cloud in a Docker container for private cloud or on-premises hosting.

Self-hosting

Run the API on your own infrastructure with full control over the environment.

Automatic Scaling

Automatically scales to handle varying workloads and ensures high availability.

Supported Document Formats

Supported Taxonomy

IAB-2 Taxonomy

Categories such as Automotive, Books and Literature, Business and Finance, etc.

Documents Taxonomy

Classifications like ADVE (advertisements), Email, Form, Letter, Memo, etc.

Sentiment Taxonomy

Binary sentiment classification with Negative and Positive categories.

Sentiment3 Taxonomy

3-class sentiment classification with Negative, Neutral, and Positive categories.

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