Sirthelabel APIsirthelabel.com ↗

"""
SIR. The Label API Client
Get your API key from: https://parse.bot/settings
"""

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


class ParseClient:
    """Client for SIR. The Label fashion brand API via Parse."""

    def __init__(self, api_key: Optional[str] = None):
        self.base_url = "https://api.parse.bot"
        self.scraper_id = "6ee4f54b-8cbf-4955-8ea8-b775469a2ede"
        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 API request to 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.upper() == "GET":
            response = requests.get(url, headers=headers, params=params)
        elif method.upper() == "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_products(
        self,
        query: str,
        page: int = 1,
        results_per_page: int = 24,
        sort_field: str = "relevance",
        sort_direction: str = "desc"
    ) -> Dict[str, Any]:
        """
        Search products on SIR. The Label.

        Args:
            query: Search query text (e.g., 'dress', 'silk top')
            page: Page number for pagination
            results_per_page: Number of results per page
            sort_field: Field to sort by (relevance, ss_days_since_published, ga_unique_purchases, ss_price)
            sort_direction: Sort direction (asc, desc)

        Returns:
            Dict with query, pagination, results, and facets
        """
        return self._call(
            "search_products",
            method="GET",
            query=query,
            page=page,
            results_per_page=results_per_page,
            sort_field=sort_field,
            sort_direction=sort_direction
        )

    def get_product(self, handle: str) -> Dict[str, Any]:
        """
        Get full product details by handle.

        Args:
            handle: Product URL handle/slug (e.g., 'phillipa-shirt-dress-eira-midnight')

        Returns:
            Dict with product details including images, variants, and pricing
        """
        return self._call("get_product", method="GET", handle=handle)

    def get_loyalty_program(self, country: str = "US") -> Dict[str, Any]:
        """
        Get SIR. Loyalty program configuration.

        Args:
            country: Country code for localized loyalty info (e.g., 'US', 'AU')

        Returns:
            Dict with tiers, earning rules, and referral incentives
        """
        return self._call("get_loyalty_program", method="GET", country=country)

    def get_page(self, handle: str) -> Dict[str, Any]:
        """
        Get help/policy page content by handle.

        Args:
            handle: Page URL handle (e.g., 'shipping-delivery', 'privacy-policy')

        Returns:
            Dict with page title, HTML body, and text summary
        """
        return self._call("get_page", method="GET", handle=handle)


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

    print("=" * 70)
    print("SIR. THE LABEL - PRODUCT DISCOVERY & DETAILS WORKFLOW")
    print("=" * 70)

    # Step 1: Search for silk dresses
    print("\n📍 Step 1: Searching for 'silk dress'...")
    search_results = client.search_products(
        query="silk dress",
        results_per_page=5,
        sort_field="ss_price",
        sort_direction="asc"
    )

    print(f"Found {search_results['pagination']['total_results']} results")
    print(f"Showing page {search_results['pagination']['current_page']} of {search_results['pagination']['total_pages']}")

    # Step 2: Display search results summary
    print("\n📋 Search Results Summary:")
    for idx, product in enumerate(search_results["results"], 1):
        print(f"\n  {idx}. {product['name']}")
        print(f"     Price: ${product['price']}")
        print(f"     Color: {product['variant_color']}")
        print(f"     Available: {'✓' if product['available'] else '✗'}")
        print(f"     Collections: {', '.join(product['collection_handle'])}")

    # Step 3: Display available facets for further filtering
    print("\n🔍 Available Filters:")
    for facet in search_results.get("facets", []):
        print(f"\n  {facet['label']}:")
        for value in facet["values"][:3]:  # Show top 3 values
            print(f"    - {value['value']} ({value['count']} products)")

    # Step 4: Get detailed information for the first few products
    print("\n" + "=" * 70)
    print("📦 DETAILED PRODUCT INFORMATION")
    print("=" * 70)

    for idx, product in enumerate(search_results["results"][:3], 1):
        product_handle = product["handle"]
        print(f"\n--- Product {idx}: {product['name']} ---")

        # Fetch full product details
        product_details = client.get_product(product_handle)

        print(f"Title: {product_details['title']}")
        print(f"Available: {'Yes' if product_details['available_for_sale'] else 'No'}")
        print(f"Price Range: ${product_details['price_range']['min']} - ${product_details['price_range']['max']} {product_details['price_range']['currency']}")

        # Show available options (sizes, colors)
        print("Available Options:")
        for option in product_details["options"]:
            print(f"  {option['name']}: {', '.join(option['values'][:5])}")
            if len(option["values"]) > 5:
                print(f"           ... and {len(option['values']) - 5} more")

        # Show variant availability
        print(f"Variants ({len(product_details['variants'])} total):")
        for variant in product_details["variants"][:3]:
            status = "In Stock" if variant["available_for_sale"] else "Out of Stock"
            qty = variant.get("quantity_available", "N/A")
            print(f"  - {variant['title']}: {status} (Qty: {qty}) - ${variant['price']}")

        if len(product_details["variants"]) > 3:
            print(f"  ... and {len(product_details['variants']) - 3} more variants")

    # Step 5: Get loyalty program information
    print("\n" + "=" * 70)
    print("💎 LOYALTY PROGRAM DETAILS")
    print("=" * 70)

    loyalty = client.get_loyalty_program(country="US")

    print(f"\nProgram: {loyalty['program_name']}")
    print(f"Currency: {loyalty['currency']['symbol']}{loyalty['currency']['code'].upper()}")

    print("\nProgram Tiers:")
    for tier in loyalty["tiers"]:
        lower = tier["bounds"]["lower"]
        upper = tier["bounds"]["upper"]
        print(f"  {tier['name']}: {lower:,} - {upper:,} points")

    print("\nEarning Rules:")
    for rule in loyalty["earning_rules"]:
        if rule["enabled"]:
            print(f"  - {rule['title']}: {rule['value']} point(s) per {rule['kind']}")

    referral = loyalty["referral_incentive"]
    print(f"\nReferral Incentive: {referral['discount_amount']}% off")
    print(f"  (Minimum spend: ${referral['minimum_spend']})")

    # Step 6: Get shipping information
    print("\n" + "=" * 70)
    print("📬 SHIPPING & DELIVERY INFORMATION")
    print("=" * 70)

    shipping_page = client.get_page("shipping-delivery")
    print(f"\nPage: {shipping_page['title']}")
    print(f"\nSummary:\n{shipping_page['body_summary'][:300]}...")

    print("\n" + "=" * 70)
    print("✅ Workflow Complete!")
    print("=" * 70)