Revenue Growth Guide APIrevenuegrowthguide.com ↗

"""
Revenue Growth Guide API Client
Search and retrieve B2B growth experiments from the Revenue Growth Guide library.
Get your API key from: https://parse.bot/settings
"""

import os
import requests
from typing import Optional, Any


class ParseClient:
    """Client for interacting with the Revenue Growth Guide API via Parse."""
    
    def __init__(self, api_key: Optional[str] = None):
        """Initialize the ParseClient with API credentials."""
        self.base_url = "https://api.parse.bot"
        self.scraper_id = "10f2766e-8119-4c24-9b72-759666227915"
        self.api_key = api_key or os.getenv("PARSE_API_KEY")
        
        if not self.api_key:
            raise ValueError("API key not provided and PARSE_API_KEY environment variable not set")
    
    def _call(self, endpoint: str, method: str = "POST", **params) -> dict[str, Any]:
        """Make an API call to the Parse endpoint."""
        url = f"{self.base_url}/scraper/{self.scraper_id}/{endpoint}"
        headers = {
            "X-API-Key": self.api_key,
            "Content-Type": "application/json"
        }
        
        if method == "GET":
            response = requests.get(url, headers=headers, params=params)
        elif method == "POST":
            response = requests.post(url, headers=headers, json=params)
        else:
            raise ValueError(f"Unsupported HTTP method: {method}")
        
        response.raise_for_status()
        return response.json()
    
    def search_experiments(
        self, 
        category: str = "website", 
        query: Optional[str] = None
    ) -> dict[str, Any]:
        """
        Search experiments by category with optional text query filtering.
        
        Args:
            category: Category to filter experiments. Accepts: website, digital_ads, 
                     content, social_media, events, sponsorships, email, pr_influencers
            query: Text search query to filter experiments within the category
        
        Returns:
            Dictionary containing search results with experiments list
        """
        params = {"category": category}
        if query:
            params["query"] = query
        
        return self._call("search_experiments", method="GET", **params)
    
    def get_experiment_detail(self, page_slug: str) -> dict[str, Any]:
        """
        Get full experiment details by page_slug.
        
        Args:
            page_slug: The page_slug identifier for the experiment
        
        Returns:
            Dictionary containing full experiment details, FAQs, and related experiments
        """
        return self._call("get_experiment_detail", method="GET", page_slug=page_slug)


def main():
    """Demonstrate a practical workflow with the Revenue Growth Guide API."""
    # Initialize the client
    client = ParseClient()
    
    print("=" * 80)
    print("Revenue Growth Guide API - Practical Usage Example")
    print("=" * 80)
    print()
    
    # Step 1: Search for experiments in the website category with a specific query
    print("Step 1: Searching for 'conversion' experiments in website category...")
    print("-" * 80)
    
    search_results = client.search_experiments(category="website", query="conversion")
    
    print(f"Found {search_results['total']} experiments matching 'conversion' in website category")
    print()
    
    # Step 2: Display search results and select experiments to get details
    if search_results["experiments"]:
        print("Search Results:")
        for exp in search_results["experiments"][:3]:  # Show first 3 results
            print(f"  • {exp['title']}")
            print(f"    Slug: {exp['slug']}")
            print(f"    Time to Implement: {exp['tti']}")
            print(f"    Tags: {', '.join(exp['tags'])}")
            print(f"    Description: {exp['description'][:100]}...")
            print()
        
        # Step 3: Get detailed information for the first experiment
        if search_results["experiments"]:
            first_exp = search_results["experiments"][0]
            page_slug = first_exp["page_slug"]
            
            print(f"Step 2: Getting detailed information for '{first_exp['title']}'...")
            print("-" * 80)
            
            detail = client.get_experiment_detail(page_slug)
            
            print(f"Experiment: {detail['name']}")
            print(f"Category: {detail['category_label']}")
            print(f"Time to Implement: {detail['tti']}")
            print(f"Tags: {', '.join(detail['tags'])}")
            print()
            
            print("Meta Description:")
            print(f"  {detail['meta_description']}")
            print()
            
            print("Overview:")
            print(f"  {detail['public_description'][:300]}...")
            print()
            
            # Step 4: Show FAQs if available
            if detail.get("faq"):
                print("Frequently Asked Questions:")
                for i, faq_item in enumerate(detail["faq"][:2], 1):  # Show first 2 FAQs
                    print(f"  Q{i}: {faq_item['q']}")
                    print(f"  A{i}: {faq_item['a'][:150]}...")
                    print()
            
            # Step 5: Show related experiments
            if detail.get("related"):
                print("Related Experiments:")
                for related in detail["related"][:3]:  # Show first 3 related
                    print(f"  • {related['name']}")
                    print(f"    Category: {related['category_label']}")
                    print()
    
    # Step 6: Search in a different category
    print("Step 3: Searching for experiments in the 'email' category...")
    print("-" * 80)
    
    email_results = client.search_experiments(category="email")
    
    print(f"Found {email_results['total']} experiments in email category")
    if email_results["experiments"]:
        print("First few email experiments:")
        for exp in email_results["experiments"][:2]:
            print(f"  • {exp['title']}")
    
    print()
    print("=" * 80)
    print("Workflow complete!")
    print("=" * 80)


if __name__ == "__main__":
    main()