Version 1.8.2

2026-01-18 22:14:34 +00:00
parent 328098a48c
commit e57c4bf1ac
4 changed files with 447 additions and 10 deletions
--- a/docs/20-API/ENDPOINTS.md
+++ b/docs/20-API/ENDPOINTS.md
@@ -1,7 +1,7 @@
 # API Endpoints Reference

-**Last Verified:** January 18, 2026  
-**Version:** 1.8.1  
+**Last Verified:** January 19, 2026  
+**Version:** 1.8.2  
 **Base URL:** `/api/v1/`  
 **Documentation:** `/api/docs/` (Swagger) | `/api/redoc/` (ReDoc)

@@ -39,7 +39,116 @@ All endpoints require authentication unless noted.
 | GET | `/sectors/` | `SectorViewSet.list` | ✅ | List sectors |
 | POST | `/sectors/` | `SectorViewSet.create` | ✅ | Create sector |
 | GET | `/industries/` | `IndustryViewSet.list` | ✅ | List industries |
-| GET | `/seed-keywords/` | `SeedKeywordViewSet.list` | ✅ | List seed keywords |
+| GET | `/keywords-library/` | `SeedKeywordViewSet.list` | ✅ | List keywords library (v1.8.2) |
+| GET | `/keywords-library/sector_stats/` | `SeedKeywordViewSet.sector_stats` | ✅ | Get sector statistics (v1.8.2) |
+
+---
+
+## Keywords Library Endpoints (v1.8.2)
+
+**New Endpoint:** `/api/v1/keywords-library/`  
+**Previous:** `/api/v1/auth/seed-keywords/` (deprecated, no backward compatibility)
+
+### List Keywords
+
+```
+GET /api/v1/keywords-library/
+```
+
+**Query Parameters:**
+- `sector_ids` _(string, comma-separated)_ - Filter by specific sector IDs (e.g., `1,2,3`)
+  - **New in v1.8.2:** Ensures sites only see keywords from their configured sectors
+- `search` _(string)_ - Search keyword names
+- `country` _(string)_ - Filter by country code (e.g., `US`, `UK`)
+- `volume_min` _(number)_ - Minimum search volume
+- `volume_max` _(number)_ - Maximum search volume
+- `difficulty` _(string)_ - SEO difficulty level (`easy`, `medium`, `hard`, `very_hard`)
+- `is_high_opportunity` _(boolean)_ - Filter high-opportunity keywords
+- `is_paid` _(boolean)_ - Filter paid/premium keywords
+- `ordering` _(string)_ - Sort field (prefix `-` for descending)
+  - Options: `keyword`, `volume`, `difficulty`, `country`
+  - Default: `-volume`
+- `page` _(number)_ - Page number for pagination
+- `page_size` _(number)_ - Results per page (default: 20)
+
+**Example Request:**
+```bash
+GET /api/v1/keywords-library/?sector_ids=1,2,3&country=US&difficulty=easy&ordering=-volume&page=1
+```
+
+**Response:**
+```json
+{
+  "count": 150,
+  "next": "http://api.igny8.com/api/v1/keywords-library/?page=2&sector_ids=1,2,3",
+  "previous": null,
+  "results": [
+    {
+      "id": 1,
+      "keyword": "cloud computing services",
+      "volume": 12000,
+      "difficulty": "medium",
+      "country": "US",
+      "industry_sector": 1,
+      "industry_sector_name": "Cloud Infrastructure & Services",
+      "is_high_opportunity": true,
+      "is_paid": false,
+      "credit_cost": 0,
+      "created_at": "2025-01-15T10:00:00Z"
+    }
+  ]
+}
+```
+
+### Sector Statistics
+
+```
+GET /api/v1/keywords-library/sector_stats/
+```
+
+Returns aggregated statistics per sector for the keywords library.
+
+**Query Parameters:**
+- `sector_ids` _(string, comma-separated)_ - Filter by specific sector IDs
+  - **New in v1.8.2:** Returns stats only for specified sectors
+
+**Example Request:**
+```bash
+GET /api/v1/keywords-library/sector_stats/?sector_ids=1,2,3
+```
+
+**Response:**
+```json
+[
+  {
+    "sector_id": 1,
+    "sector_name": "Cloud Infrastructure & Services",
+    "sector_description": "Keywords related to cloud computing, hosting, and infrastructure services",
+    "stats": {
+      "total": 250,
+      "added": 45,
+      "available": 205,
+      "high_opportunity": 80,
+      "paid": 30,
+      "free": 220
+    }
+  }
+]
+```
+
+**Stat Definitions:**
+- `total` - All keywords in sector
+- `added` - Keywords site has added to their workflow
+- `available` - Keywords not yet added (total - added)
+- `high_opportunity` - Premium keywords with high volume and potential
+- `paid` - Premium keywords requiring credits
+- `free` - Keywords with no credit cost
+
+**Use Cases:**
+1. **Sector Metric Cards** - Display stats per sector with clickable filters
+2. **Smart Suggestions** - Show available counts for bulk-add operations
+3. **Progress Tracking** - Track keyword adoption across sectors
+4. **Budget Planning** - Understand credit requirements for paid keywords

 ---

--- a/docs/INDEX.md
+++ b/docs/INDEX.md
@@ -78,13 +78,13 @@
 | [PAGE-REQUIREMENTS.md](30-FRONTEND/PAGE-REQUIREMENTS.md) | Site/sector selector requirements |
 | [STORES.md](30-FRONTEND/STORES.md) | Zustand state management |

-### Current Page Structure (v1.8.0)
+### Current Page Structure (v1.8.2)

 ```
 /                           → Dashboard (Home.tsx) - with workflow widgets
 ├── SETUP
 │   /setup/wizard           → Onboarding Wizard (SetupWizard.tsx)
-│   /setup/add-keywords     → Add Keywords (AddKeywords.tsx)
+│   /keywords-library       → Keywords Library (IndustriesSectorsKeywords.tsx) [v1.8.2 renamed]
 │   /account/content-settings → Content Settings (ContentSettingsPage.tsx)
 │   /sites                  → Sites List (List.tsx)
 │   /sites/:id              → Site Dashboard (Dashboard.tsx)
--- a/docs/plans/KEYWORDS-LIBRARY-REDESIGN-PLAN.md
+++ b/docs/plans/KEYWORDS-LIBRARY-REDESIGN-PLAN.md
@@ -1,8 +1,8 @@
 # Keywords Library Page Redesign Plan

 **Created:** January 18, 2026  
-**Updated:** January 18, 2026  
-**Status:** ✅ IMPLEMENTED (v1.8.1)  
+**Updated:** January 19, 2026 _(v1.8.2 released)_  
+**Status:** ✅ COMPLETED & DOCUMENTED (v1.8.2)  
 **Page:** `/keywords-library` (was `/setup/add-keywords`)  
 **Priority:** 🟢 COMPLETED

@@ -10,7 +10,7 @@

 ## Executive Summary

-Comprehensive redesign of the Keywords Library page to:
+Comprehensive redesign of the Keywords Library page completed and deployed in **v1.8.2**:
 1. ✅ **Standardize naming** to "Keywords Library" across frontend, backend, URLs, menus, and admin
 2. ✅ **Implement cascading filters** like Planner pages (Keywords, Clusters, Ideas)
 3. ⬜ **Remove sector selector** from AppHeader, use site-only selector (partial - route updated)
@@ -19,6 +19,11 @@ Comprehensive redesign of the Keywords Library page to:
 6. ⬜ **Center filter bar** with sector filter added, matching Planner page styling (needs polish)
 7. ⬜ **Show table data by default** (remove "Browse" toggle) (kept existing UX for now)
 8. ✅ **No backward compatibility** - single source of truth
+9. ✅ **CRITICAL FIX:** Sector-specific filtering - sites now only see keywords from their configured sectors
+
+**Release:** Version 1.8.2 - January 19, 2026  
+**Changelog:** See `/CHANGELOG.md` for complete details  
+**API Documentation:** See `/docs/20-API/ENDPOINTS.md` for Keywords Library endpoints

 ---