{"message":"Competitor Keyword Analysis API","description":"Extract competitor keywords and compare against your website using semantic embeddings","version":"1.1.0","authentication":"Bearer token required","analysis_methods":{"unified":{"endpoint":"POST /unified","description":"🆕 SMART UNIFIED ANALYSIS - Automatically detects input types and routes to appropriate analysis","input":"Flexible self_data + competitor_data (domains, sitemap URLs, URLs, or keywords)","supported_combinations":["domain vs domain","domain vs urls","domain vs keywords","urls vs urls","urls vs domain","urls vs keywords","keywords vs keywords","keywords vs domain","keywords vs urls","sitemap vs sitemap","sitemap vs domain","domain vs sitemap","sitemap vs urls","urls vs sitemap","sitemap vs keywords","keywords vs sitemap"],"examples":{"domain_vs_domain":{"self_data":"cashdirect.com.au","competitor_data":["fundo.com.au","nimble.com.au"],"non_zero_volume_keyword":true},"domain_vs_keywords":{"self_data":"cashdirect.com.au","competitor_data":["instant loans","cash advance"],"non_zero_volume_keyword":true},"urls_vs_urls":{"self_data":["https://cashdirect.com.au/loans"],"competitor_data":["https://fundo.com.au/personal-loans"],"non_zero_volume_keyword":true}}},"sitemap_based":{"endpoint":"POST /analyze","description":"Extract competitor keywords from their sitemaps","input":"URLs list (first = self, rest = competitor domains)","example":{"urls":["cashdirect.com.au","fundo.com.au","nimble.com.au"],"use_cache":true}},"url_based":{"endpoint":"POST /urls","description":"Analyze specific competitor URLs provided by user","input":"Self domain + list of competitor URLs","example":{"self_domain":"cashdirect.com.au","competitor_urls":["https://fundo.com.au/personal-loans","https://nimble.com.au/quick-cash-loans"],"use_cache":true}},"keyword_based":{"endpoint":"POST /keywords","description":"Direct comparison between keyword lists using semantic similarity","input":"Self keywords list + competitor keywords list","example":{"self_keywords":["personal loans","quick cash","fast approval"],"competitor_keywords":["instant loans","cash advance","emergency funding"],"use_cache":true}}},"csv_columns":{"sitemap_url_analysis":"Keyword,Competitor_URL,Best_URL,Best_Score,Best_Slug,Top_1_URLs,Top_1_Scores,Top_3_URLs,Top_3_Scores","keyword_comparison":"Competitor_Keyword,Competitor_URL,Best_Match_Keyword,Best_Score,Top_1_Keywords,Top_1_Scores,Top_3_Keywords,Top_3_Scores"},"token":"Add header: Authorization: Bearer E4tGSsYHN3ckgyJf60855iXZwBHARVmy3xGEzad2v3HTYFO0tR","endpoints":{"unified":"POST /unified - 🆕 SMART UNIFIED ANALYSIS (auto-detects input types)","analyze":"POST /analyze - Sitemap-based competitor analysis","urls":"POST /urls - URL-based competitor analysis","keywords":"POST /keywords - Direct keyword list comparison","docs":"GET /docs - Interactive API documentation","health":"GET /health - Health check"}}