Update app.py

app.py

@@ -1,4 +1,3 @@
-# app.py - Main application file for Hugging Face Space
 import gradio as gr
 import requests
 import json
@@ -8,9 +7,17 @@ from typing import Dict, List, Optional
 import time
 import random
 
+# ==========================================
+# APOLLO.IO API CLIENT CLASS
+# ==========================================
+
 class ApolloDataFetcher:
+    """
+    Apollo.io API client for fetching people and company data
+    """
+    
     def __init__(self, api_key: str = None):
-        # Try to get API key from environment (Hugging Face secrets) or parameter
+        # Get API key from environment (Hugging Face secrets) or parameter
         self.api_key = api_key or os.getenv("APOLLO_API_KEY")
         self.base_url = "https://api.apollo.io/v1"
         self.headers = {
@@ -20,60 +27,60 @@ class ApolloDataFetcher:
         if self.api_key and self.api_key != "demo":
             self.headers["X-Api-Key"] = self.api_key
     
+    # ==========================================
+    # PEOPLE SEARCH METHOD
+    # ==========================================
+    
     def search_people(self, query: str, limit: int = 10) -> Dict:
         """Search for people using Apollo.io API"""
         if not self.api_key or self.api_key == "demo":
             return self._generate_demo_people_data(query, limit)
         
-        endpoint = f"{self.base_url}/mixed_people/search"
+        endpoint = f"{self.base_url}/people/search"
         payload = {
             "q_keywords": query,
             "page": 1,
-            "per_page": min(limit, 25)  # Apollo limits to 25 per page
+            "per_page": min(limit, 25),
+            "person_locations": ["United States"],
         }
         
         try:
             response = requests.post(endpoint, headers=self.headers, json=payload, timeout=10)
-            if response.status_code == 200:
-                return response.json()
-            elif response.status_code == 401:
-                return {"error": "Invalid API key. Please check your Apollo.io API key."}
-            elif response.status_code == 429:
-                return {"error": "Rate limit exceeded. Please try again later."}
-            else:
-                return {"error": f"API Error: {response.status_code} - {response.text}"}
+            return self._handle_api_response(response)
         except requests.exceptions.Timeout:
             return {"error": "Request timeout. Please try again."}
         except Exception as e:
             return {"error": f"Request failed: {str(e)}"}
     
+    # ==========================================
+    # COMPANY SEARCH METHOD
+    # ==========================================
+    
     def search_companies(self, query: str, limit: int = 10) -> Dict:
         """Search for companies using Apollo.io API"""
         if not self.api_key or self.api_key == "demo":
             return self._generate_demo_company_data(query, limit)
         
-        endpoint = f"{self.base_url}/mixed_companies/search"
+        endpoint = f"{self.base_url}/organizations/search"
         payload = {
             "q_keywords": query,
             "page": 1,
-            "per_page": min(limit, 25)
+            "per_page": min(limit, 25),
+            "organization_locations": ["United States"],
         }
         
         try:
             response = requests.post(endpoint, headers=self.headers, json=payload, timeout=10)
-            if response.status_code == 200:
-                return response.json()
-            elif response.status_code == 401:
-                return {"error": "Invalid API key. Please check your Apollo.io API key."}
-            elif response.status_code == 429:
-                return {"error": "Rate limit exceeded. Please try again later."}
-            else:
-                return {"error": f"API Error: {response.status_code} - {response.text}"}
+            return self._handle_api_response(response)
         except requests.exceptions.Timeout:
             return {"error": "Request timeout. Please try again."}
         except Exception as e:
             return {"error": f"Request failed: {str(e)}"}
     
+    # ==========================================
+    # CONTACT ENRICHMENT METHOD
+    # ==========================================
+    
     def enrich_person(self, email: str) -> Dict:
         """Enrich person data by email"""
         if not self.api_key or self.api_key == "demo":
@@ -84,26 +91,72 @@ class ApolloDataFetcher:
         
         try:
             response = requests.post(endpoint, headers=self.headers, json=payload, timeout=10)
-            if response.status_code == 200:
-                return response.json()
-            elif response.status_code == 401:
-                return {"error": "Invalid API key. Please check your Apollo.io API key."}
-            elif response.status_code == 429:
-                return {"error": "Rate limit exceeded. Please try again later."}
-            else:
-                return {"error": f"API Error: {response.status_code} - {response.text}"}
+            return self._handle_api_response(response)
+        except requests.exceptions.Timeout:
+            return {"error": "Request timeout. Please try again."}
+        except Exception as e:
+            return {"error": f"Request failed: {str(e)}"}
+    
+    # ==========================================
+    # EMAIL FINDER METHOD
+    # ==========================================
+    
+    def find_email(self, first_name: str, last_name: str, domain: str) -> Dict:
+        """Find email for a person"""
+        if not self.api_key or self.api_key == "demo":
+            return {"email": f"{first_name.lower()}.{last_name.lower()}@{domain}"}
+        
+        endpoint = f"{self.base_url}/email_accounts"
+        payload = {
+            "first_name": first_name,
+            "last_name": last_name,
+            "domain": domain
+        }
+        
+        try:
+            response = requests.post(endpoint, headers=self.headers, json=payload, timeout=10)
+            return self._handle_api_response(response)
         except requests.exceptions.Timeout:
             return {"error": "Request timeout. Please try again."}
         except Exception as e:
             return {"error": f"Request failed: {str(e)}"}
     
+    # ==========================================
+    # API RESPONSE HANDLER
+    # ==========================================
+    
+    def _handle_api_response(self, response) -> Dict:
+        """Handle API response with proper error codes"""
+        if response.status_code == 200:
+            return response.json()
+        elif response.status_code == 401:
+            return {"error": "Invalid API key. Please check your Apollo.io API key."}
+        elif response.status_code == 403:
+            return {"error": "Access denied. Your API key may not have permission for this endpoint. Try upgrading your Apollo.io plan."}
+        elif response.status_code == 429:
+            return {"error": "Rate limit exceeded. Please try again later."}
+        else:
+            return {"error": f"API Error: {response.status_code} - {response.text}"}
+    
+    # ==========================================
+    # DEMO DATA GENERATORS
+    # ==========================================
+    
     def _generate_demo_people_data(self, query: str, limit: int) -> Dict:
         """Generate realistic demo data for people search"""
         demo_people = []
-        job_titles = ["Software Engineer", "Marketing Manager", "Sales Director", "CEO", "CTO", "VP Sales", "Product Manager", "Data Scientist", "UX Designer", "DevOps Engineer"]
-        companies = ["TechCorp", "InnovateLtd", "DataSystems", "CloudNine", "AIStartup", "FinTechPro", "HealthTech", "EduSolutions", "GreenTech", "CyberSec"]
-        domains = ["techcorp.com", "innovate.ltd", "datasys.com", "cloudnine.io", "aistartup.ai", "fintech.pro", "healthtech.com", "edusol.com", "greentech.co", "cybersec.net"]
-        
+        job_titles = [
+            "Software Engineer", "Marketing Manager", "Sales Director", "CEO", "CTO", 
+            "VP Sales", "Product Manager", "Data Scientist", "UX Designer", "DevOps Engineer"
+        ]
+        companies = [
+            "TechCorp", "InnovateLtd", "DataSystems", "CloudNine", "AIStartup", 
+            "FinTechPro", "HealthTech", "EduSolutions", "GreenTech", "CyberSec"
+        ]
+        domains = [
+            "techcorp.com", "innovate.ltd", "datasys.com", "cloudnine.io", "aistartup.ai",
+            "fintech.pro", "healthtech.com", "edusol.com", "greentech.co", "cybersec.net"
+        ]
         first_names = ["John", "Jane", "Michael", "Sarah", "David", "Emily", "Robert", "Lisa", "James", "Maria"]
         last_names = ["Smith", "Johnson", "Williams", "Brown", "Jones", "Garcia", "Miller", "Davis", "Rodriguez", "Martinez"]
         
@@ -141,8 +194,10 @@ class ApolloDataFetcher:
     def _generate_demo_company_data(self, query: str, limit: int) -> Dict:
         """Generate realistic demo data for company search"""
         demo_companies = []
-        industries = ["Technology", "Healthcare", "Finance", "Education", "E-commerce", "Manufacturing", "Consulting", "Media", "Biotechnology", "Renewable Energy"]
-        
+        industries = [
+            "Technology", "Healthcare", "Finance", "Education", "E-commerce", 
+            "Manufacturing", "Consulting", "Media", "Biotechnology", "Renewable Energy"
+        ]
         company_suffixes = ["Corp", "Inc", "LLC", "Ltd", "Technologies", "Solutions", "Systems", "Labs", "Ventures", "Group"]
         
         for i in range(min(limit, 10)):
@@ -207,40 +262,47 @@ class ApolloDataFetcher:
             }
         }
 
-# Initialize the Apollo client with environment variable
-apollo_client = ApolloDataFetcher()
+# ==========================================
+# DATA FORMATTING FUNCTIONS
+# ==========================================
 
 def format_people_results(results: Dict) -> tuple:
     """Format people search results for display"""
     if "error" in results:
         return f"❌ Error: {results['error']}", None
     
-    if "people" not in results or not results["people"]:
+    # Handle both 'people' and 'data' keys (different API versions)
+    people_data = results.get("people", results.get("data", []))
+    if not people_data:
         return "No results found.", None
     
     # Create formatted text output
-    output_text = f"✅ Found {len(results['people'])} people:\n\n"
+    output_text = f"✅ Found {len(people_data)} people:\n\n"
     
     # Create DataFrame for table
     table_data = []
     
-    for person in results["people"]:
+    for person in people_data:
+        # Handle nested organization data
+        org = person.get('organization', {}) or person.get('current_organization', {})
+        
         # Format text output
-        output_text += f"👤 **{person.get('name', 'N/A')}**\n"
+        name = person.get('name', f"{person.get('first_name', '')} {person.get('last_name', '')}").strip()
+        output_text += f"👤 **{name or 'N/A'}**\n"
         output_text += f"   📧 Email: {person.get('email', 'N/A')}\n"
-        output_text += f"   📞 Phone: {person.get('phone', 'N/A')}\n"
+        output_text += f"   📞 Phone: {person.get('phone', person.get('personal_phone', 'N/A'))}\n"
         output_text += f"   💼 Title: {person.get('title', 'N/A')}\n"
-        output_text += f"   🏢 Company: {person.get('organization', {}).get('name', 'N/A')}\n"
+        output_text += f"   🏢 Company: {org.get('name', 'N/A')}\n"
         output_text += f"   📍 Location: {person.get('city', 'N/A')}, {person.get('state', 'N/A')}\n"
         output_text += f"   🔗 LinkedIn: {person.get('linkedin_url', 'N/A')}\n\n"
         
         # Add to table data
         table_data.append({
-            "Name": person.get('name', 'N/A'),
+            "Name": name or 'N/A',
             "Email": person.get('email', 'N/A'),
-            "Phone": person.get('phone', 'N/A'),
+            "Phone": person.get('phone', person.get('personal_phone', 'N/A')),
             "Title": person.get('title', 'N/A'),
-            "Company": person.get('organization', {}).get('name', 'N/A'),
+            "Company": org.get('name', 'N/A'),
             "Location": f"{person.get('city', 'N/A')}, {person.get('state', 'N/A')}"
         })
     
@@ -252,21 +314,23 @@ def format_company_results(results: Dict) -> tuple:
     if "error" in results:
         return f"❌ Error: {results['error']}", None
     
-    if "organizations" not in results or not results["organizations"]:
+    # Handle both 'organizations' and 'data' keys
+    companies_data = results.get("organizations", results.get("data", []))
+    if not companies_data:
         return "No results found.", None
     
     # Create formatted text output
-    output_text = f"✅ Found {len(results['organizations'])} companies:\n\n"
+    output_text = f"✅ Found {len(companies_data)} companies:\n\n"
     
     # Create DataFrame for table
     table_data = []
     
-    for company in results["organizations"]:
+    for company in companies_data:
         # Format text output
         output_text += f"🏢 **{company.get('name', 'N/A')}**\n"
         output_text += f"   🌐 Website: {company.get('website_url', 'N/A')}\n"
-        output_text += f"   🏭 Industry: {company.get('industry', 'N/A')}\n"
-        output_text += f"   👥 Employees: {company.get('employees_range', 'N/A')}\n"
+        output_text += f"   🏭 Industry: {company.get('industry', company.get('primary_industry', 'N/A'))}\n"
+        output_text += f"   👥 Employees: {company.get('employees_range', company.get('estimated_num_employees', 'N/A'))}\n"
         output_text += f"   📞 Phone: {company.get('phone', 'N/A')}\n"
         output_text += f"   📍 Location: {company.get('city', 'N/A')}, {company.get('state', 'N/A')}\n"
         output_text += f"   📅 Founded: {company.get('founded_year', 'N/A')}\n\n"
@@ -275,8 +339,8 @@ def format_company_results(results: Dict) -> tuple:
         table_data.append({
             "Company": company.get('name', 'N/A'),
             "Website": company.get('website_url', 'N/A'),
-            "Industry": company.get('industry', 'N/A'),
-            "Employees": company.get('employees_range', 'N/A'),
+            "Industry": company.get('industry', company.get('primary_industry', 'N/A')),
+            "Employees": str(company.get('employees_range', company.get('estimated_num_employees', 'N/A'))),
             "Location": f"{company.get('city', 'N/A')}, {company.get('state', 'N/A')}",
             "Founded": str(company.get('founded_year', 'N/A'))
         })
@@ -284,6 +348,10 @@ def format_company_results(results: Dict) -> tuple:
     df = pd.DataFrame(table_data)
     return output_text, df
 
+# ==========================================
+# INTERFACE FUNCTIONS
+# ==========================================
+
 def search_people_interface(query: str, limit: int):
     """Interface function for people search"""
     if not query.strip():
@@ -300,6 +368,29 @@ def search_companies_interface(query: str, limit: int):
     results = apollo_client.search_companies(query, limit)
     return format_company_results(results)
 
+def find_email_interface(first_name: str, last_name: str, domain: str):
+    """Interface function for email finding"""
+    if not all([first_name.strip(), last_name.strip(), domain.strip()]):
+        return "Please enter first name, last name, and company domain."
+    
+    results = apollo_client.find_email(first_name, last_name, domain)
+    
+    if "error" in results:
+        return f"❌ Error: {results['error']}"
+    
+    if "email" in results:
+        output = f"📧 **Email Found**\n\n"
+        output += f"👤 **Name:** {first_name} {last_name}\n"
+        output += f"📧 **Email:** {results['email']}\n"
+        output += f"🏢 **Domain:** {domain}\n"
+        
+        if results.get('confidence'):
+            output += f"🎯 **Confidence:** {results['confidence']}\n"
+        
+        return output
+    
+    return "No email found for this person and domain combination."
+
 def enrich_person_interface(email: str):
     """Interface function for person enrichment"""
     if not email.strip() or "@" not in email:
@@ -310,17 +401,23 @@ def enrich_person_interface(email: str):
     if "error" in results:
         return f"❌ Error: {results['error']}"
     
-    if "person" not in results:
+    # Handle both 'person' and 'data' keys
+    person = results.get("person", results.get("data"))
+    if not person:
         return "No person data found for this email."
     
-    person = results["person"]
     output = f"🔍 **Enriched Person Data**\n\n"
-    output += f"👤 **Name:** {person.get('name', 'N/A')}\n"
+    
+    # Handle nested organization data
+    org = person.get('organization', {}) or person.get('current_organization', {})
+    name = person.get('name', f"{person.get('first_name', '')} {person.get('last_name', '')}").strip()
+    
+    output += f"👤 **Name:** {name or 'N/A'}\n"
     output += f"📧 **Email:** {person.get('email', 'N/A')}\n"
-    output += f"📞 **Phone:** {person.get('phone', 'N/A')}\n"
+    output += f"📞 **Phone:** {person.get('phone', person.get('personal_phone', 'N/A'))}\n"
     output += f"💼 **Title:** {person.get('title', 'N/A')}\n"
-    output += f"🏢 **Company:** {person.get('organization', {}).get('name', 'N/A')}\n"
-    output += f"🌐 **Company Website:** {person.get('organization', {}).get('website_url', 'N/A')}\n"
+    output += f"🏢 **Company:** {org.get('name', 'N/A')}\n"
+    output += f"🌐 **Company Website:** {org.get('website_url', 'N/A')}\n"
     output += f"📍 **Location:** {person.get('city', 'N/A')}, {person.get('state', 'N/A')}, {person.get('country', 'N/A')}\n"
     output += f"🔗 **LinkedIn:** {person.get('linkedin_url', 'N/A')}\n"
     output += f"🐦 **Twitter:** {person.get('twitter_url', 'N/A')}\n"
@@ -332,11 +429,25 @@ def enrich_person_interface(email: str):
     
     return output
 
+# ==========================================
+# INITIALIZE APOLLO CLIENT
+# ==========================================
+
+apollo_client = ApolloDataFetcher()
+
 # Check if API key is available
 api_key_status = "🔑 Live API Mode" if apollo_client.api_key and apollo_client.api_key != "demo" else "🎭 Demo Mode"
 
-# Create Gradio interface
+# ==========================================
+# GRADIO INTERFACE
+# ==========================================
+
 with gr.Blocks(title="Apollo.io Data Fetcher", theme=gr.themes.Soft()) as demo:
+    
+    # ==========================================
+    # HEADER SECTION
+    # ==========================================
+    
     gr.HTML(f"""
     <div style="text-align: center; padding: 20px;">
         <h1>🚀 Apollo.io Data Fetcher</h1>
@@ -349,8 +460,16 @@ with gr.Blocks(title="Apollo.io Data Fetcher", theme=gr.themes.Soft()) as demo:
     </div>
     """)
     
+    # ==========================================
+    # MAIN TABS
+    # ==========================================
+    
     with gr.Tabs():
-        # People Search Tab
+        
+        # ==========================================
+        # PEOPLE SEARCH TAB
+        # ==========================================
+        
         with gr.TabItem("👥 Search People"):
             with gr.Row():
                 with gr.Column(scale=2):
@@ -382,7 +501,10 @@ with gr.Blocks(title="Apollo.io Data Fetcher", theme=gr.themes.Soft()) as demo:
                 outputs=[people_output, people_table]
             )
         
-        # Companies Search Tab
+        # ==========================================
+        # COMPANIES SEARCH TAB
+        # ==========================================
+        
         with gr.TabItem("🏢 Search Companies"):
             with gr.Row():
                 with gr.Column(scale=2):
@@ -414,7 +536,46 @@ with gr.Blocks(title="Apollo.io Data Fetcher", theme=gr.themes.Soft()) as demo:
                 outputs=[company_output, company_table]
             )
         
-        # Person Enrichment Tab
+        # ==========================================
+        # EMAIL FINDER TAB
+        # ==========================================
+        
+        with gr.TabItem("📧 Find Email"):
+            gr.Markdown("### Find email addresses for specific people")
+            
+            with gr.Row():
+                with gr.Column():
+                    first_name_input = gr.Textbox(
+                        label="First Name",
+                        placeholder="e.g., John",
+                        info="Person's first name"
+                    )
+                with gr.Column():
+                    last_name_input = gr.Textbox(
+                        label="Last Name", 
+                        placeholder="e.g., Smith",
+                        info="Person's last name"
+                    )
+                with gr.Column():
+                    domain_input = gr.Textbox(
+                        label="Company Domain",
+                        placeholder="e.g., apple.com",
+                        info="Company website domain (without https://)"
+                    )
+            
+            find_email_btn = gr.Button("📧 Find Email", variant="primary", size="lg")
+            email_finder_output = gr.Markdown(label="Email Results")
+            
+            find_email_btn.click(
+                find_email_interface,
+                inputs=[first_name_input, last_name_input, domain_input],
+                outputs=[email_finder_output]
+            )
+        
+        # ==========================================
+        # PERSON ENRICHMENT TAB
+        # ==========================================
+        
         with gr.TabItem("🔍 Enrich Person"):
             email_input = gr.Textbox(
                 label="Email Address",
@@ -431,8 +592,11 @@ with gr.Blocks(title="Apollo.io Data Fetcher", theme=gr.themes.Soft()) as demo:
                 outputs=[enrich_output]
             )
         
-        # Setup Instructions Tab
-        with gr.TabItem("⚙️ Setup Instructions"):
+        # ==========================================
+        # SETUP INSTRUCTIONS TAB
+        # ==========================================
+        
+        with gr.TabItem("⚙️ Setup & Troubleshooting"):
             gr.Markdown("""
             ## 🔧 How to Set Up Apollo.io API on Hugging Face
             
@@ -456,57 +620,115 @@ with gr.Blocks(title="Apollo.io Data Fetcher", theme=gr.themes.Soft()) as demo:
             - If API key is configured correctly, you'll see "🔑 Live API Mode" at the top
             - If not configured, you'll see "🎭 Demo Mode" with sample data
             
-            ### 🌟 Apollo.io API Features
+            ## 🚨 Common API Access Issues & Solutions
+            
+            ### 403 Error - Access Denied
+            **Problem**: Your API key doesn't have access to certain endpoints.
+            
+            **Solutions**:
+            1. **Try Email Finder**: Often more accessible than people/company search
+            2. **Check API Plan**: Some features require paid Apollo.io plans
+            3. **Verify Permissions**: Ensure your API key has the right permissions
+            4. **Use Contact Enrichment**: Usually available on all plans
             
-            #### 📊 Database Size
-            - **275+ million contacts** (people)
-            - **70+ million companies**
-            - Global coverage with detailed B2B information
+            ### Available Features by Plan:
             
-            #### 🛠️ Available Features in This App
-            1. **People Search** - Find contacts by various criteria
-            2. **Company Search** - Discover businesses and organizations  
-            3. **Contact Enrichment** - Add details to existing contacts
+            #### 🆓 Free Plan
+            - Contact enrichment (limited)
+            - Email finder (limited)
+            - Basic API access
             
-            #### 💡 Use Cases
-            - **Sales Automation**: Find and contact prospects
-            - **Lead Generation**: Build targeted contact lists
-            - **CRM Integration**: Sync with Salesforce, HubSpot
-            - **Data Enrichment**: Complete incomplete contact records
-            - **Market Research**: Analyze companies and industries
+            #### 💰 Paid Plans
+            - Full people search
+            - Company search
+            - Unlimited contact enrichment
+            - Higher rate limits
             
-            #### ⚡ Rate Limits
-            - Free plan: 50 requests/month
-            - Paid plans: Higher limits based on subscription
-            - Enterprise: Custom rate limits available
+            ### Rate Limits
+            - **Free**: 50 requests/month
+            - **Starter**: 1,000+ requests/month
+            - **Professional**: 5,000+ requests/month
+            - **Organization**: Custom limits
             
-            #### 🔒 Security Features
+            ## 🔒 Security Features
             - API keys with granular permissions
             - HTTPS encryption for all requests
             - SOC 2 Type II compliant
+            - Secure secret management via Hugging Face
             
-            ---
+            ## 📊 Apollo.io Database Stats
+            - **275+ million contacts** worldwide
+            - **70+ million companies** across industries
+            - Global B2B coverage with detailed information
+            - Regularly updated and verified data
             
-            ### 🚨 Troubleshooting
+            ## 🛠️ Technical Details
+            - Built with Gradio for interactive web interface
+            - Uses Apollo.io REST API for data retrieval
+            - Pandas for data processing and table display
+            - Error handling and rate limiting awareness
             
-            #### Common Issues:
-            1. **"Invalid API key" error**: Check if APOLLO_API_KEY secret is set correctly
-            2. **"Rate limit exceeded"**: You've hit your plan's limit, wait or upgrade
-            3. **No results found**: Try broader search terms or check your query
-            4. **Demo mode active**: API key not configured in repository secrets
+            ## 🚨 Troubleshooting Guide
             
-            #### Need Help?
-            - Check [Apollo.io API Documentation](https://apolloio.github.io/apollo-api-docs/)
-            - Contact Apollo.io support for API issues
-            - Check Hugging Face documentation for Spaces setup
+            #### Issue: "API Error: 403 - Access Denied"
+            **Solution**: Your API key lacks permissions. Try:
+            - Upgrading your Apollo.io plan
+            - Using Email Finder instead of People Search
+            - Checking API key permissions in Apollo.io
+            
+            #### Issue: "Invalid API key"
+            **Solution**: 
+            - Check if APOLLO_API_KEY secret is set correctly in Space settings
+            - Verify the API key is copied correctly from Apollo.io
+            - Restart your Space after adding the secret
+            
+            #### Issue: "Rate limit exceeded"
+            **Solution**:
+            - Wait for the rate limit to reset
+            - Upgrade your Apollo.io plan for higher limits
+            - Use demo mode for testing
+            
+            #### Issue: "No results found"
+            **Solution**:
+            - Try broader search terms
+            - Check spelling and formatting
+            - Use different keywords or filters
+            
+            #### Issue: Demo mode always active
+            **Solution**:
+            - Ensure APOLLO_API_KEY is added to repository secrets
+            - Check the secret name is exactly: `APOLLO_API_KEY`
+            - Restart the Space after adding secrets
+            
+            ## 💡 Best Practices
+            
+            1. **Start with Demo Mode**: Test the interface before adding API key
+            2. **Monitor Usage**: Check Apollo.io dashboard for API usage
+            3. **Use Specific Searches**: More specific queries return better results
+            4. **Export Data**: Use table view to copy/export results
+            5. **Respect Rate Limits**: Don't exceed your plan's limits
+            
+            ## 📞 Support Resources
+            - **Apollo.io API Docs**: [apolloio.github.io/apollo-api-docs](https://apolloio.github.io/apollo-api-docs/)
+            - **Apollo.io Support**: Contact through their platform
+            - **Hugging Face Docs**: [huggingface.co/docs/hub/spaces-overview](https://huggingface.co/docs/hub/spaces-overview)
             """)
     
+    # ==========================================
+    # FOOTER
+    # ==========================================
+    
     gr.HTML("""
     <div style="text-align: center; padding: 20px; color: #666;">
-        <p>🚀 Built with Apollo.io API & Gradio | <a href="https://apolloio.github.io/apollo-api-docs/" target="_blank">API Docs</a> | <a href="https://huggingface.co/docs/hub/spaces-overview" target="_blank">HF Spaces</a></p>
+        <p>🚀 Built with Apollo.io API & Gradio | 
+        <a href="https://apolloio.github.io/apollo-api-docs/" target="_blank">API Docs</a> | 
+        <a href="https://huggingface.co/docs/hub/spaces-overview" target="_blank">HF Spaces</a></p>
     </div>
     """)
 
-# Launch the app
+# ==========================================
+# LAUNCH APPLICATION
+# ==========================================
+
 if __name__ == "__main__":
     demo.launch()