cdep APIcdep.ro ↗

"""
Romanian Parliament (cdep.ro) Legislative Initiatives Scraper
Get your API key from: https://parse.bot/settings
"""

import os
import requests
from typing import Optional


class ParseClient:
    """Client for the Romanian Parliament (cdep.ro) legislative initiatives API."""
    
    def __init__(self, api_key: Optional[str] = None):
        """Initialize the Parse API client."""
        self.base_url = "https://api.parse.bot"
        self.scraper_id = "505f50bc-e7ef-4ed8-a049-c23e3e1e5387"
        self.api_key = api_key or os.getenv("PARSE_API_KEY")
        
        if not self.api_key:
            raise ValueError("API key not provided. Set PARSE_API_KEY environment variable.")
    
    def _call(self, endpoint: str, method: str = "POST", **params) -> dict:
        """
        Call a Parse API endpoint.
        
        Args:
            endpoint: The API endpoint name
            method: HTTP method (GET or POST)
            **params: Query or body parameters
            
        Returns:
            JSON 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 list_initiatives(self, chamber: Optional[str] = None, year: Optional[str] = None) -> dict:
        """
        List legislative initiatives for a specific year and chamber.
        
        Args:
            chamber: Legislative chamber (1 = Senate, 2 = Chamber of Deputies). Default: 2
            year: Year of registration. Default: 2024
            
        Returns:
            Dictionary with initiatives list
        """
        params = {}
        if chamber is not None:
            params["chamber"] = chamber
        if year is not None:
            params["year"] = year
        
        return self._call("list_initiatives", method="GET", **params)
    
    def get_initiative_details(self, idp: str) -> dict:
        """
        Get detailed information for a specific legislative initiative.
        
        Args:
            idp: Internal identifier of the project
            
        Returns:
            Dictionary with initiative details
        """
        return self._call("get_initiative_details", method="GET", idp=idp)


def main():
    """Demonstrate a practical workflow with the Romanian Parliament API."""
    client = ParseClient()
    
    print("=" * 80)
    print("Romanian Parliament Legislative Initiatives Scraper")
    print("=" * 80)
    
    # Step 1: List initiatives from 2024 (Chamber of Deputies, default)
    print("\n1. Fetching legislative initiatives from 2024...")
    initiatives_response = client.list_initiatives(year="2024", chamber="2")
    
    year = initiatives_response.get("year", "2024")
    total_count = initiatives_response.get("count", 0)
    initiatives = initiatives_response.get("initiatives", [])
    
    print(f"   Found {total_count} initiative(s) from {year}")
    
    if not initiatives:
        print("   No initiatives found.")
        return
    
    # Step 2: Process each initiative
    print(f"\n2. Processing {min(3, len(initiatives))} initiatives (showing first 3)...")
    for i, initiative in enumerate(initiatives[:3], 1):
        idp = initiative.get("idp")
        title = initiative.get("title", "N/A")
        status = initiative.get("status", "N/A")
        date_intro = initiative.get("date_introduced", "N/A")
        reg_num = initiative.get("registration_number", "N/A")
        
        print(f"\n   Initiative {i}:")
        print(f"   - ID: {idp}")
        print(f"   - Title: {title}")
        print(f"   - Registration #: {reg_num}")
        print(f"   - Introduced: {date_intro}")
        print(f"   - Status: {status}")
        
        # Step 3: Get detailed information for each initiative
        if idp:
            try:
                print(f"   - Fetching details...")
                details = client.get_initiative_details(idp=idp)
                
                sponsors = details.get("sponsors", [])
                summary = details.get("summary", "N/A")
                url = details.get("url", "N/A")
                detail_status = details.get("status", status)
                
                print(f"     Sponsors: {', '.join(sponsors) if sponsors else 'None listed'}")
                print(f"     URL: {url}")
                print(f"     Summary: {summary[:100]}..." if len(summary) > 100 else f"     Summary: {summary}")
                
            except Exception as e:
                print(f"     Error fetching details: {str(e)}")
    
    # Summary
    print("\n" + "=" * 80)
    print(f"Summary: Successfully retrieved {min(3, len(initiatives))} initiatives from {year}")
    print("=" * 80)


if __name__ == "__main__":
    main()