PWCC Marketplace APIpwccmarketplace.com ↗

"""
PWCC / Fanatics Collect Marketplace API Client

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

import os
import requests
from typing import Optional


class ParseClient:
    """Client for PWCC / Fanatics Collect Marketplace API"""
    
    def __init__(self, api_key: Optional[str] = None):
        self.base_url = "https://api.parse.bot"
        self.scraper_id = "6f75fc48-78a3-4fa4-a96a-937d35bf9385"
        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:
        """Make API call to Parse Bot"""
        headers = {
            "X-API-Key": self.api_key,
            "Content-Type": "application/json"
        }
        url = f"{self.base_url}/scraper/{self.scraper_id}/{endpoint}"
        
        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_listings(
        self,
        keywords: str,
        page: int = 0,
        hits_per_page: int = 20,
        marketplace: Optional[str] = None,
        status: Optional[str] = None
    ) -> dict:
        """
        Search PWCC/Fanatics Collect marketplace listings by keywords.
        
        Args:
            keywords: Search keywords (e.g. 'charizard psa 10', 'michael jordan rookie')
            page: Zero-based page number for pagination (default: 0)
            hits_per_page: Number of results per page (default: 20)
            marketplace: Filter by marketplace type (PREMIER, WEEKLY, FIXED)
            status: Filter by listing status (Sold, Live)
        
        Returns:
            Dictionary with results, total_hits, page info
        """
        params = {
            "keywords": keywords,
            "page": page,
            "hits_per_page": hits_per_page
        }
        
        if marketplace:
            params["marketplace"] = marketplace
        if status:
            params["status"] = status
        
        return self._call("search_listings", method="GET", **params)
    
    def get_listing_details(self, listing_uuid: str) -> dict:
        """
        Get full details for a specific PWCC/Fanatics Collect listing.
        
        Args:
            listing_uuid: UUID of the listing (e.g. '232c2cb0-6f25-11ed-a516-0a58a9feac02')
        
        Returns:
            Dictionary with complete listing details including description
        """
        return self._call("get_listing_details", method="GET", listing_uuid=listing_uuid)


def main():
    """Practical usage example: Search for cards and get details for top results"""
    
    client = ParseClient()
    
    print("=" * 70)
    print("PWCC / Fanatics Collect Marketplace Search")
    print("=" * 70)
    
    search_keyword = "charizard psa 10"
    print(f"\nSearching for: '{search_keyword}'")
    print("-" * 70)
    
    search_results = client.search_listings(
        keywords=search_keyword,
        page=0,
        hits_per_page=5,
        status="Sold"
    )
    
    print(f"Found {search_results['total_hits']} total listings")
    print(f"Showing page {search_results['page']} of {search_results['total_pages']}")
    print(f"Results per page: {search_results['hits_per_page']}\n")
    
    if not search_results['results']:
        print("No results found.")
        return
    
    print(f"Top {len(search_results['results'])} listings:\n")
    
    for idx, listing in enumerate(search_results['results'], 1):
        print(f"{idx}. {listing['title']}")
        print(f"   Year: {listing['year']}")
        print(f"   Card #: {listing['card_number']}")
        print(f"   Grade: PSA {listing['grade']} (Cert: {listing['cert_number']})")
        print(f"   Status: {listing['status']}")
        
        if listing['status'] == "Sold":
            price_dollars = listing.get('purchase_price_cents', 0) / 100
            print(f"   Sold Price: ${price_dollars:,.2f}")
        else:
            bid_dollars = listing.get('current_bid_cents', 0) / 100
            print(f"   Current Bid: ${bid_dollars:,.2f}")
        
        print(f"   Marketplace: {listing['marketplace']}")
        print()
    
    if search_results['results']:
        first_listing_uuid = search_results['results'][0]['listing_uuid']
        print("-" * 70)
        print(f"\nFetching detailed information for first listing...")
        print(f"UUID: {first_listing_uuid}\n")
        
        details = client.get_listing_details(first_listing_uuid)
        
        print("Full Listing Details:")
        print(f"Title: {details['title']}")
        print(f"Subtitle: {details.get('subtitle', 'N/A')}")
        print(f"Grade: PSA {details['grade']}")
        print(f"Certification: {details['cert_number']}")
        print(f"Year: {details['year']}")
        print(f"Card Number: {details['card_number']}")
        print(f"Category: {details.get('category', 'N/A')}")
        print(f"Brand: {details['brand']}")
        
        if 'description' in details and details['description']:
            print(f"\nDescription:\n{details['description'][:500]}...")
        
        print("\n" + "=" * 70)
        print("Search and detail retrieval completed successfully!")


if __name__ == "__main__":
    main()