BookDelivery APIbookdelivery.com ↗

"""
BookDelivery US Book API Client
Get your API key from: https://parse.bot/settings
"""

import os
import requests
from typing import Optional


class ParseClient:
    """Client for BookDelivery US Book API via Parse.bot"""

    def __init__(self, api_key: Optional[str] = None):
        self.base_url = "https://api.parse.bot"
        self.scraper_id = "cd0fa5f5-0b09-4e85-88b9-bc1db1921a1e"
        self.api_key = api_key or os.getenv("PARSE_API_KEY")
        if not self.api_key:
            raise ValueError("API key required. Set PARSE_API_KEY environment variable or pass api_key parameter.")

    def _call(self, endpoint: str, method: str = "POST", **params) -> dict:
        """Make API call to Parse.bot scraper"""
        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 method: {method}")

        response.raise_for_status()
        return response.json()

    def get_book_details(self, url: str) -> dict:
        """
        Get detailed information about a book from its product page URL.

        Args:
            url: Product page URL (full or relative path)

        Returns:
            Dictionary with book details including title, author, price, condition, etc.
        """
        return self._call("get_book_details", method="GET", url=url)

    def search_by_isbn(self, isbn: str) -> dict:
        """
        Search for books by ISBN-13 on the US storefront.

        Args:
            isbn: 13-digit ISBN-13 number (e.g., 9780141036144)

        Returns:
            Dictionary with search results array and total count
        """
        return self._call("search_by_isbn", method="GET", isbn=isbn)


def main():
    """Practical workflow: search for books and get detailed information"""
    
    # Initialize client
    client = ParseClient()
    
    # Example ISBNs to search for
    search_isbns = [
        "9780141036144",  # 1984 by George Orwell
        "9780008753832",  # Hooked by Asako Yuzuki
    ]
    
    all_books = []
    
    # Search for each ISBN and collect results
    print("=" * 60)
    print("SEARCHING FOR BOOKS BY ISBN")
    print("=" * 60)
    
    for isbn in search_isbns:
        print(f"\nSearching for ISBN: {isbn}...")
        try:
            search_results = client.search_by_isbn(isbn)
            
            if search_results.get("results"):
                for book in search_results["results"]:
                    print(f"  Found: {book['title']} by {book['author']}")
                    print(f"    Price: ${book['price']} {book['currency']}")
                    print(f"    Condition: {book['condition']}")
                    print(f"    In Stock: {book['in_stock']}")
                    
                    all_books.append(book)
            else:
                print(f"  No results found for ISBN {isbn}")
        except Exception as e:
            print(f"  Error searching for ISBN {isbn}: {e}")
    
    # Get detailed information for books with product URLs
    print("\n" + "=" * 60)
    print("GETTING DETAILED BOOK INFORMATION")
    print("=" * 60)
    
    for book in all_books:
        if "product_url" in book:
            print(f"\nFetching details for: {book['title']}")
            try:
                details = client.get_book_details(book["product_url"])
                
                print(f"  Title: {details['title']}")
                print(f"  Author: {details['author']}")
                print(f"  Publisher: {details['publisher']}")
                print(f"  ISBN: {details['isbn']}")
                print(f"  Price: ${details['price']} {details['currency']}")
                print(f"  Condition: {details['condition']}")
                print(f"  Stock Status: {'In Stock' if details['in_stock'] else 'Out of Stock'}")
                print(f"  Fast Shipping: {'Yes' if details['fast_shipping'] else 'No'}")
                
            except Exception as e:
                print(f"  Error fetching details: {e}")
    
    # Summary
    print("\n" + "=" * 60)
    print("SUMMARY")
    print("=" * 60)
    print(f"Total books searched: {len(search_isbns)}")
    print(f"Total books found: {len(all_books)}")
    
    if all_books:
        in_stock_count = sum(1 for book in all_books if book.get("in_stock"))
        print(f"Books in stock: {in_stock_count}")
        
        avg_price = sum(book.get("price", 0) for book in all_books) / len(all_books)
        print(f"Average price: ${avg_price:.2f}")


if __name__ == "__main__":
    main()