🔍 SEO Analysis & Clustering API

🌐 1. Page Analysis Endpoint

Path: /analyze-page

Method: POST

Description: Analyzes a webpage and returns key SEO information including:

• 📝 Title and meta description
• 📄 Body text content
• 📊 Heading structure (H1-H6)
• 🔗 Internal and external links
• 🎯 Canonical URL and robots meta tag

Example Usage: POST /analyze-page with JSON body: {"url": "https://example.com"}

🔬 2. SERP Clustering Endpoint

Path: /sep-based-clustering/

Method: POST

Description: Clusters keywords based on search engine results page (SERP) patterns.

Features:

• 🎯 Groups keywords with similar SERP results
• 🔄 Supports both hard and soft clustering
• ⚙️ Configurable overlap threshold

🧠 3. Generate Embeddings API

Path: /generate-embeddings

Method: POST

Overview: This API provides a simple interface to generate sentence embeddings using Sentence Transformers models.

🚀 Features:

• Generate sentence embeddings using two different pre-trained models:
• all-MiniLM-L6-v2
• intfloat/e5-large-v2

Response: JSON response with embeddings for each sentence.

🧩 4. Semantic Keyword Clustering

Path: /semantic-keywords-clustering

Method: POST

Description: Groups a list of keywords by meaning using embeddings + HDBSCAN — no need to pick the number of clusters.

Features:

• 🧠 Clusters by semantic similarity, not just SERP overlap
• 🎚️ Friendly presets (broad / balanced / specific)
• 🗺️ Interactive visualization of the clusters
• 🧹 Sets aside keywords that don't fit any group