MoneyMintIdea APImoneymintidea.com ↗

"""
MoneyMintIdea API Client
Access financial content from MoneyMintIdea.com including gold rates, silver rates, 
IPO information, share price targets, and other financial articles.

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

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


class ParseClient:
    """Client for interacting with the MoneyMintIdea Parse API."""
    
    def __init__(self, api_key: Optional[str] = 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 = "4f13a694-ebe8-4849-918d-743ca7c499a6"
        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 as 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.
        
        Args:
            endpoint: The API endpoint name
            method: HTTP method (GET or POST)
            **params: Query parameters or request body parameters
            
        Returns:
            Parsed JSON response
        """
        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_posts(self, query: str, per_page: int = 10, page: int = 1) -> Dict[str, Any]:
        """
        Search posts by keyword across the entire site.
        
        Args:
            query: Search keyword (e.g., 'gold rate', 'IPO', 'silver price')
            per_page: Number of results per page (1-100), default 10
            page: Page number for pagination, default 1
            
        Returns:
            Dictionary containing posts array and pagination info
        """
        return self._call(
            "search_posts",
            method="GET",
            query=query,
            per_page=per_page,
            page=page
        )
    
    def get_posts_by_category(
        self, 
        category: str, 
        per_page: int = 10, 
        page: int = 1
    ) -> Dict[str, Any]:
        """
        Get posts filtered by category slug.
        
        Args:
            category: Category slug (e.g., 'gold-price-today', 'upcoming-ipo')
            per_page: Number of results per page (1-100), default 10
            page: Page number for pagination, default 1
            
        Returns:
            Dictionary containing posts array and pagination info
        """
        return self._call(
            "get_posts_by_category",
            method="GET",
            category=category,
            per_page=per_page,
            page=page
        )
    
    def get_post(self, slug: str) -> Dict[str, Any]:
        """
        Get a single post by its URL slug with full content.
        
        Args:
            slug: Post URL slug (e.g., 'gold-rate-today', 'gold-rate-in-bhopal')
            
        Returns:
            Dictionary containing full post data including HTML and text content
        """
        return self._call("get_post", method="GET", slug=slug)
    
    def get_categories(self) -> Dict[str, Any]:
        """
        Get all available content categories with their post counts.
        
        Returns:
            Dictionary containing array of category objects
        """
        return self._call("get_categories", method="GET")


def main():
    """Demonstrate practical workflow with the MoneyMintIdea API."""
    
    # Initialize client
    client = ParseClient()
    
    print("=" * 80)
    print("MoneyMintIdea API - Practical Usage Example")
    print("=" * 80)
    
    # 1. Get all available categories
    print("\n1. Fetching available categories...")
    categories_data = client.get_categories()
    categories = categories_data.get("categories", [])
    
    print(f"   Found {len(categories)} categories:")
    for cat in categories[:5]:  # Show first 5
        print(f"   - {cat['name']} ({cat['slug']}) - {cat['count']} posts")
    
    # 2. Get recent posts from "Gold Price Today" category
    print("\n2. Fetching recent gold price posts...")
    gold_posts = client.get_posts_by_category(category="gold-price-today", per_page=3)
    
    print(f"   Found {gold_posts['total']} total gold price posts")
    print(f"   Showing page {gold_posts['page']} of {gold_posts['total_pages']}")
    print("\n   Recent Gold Price Articles:")
    
    gold_post_list: List[Dict[str, Any]] = gold_posts.get("posts", [])
    for post in gold_post_list:
        print(f"\n   • Title: {post['title']}")
        print(f"     Date: {post['date']}")
        print(f"     URL: {post['link']}")
        print(f"     Excerpt: {post['excerpt'][:80]}...")
    
    # 3. Get detailed content from the first gold price post
    if gold_post_list:
        first_post = gold_post_list[0]
        print(f"\n3. Fetching full content for: {first_post['title']}")
        
        full_post = client.get_post(slug=first_post['slug'])
        
        print(f"\n   Post Details:")
        print(f"   Title: {full_post['title']}")
        print(f"   Published: {full_post['date']}")
        print(f"   Last Modified: {full_post['modified']}")
        print(f"\n   Content Preview (first 200 chars):")
        content = full_post.get('content_text', '')
        print(f"   {content[:200]}..." if len(content) > 200 else f"   {content}")
    
    # 4. Search for specific financial content
    print("\n4. Searching for 'IPO allotment' posts...")
    search_results = client.search_posts(query="IPO allotment", per_page=3)
    
    print(f"   Found {search_results['total']} total results")
    print(f"   Showing page {search_results['page']} of {search_results['total_pages']}")
    
    search_posts_list: List[Dict[str, Any]] = search_results.get("posts", [])
    if search_posts_list:
        print("\n   Top Search Results:")
        for i, post in enumerate(search_posts_list, 1):
            print(f"\n   {i}. {post['title']}")
            print(f"      Date: {post['date']}")
            print(f"      Link: {post['link']}")
    else:
        print("   No results found for this search.")
    
    # 5. Get posts from "Share Price Target" category
    print("\n5. Fetching share price target articles...")
    share_posts = client.get_posts_by_category(category="share-price-target", per_page=2)
    
    print(f"   Total share price target posts: {share_posts['total']}")
    share_post_list: List[Dict[str, Any]] = share_posts.get("posts", [])
    print("\n   Latest Share Price Targets:")
    for post in share_post_list:
        print(f"\n   • {post['title']}")
        print(f"     Posted: {post['date']}")
    
    print("\n" + "=" * 80)
    print("Demo completed successfully!")
    print("=" * 80)


if __name__ == "__main__":
    main()