Deliveroo APIdeliveroo.co.uk ↗

"""
Deliveroo UK API Client
Search restaurants and extract menus from Deliveroo UK.
Get your API key from: https://parse.bot/settings
"""

import os
import requests
from typing import Any


class ParseClient:
    """Client for interacting with the Deliveroo UK Parse API."""

    def __init__(self, api_key: str | None = None):
        """
        Initialize the Parse API client.

        Args:
            api_key: API key for authentication. If not provided, uses PARSE_API_KEY env var.
        """
        self.base_url = "https://api.parse.bot"
        self.scraper_id = "03208dc2-5ba7-43bd-bf9d-d8b089fc4234"
        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: Any) -> dict:
        """
        Make a request to the Parse API.

        Args:
            endpoint: API endpoint name
            method: HTTP method (GET or POST)
            **params: Query/body parameters

        Returns:
            API response as dictionary
        """
        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_restaurants(self, query: str, postcode: str) -> dict:
        """
        Search for restaurants by keyword and postcode.

        Args:
            query: Search keyword (e.g., pizza, burger, sushi)
            postcode: UK postcode to search near (e.g., EC4R 3TE)

        Returns:
            Dictionary containing array of restaurants with details
        """
        return self._call("search_restaurants", method="GET", query=query, postcode=postcode)

    def get_restaurant_menu(self, url: str) -> dict:
        """
        Get the menu for a restaurant by its Deliveroo URL.

        Args:
            url: Full Deliveroo restaurant menu URL

        Returns:
            Dictionary containing restaurant info and menu items
        """
        return self._call("get_restaurant_menu", method="GET", url=url)


if __name__ == "__main__":
    # Initialize the API client
    client = ParseClient()

    # Workflow: Search for restaurants, analyze top results, get their menus
    print("=" * 70)
    print("🍕 Deliveroo Restaurant Discovery & Menu Analyzer")
    print("=" * 70)

    # Parameters for search
    postcode = "EC4R 3TE"  # Central London
    search_query = "pizza"

    print(f"\n🔍 Searching for '{search_query}' restaurants near {postcode}...\n")

    try:
        # Step 1: Search for restaurants
        search_response = client.search_restaurants(query=search_query, postcode=postcode)
        
        if search_response.get("status") != "success":
            print("❌ Search failed")
            exit(1)

        restaurants = search_response.get("data", {}).get("restaurants", [])
        print(f"✅ Found {len(restaurants)} restaurants\n")

        if not restaurants:
            print("No restaurants found. Try a different search or postcode.")
            exit(0)

        # Step 2: Analyze top 3 restaurants and get their menus
        for idx, restaurant in enumerate(restaurants[:3], 1):
            name = restaurant.get("name", "Unknown")
            url = restaurant.get("url", "")
            details = restaurant.get("details", "")
            image = restaurant.get("image", "")

            print(f"\n{'─' * 70}")
            print(f"📍 Restaurant #{idx}: {name}")
            print(f"   Details: {details}")
            
            if not url:
                print("   ⚠️  No URL available for this restaurant")
                continue

            # Step 3: Get full menu for this restaurant
            print(f"   📋 Fetching menu details...")
            
            menu_response = client.get_restaurant_menu(url=url)
            
            if menu_response.get("status") != "success":
                print(f"   ❌ Could not fetch menu")
                continue

            restaurant_info = menu_response.get("data", {}).get("restaurant", {})
            menu_items = menu_response.get("data", {}).get("menu_items", [])

            # Display restaurant details
            rating = restaurant_info.get("rating", "N/A")
            review_count = restaurant_info.get("review_count", "0")
            address = restaurant_info.get("address", "N/A")

            print(f"   ⭐ Rating: {rating} ({review_count} reviews)")
            print(f"   📮 Address: {address}")
            print(f"   🍖 Menu items: {len(menu_items)} total")

            # Display sample menu items with prices
            print(f"\n   Sample menu items:")
            for item in menu_items[:5]:
                item_name = item.get("name", "Unknown")
                price = item.get("price")
                description = item.get("description", "")
                
                price_str = f"£{price}" if price else "Price N/A"
                desc_str = f" - {description}" if description else ""
                print(f"      • {item_name}: {price_str}{desc_str}")

            if len(menu_items) > 5:
                print(f"      ... and {len(menu_items) - 5} more items")

        print(f"\n{'=' * 70}")
        print("✨ Analysis complete!")
        print("=" * 70)

    except requests.exceptions.HTTPError as e:
        print(f"❌ API Error: {e.response.status_code} - {e.response.text}")
    except Exception as e:
        print(f"❌ Error: {e}")