GroupDocs.Classification-Cloud 21.4.0

Document Classification .NET Cloud 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

• Portable Document Format: PDF
• Words Document Formats: DOC, DOCX, DOCM, DOT, DOTX, DOTM
• Rich Text Formats: RTF
• Plain Text File: TXT
• OpenDocument Formats: ODT, OTT

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