📝 Text Analyzer - Comprehensive Text Analysis¶

Analyze text for sentiment, readability, statistics, and keywords.

Text Analyzer provides in-depth analysis of text content, offering insights into sentiment, readability levels, linguistic statistics, and automatic keyword extraction.

🌟 Features¶

✅ Sentiment Analysis - Positive, negative, or neutral classification with confidence scores
✅ Readability Scoring - Flesch Reading Ease, Flesch-Kincaid Grade Level, ARI
✅ Text Statistics - Word count, sentence count, character count, reading time
✅ Keyword Extraction - Automatic identification of important keywords
✅ Reading Level Assessment - Determine appropriate audience reading level
✅ Complexity Analysis - Analyze text complexity and structure
✅ Language Detection - Identify the language of the text
✅ Tone Analysis - Detect formal vs. casual tone

🚀 Getting Started¶

Endpoint¶

https://apis.novasuite.one/web/text-analyzer

Basic Analysis (GET)¶

curl "https://apis.novasuite.one/web/text-analyzer?text=Your+text+here"

Advanced Analysis (POST)¶

curl -X POST https://apis.novasuite.one/web/text-analyzer \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Your text here",
    "options": {
      "sentiment": true,
      "readability": true,
      "keywords": true,
      "statistics": true
    }
  }'

📊 Response Format¶

Complete Analysis Response¶

{
  "service": "NovaAPIs Text Analyzer",
  "timestamp": "2025-11-22T12:00:00.000Z",
  "results": {
    "text": "Your analyzed text...",
    "sentiment": {
      "label": "positive",
      "score": 0.85,
      "confidence": 0.92,
      "breakdown": {
        "positive": 0.85,
        "negative": 0.05,
        "neutral": 0.10
      }
    },
    "readability": {
      "fleschReadingEase": 65.5,
      "fleschKincaidGrade": 8.2,
      "automatedReadabilityIndex": 7.8,
      "readingLevel": "8th-9th grade",
      "readingTime": "2 minutes"
    },
    "statistics": {
      "characters": 1247,
      "charactersWithoutSpaces": 1024,
      "words": 245,
      "sentences": 18,
      "paragraphs": 4,
      "syllables": 387,
      "averageWordLength": 4.2,
      "averageSentenceLength": 13.6,
      "uniqueWords": 156,
      "lexicalDiversity": 0.64
    },
    "keywords": [
      {
        "word": "artificial intelligence",
        "frequency": 8,
        "relevance": 0.95
      },
      {
        "word": "machine learning",
        "frequency": 5,
        "relevance": 0.87
      },
      {
        "word": "neural networks",
        "frequency": 4,
        "relevance": 0.82
      }
    ],
    "tone": {
      "formality": "formal",
      "formalityScore": 0.78,
      "objectivity": "objective",
      "objectivityScore": 0.85
    },
    "language": {
      "detected": "en",
      "confidence": 0.99,
      "name": "English"
    }
  }
}

🎯 Use Cases¶

Content Quality - Assess readability and complexity of written content
SEO Optimization - Extract keywords for search optimization
Content Moderation - Detect sentiment and tone in user-generated content
Educational Tools - Determine appropriate reading levels
Writing Assistance - Provide feedback on writing clarity
Social Media Monitoring - Analyze sentiment of posts and comments
Customer Feedback - Understand sentiment in reviews and surveys
Academic Research - Analyze text complexity and structure

📚 Code Examples¶

JavaScript/Node.js¶

async function analyzeText(text) {
  const response = await fetch(
    `https://apis.novasuite.one/web/text-analyzer?text=${encodeURIComponent(text)}`
  );
  const data = await response.json();

  console.log('Sentiment:', data.results.sentiment.label);
  console.log('Score:', data.results.sentiment.score);
  console.log('Reading Level:', data.results.readability.readingLevel);
  console.log('Keywords:', data.results.keywords);

  return data.results;
}

// Usage
analyzeText('Artificial intelligence is transforming the world...');

Advanced Analysis¶

async function advancedAnalysis(text) {
  const response = await fetch(
    'https://apis.novasuite.one/web/text-analyzer',
    {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        text: text,
        options: {
          sentiment: true,
          readability: true,
          keywords: true,
          statistics: true,
          tone: true
        }
      })
    }
  );
  const data = await response.json();

  return data.results;
}

// Usage
advancedAnalysis('Your long text content here...');

Python¶

import requests

def analyze_text(text):
    response = requests.get(
        'https://apis.novasuite.one/web/text-analyzer',
        params={'text': text}
    )
    data = response.json()

    print(f"Sentiment: {data['results']['sentiment']['label']}")
    print(f"Score: {data['results']['sentiment']['score']}")
    print(f"Reading Level: {data['results']['readability']['readingLevel']}")
    print(f"Keywords: {data['results']['keywords']}")

    return data['results']

# Usage
analyze_text('Artificial intelligence is transforming the world...')

Advanced Analysis (Python)¶

import requests

def advanced_analysis(text):
    response = requests.post(
        'https://apis.novasuite.one/web/text-analyzer',
        json={
            'text': text,
            'options': {
                'sentiment': True,
                'readability': True,
                'keywords': True,
                'statistics': True,
                'tone': True
            }
        }
    )
    data = response.json()

    return data['results']

# Usage
advanced_analysis('Your long text content here...')

cURL¶

# Basic analysis
curl "https://apis.novasuite.one/web/text-analyzer?text=Hello+world" \
  | jq '.results.sentiment'

# Advanced analysis
curl -X POST https://apis.novasuite.one/web/text-analyzer \
  -H "Content-Type: application/json" \
  -d '{"text": "Your text here", "options": {"sentiment": true, "keywords": true}}' \
  | jq '.results'

📖 API Reference¶

GET /web/text-analyzer¶

Query Parameters:

text (required) - Text to analyze

Response: Complete text analysis

POST /web/text-analyzer¶

Body:

{
  "text": "string",        // Text to analyze (required)
  "options": {             // Optional analysis options
    "sentiment": true,     // Include sentiment analysis
    "readability": true,   // Include readability scores
    "keywords": true,      // Extract keywords
    "statistics": true,    // Include text statistics
    "tone": true,          // Analyze tone
    "language": true       // Detect language
  }
}

Response: Text analysis based on selected options

📊 Understanding the Scores¶

Sentiment Scores¶

Score Range	Label	Description
0.5 to 1.0	Positive	Text expresses positive sentiment
-0.5 to 0.5	Neutral	Text is neutral or balanced
-1.0 to -0.5	Negative	Text expresses negative sentiment

Flesch Reading Ease¶

Score Range	Reading Level	Description
90-100	5^th grade	Very easy to read
80-90	6^th grade	Easy to read
70-80	7^th grade	Fairly easy
60-70	8^th-9^th grade	Standard
50-60	10^th-12^th grade	Fairly difficult
30-50	College	Difficult
0-30	College graduate	Very difficult

Flesch-Kincaid Grade Level¶

Indicates the U.S. school grade level needed to understand the text.

Score 8.0 = 8^th grade reading level
Score 12.0 = 12^th grade (high school senior)
Score 16.0 = College senior level

🔒 Privacy & Data¶

No data storage - Text is analyzed in real-time and not stored
No tracking - We don't track users or their content
Privacy-first - Your text content is never logged or saved
CORS enabled - Use from any domain

⚡ Rate Limits¶

Free Tier: 50 requests per hour per IP

Rate limit information is included in response headers:

X-RateLimit-Limit - Maximum requests allowed
X-RateLimit-Remaining - Requests remaining in current window
X-RateLimit-Reset - Unix timestamp when limit resets

💡 Tips & Best Practices¶

Longer text = better analysis - More accurate results with 100+ words
Use POST for large text - Avoid URL length limits
Select specific options - Only request the analysis you need
Cache results - Avoid re-analyzing the same text
Combine with other APIs - Use with Rich Suggestions for content enhancement

🐛 Support¶

For questions or support inquiries, please contact us at api@novasuite.one.