Rapidapi APIbooking-com.p.rapidapi.com ↗

"""
Booking.com Scraper API Client

Get your API key from: https://parse.bot/settings
"""

import os
import requests
from typing import Any, Dict, List, Optional


class ParseClient:
    """Client for interacting with the Booking.com Scraper API."""
    
    def __init__(self, api_key: Optional[str] = None):
        """
        Initialize the ParseClient.
        
        Args:
            api_key: API key for Parse Bot. If not provided, reads from PARSE_API_KEY env var.
        """
        self.base_url = "https://api.parse.bot"
        self.scraper_id = "15bd80e1-56cd-4b5d-bb77-42d31d8b2067"
        self.api_key = api_key or os.getenv("PARSE_API_KEY")
        
        if not self.api_key:
            raise ValueError("API key must be provided or set in PARSE_API_KEY environment variable")
    
    def _call(self, endpoint: str, method: str = "POST", **params) -> Dict[str, Any]:
        """
        Make an API call to the Parse Bot scraper.
        
        Args:
            endpoint: The endpoint name (e.g., "search_properties")
            method: HTTP method ("GET" or "POST")
            **params: Parameters to send with the request
            
        Returns:
            The API response as a dictionary
            
        Raises:
            requests.HTTPError: If the API request fails
        """
        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, timeout=30)
        elif method == "POST":
            response = requests.post(url, headers=headers, json=params, timeout=30)
        else:
            raise ValueError(f"Unsupported HTTP method: {method}")
        
        response.raise_for_status()
        return response.json()
    
    def search_properties(self, query: str, limit: int = 10) -> Dict[str, Any]:
        """
        Search for hotel properties by location or keyword.
        
        Args:
            query: Search keyword such as city name, hotel name, or area.
            limit: Maximum number of results to return (default: 10).
            
        Returns:
            Dictionary containing query, total_results, and results array with property data.
        """
        return self._call("search_properties", method="GET", query=query, limit=limit)
    
    def get_property_details(self, url: str) -> Dict[str, Any]:
        """
        Extract detailed information for a specific Booking.com hotel property.
        
        Args:
            url: The full Booking.com property URL.
            
        Returns:
            Dictionary containing detailed property information including name, address,
            rating, description, amenities, and images.
        """
        return self._call("get_property_details", method="GET", url=url)


def format_rating(rating_str: str) -> str:
    """Parse and format rating string from search results."""
    if not rating_str:
        return "N/A"
    return rating_str.strip()


def display_search_results(results: List[Dict[str, Any]]) -> None:
    """Display formatted search results."""
    for i, hotel in enumerate(results, 1):
        print(f"\n{i}. {hotel.get('name', 'N/A')}")
        print(f"   Rating: {format_rating(hotel.get('rating', 'N/A'))}")
        print(f"   Price: {hotel.get('price', 'N/A')}")
        print(f"   Address: {hotel.get('address', 'N/A')}")
        print(f"   URL: {hotel.get('url', 'N/A')}")


def display_property_details(details: Dict[str, Any]) -> None:
    """Display formatted property details."""
    print(f"\n📋 Hotel: {details.get('name', 'N/A')}")
    print(f"📍 Address: {details.get('address', 'N/A')}")
    print(f"⭐ Rating: {details.get('rating_score', 'N/A')}/10 ({details.get('rating_category', 'N/A')})")
    print(f"📝 Reviews: {details.get('review_count', 'N/A')} reviews")
    print(f"💰 Price: {details.get('price', 'N/A')}")
    
    # Display description
    description = details.get('description_text', '')
    if description:
        truncated = description[:200] + "..." if len(description) > 200 else description
        print(f"📄 Description: {truncated}")
    
    # Display amenities
    amenities = details.get('amenities', [])
    if amenities:
        print(f"🏨 Amenities ({len(amenities)} total):")
        for amenity in amenities[:5]:
            print(f"   • {amenity}")
        if len(amenities) > 5:
            print(f"   ... and {len(amenities) - 5} more")
    
    # Display images
    images = details.get('images', [])
    if images:
        print(f"📸 Images available: {len(images)}")


def main():
    """Practical workflow: search for hotels and retrieve detailed information."""
    try:
        # Initialize the client
        client = ParseClient()
        
        print("=" * 70)
        print("BOOKING.COM HOTEL SEARCH & DETAILS RETRIEVAL")
        print("=" * 70)
        
        # Step 1: Search for properties
        search_location = "Paris"
        print(f"\n🔍 Searching for hotels in '{search_location}'...")
        
        search_response = client.search_properties(query=search_location, limit=5)
        
        if search_response.get('status') != 'success':
            print(f"❌ Search failed: {search_response}")
            return
        
        search_data = search_response.get('data', {})
        total_results = search_data.get('total_results', 0)
        results = search_data.get('results', [])
        
        print(f"\n✅ Found {total_results} total hotels")
        print(f"📊 Showing {len(results)} results:")
        
        display_search_results(results)
        
        # Step 2: Get detailed information for each hotel
        hotel_urls = [hotel.get('url') for hotel in results if hotel.get('url')]
        
        if hotel_urls:
            print("\n" + "=" * 70)
            print("DETAILED HOTEL INFORMATION")
            print("=" * 70)
            
            for idx, hotel_url in enumerate(hotel_urls[:3], 1):
                print(f"\n[{idx}/{min(3, len(hotel_urls))}] Fetching details...")
                
                try:
                    details_response = client.get_property_details(url=hotel_url)
                    
                    if details_response.get('status') != 'success':
                        print(f"⚠️  Could not fetch details for this property")
                        continue
                    
                    details_data = details_response.get('data', {})
                    display_property_details(details_data)
                    print("-" * 70)
                    
                except requests.exceptions.RequestException as e:
                    print(f"❌ Error fetching property details: {e}")
                except Exception as e:
                    print(f"❌ Unexpected error: {e}")
        
        print("\n✅ Hotel search and details retrieval complete!")
    
    except ValueError as e:
        print(f"❌ Configuration error: {e}")
    except requests.exceptions.RequestException as e:
        print(f"❌ Network error: {e}")
    except Exception as e:
        print(f"❌ Unexpected error: {e}")


if __name__ == "__main__":
    main()