service-public APIservice-public.fr ↗

"""
Service-Public.fr Cyberbullying API Client
Get your API key from: https://parse.bot/settings
"""

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


class ParseClient:
    """Client for Service-Public.fr Cyberbullying API via Parse.bot"""

    def __init__(self, api_key: Optional[str] = None):
        self.base_url = "https://api.parse.bot"
        self.scraper_id = "ea53a944-7aff-4f88-9cab-0d2d959bd911"
        self.api_key = api_key or os.getenv("PARSE_API_KEY")
        if not self.api_key:
            raise ValueError("API key not provided and PARSE_API_KEY not set")

    def _call(self, endpoint: str, method: str = "POST", **params) -> Dict[str, Any]:
        """Make an API call to the Parse scraper endpoint"""
        url = f"{self.base_url}/scraper/{self.scraper_id}/{endpoint}"
        headers = {
            "X-API-Key": self.api_key,
            "Content-Type": "application/json"
        }

        try:
            if method == "GET":
                response = requests.get(url, headers=headers, params=params, timeout=30)
            elif method == "POST":
                response = requests.post(url, headers=headers, json=params, timeout=30)
            else:
                raise ValueError(f"Unsupported method: {method}")

            response.raise_for_status()
            return response.json()
        except requests.exceptions.RequestException as e:
            print(f"API Error: {e}")
            raise

    def get_suggestions(self, query: str) -> Dict[str, Any]:
        """Get autocomplete suggestions and direct access links for a search term"""
        return self._call("get_suggestions", method="GET", query=query)

    def search_site(self, query: str, page: int = 1) -> Dict[str, Any]:
        """Search service-public.fr for practical guides, news, and services"""
        return self._call("search_site", method="GET", query=query, page=page)

    def get_fiche_by_id(self, id: str) -> Dict[str, Any]:
        """Fetch a practical guide (Fiche Pratique) or category page by its ID"""
        return self._call("get_fiche_by_id", method="GET", id=id)

    def get_cyberbullying_guide(self) -> Dict[str, Any]:
        """Get the main cyberbullying guide (Fiche F32239)"""
        return self._call("get_cyberbullying_guide", method="GET")

    def get_emergency_contacts(self) -> Dict[str, Any]:
        """Get emergency contacts and support organizations for cyberbullying"""
        return self._call("get_emergency_contacts", method="GET")

    def get_legal_texts_cyberbullying(self) -> Dict[str, Any]:
        """Extract legal text references from the cyberbullying guide"""
        return self._call("get_legal_texts_cyberbullying", method="GET")


def print_section(title: str, content: str, width: int = 80) -> None:
    """Print a formatted section header"""
    print(f"\n{'='*width}")
    print(f"  {title}")
    print(f"{'='*width}\n")


def main():
    """Practical workflow example: Search for cyberbullying, get guide, and extract key info"""
    
    api_key = os.getenv("PARSE_API_KEY")
    client = ParseClient(api_key)

    # Step 1: Get suggestions for cyberbullying-related terms
    print_section("STEP 1: Get Suggestions for 'cyberharcèlement'")
    suggestions_response = client.get_suggestions("cyberharcèlement")
    
    if suggestions_response.get("status") == "success":
        data = suggestions_response.get("data", {})
        print("Autocomplete suggestions:")
        for suggestion in data.get("autocomplete", [])[:3]:
            print(f"  • {suggestion}")
        
        # Show practical guides from direct access
        fiches = data.get("acces_direct", {}).get("fiches_pratiques", [])
        if fiches:
            print("\nDirect access to practical guides:")
            for fiche in fiches[:2]:
                print(f"  • {fiche.get('title')}")
                print(f"    URL: {fiche.get('url')}")

    # Step 2: Search for related documents
    print_section("STEP 2: Search for Justice-Related Documents")
    search_response = client.search_site("justice harassment", page=1)
    
    if search_response.get("status") == "success":
        results = search_response.get("data", {}).get("results", [])
        print(f"Found {len(results)} results\n")
        
        # Process first 3 results
        fiche_ids_to_fetch = []
        for i, result in enumerate(results[:3], 1):
            title = result.get("title", "Unknown")
            doc_id = result.get("id", "")
            print(f"{i}. {title}")
            print(f"   ID: {doc_id}")
            if doc_id:
                fiche_ids_to_fetch.append(doc_id)

    # Step 3: Get the main cyberbullying guide
    print_section("STEP 3: Get Main Cyberbullying Guide (F32239)")
    guide_response = client.get_cyberbullying_guide()
    
    if guide_response.get("status") == "success":
        guide_data = guide_response.get("data", {})
        print(f"Title: {guide_data.get('title')}")
        print(f"URL: {guide_data.get('url')}")
        
        # Show breadcrumb navigation
        breadcrumb = guide_data.get("breadcrumb", [])
        if breadcrumb:
            print(f"\nBreadcrumb: {' > '.join(breadcrumb)}")
        
        # Show first 2 sections
        sections = guide_data.get("sections", [])
        if sections:
            print(f"\nGuide sections ({len(sections)} total):")
            for section in sections[:2]:
                title = section.get("title", "")
                content = section.get("content", "")[:100]
                print(f"\n  {title}")
                if content:
                    print(f"  {content}...")

    # Step 4: Get emergency contacts
    print_section("STEP 4: Extract Emergency Contacts")
    contacts_response = client.get_emergency_contacts()
    
    if contacts_response.get("status") == "success":
        contacts = contacts_response.get("data", {}).get("emergency_contacts", [])
        print(f"Found {len(contacts)} emergency contacts:\n")
        
        for contact in contacts:
            if "number" in contact:
                print(f"📞 {contact.get('number')}")
                print(f"   {contact.get('label')}\n")
            elif "source_section" in contact:
                print(f"📋 {contact.get('source_section')}")
                content = contact.get("content", "")
                if content:
                    # Show first 150 chars of content
                    preview = content[:150].replace("\n", " ")
                    print(f"   {preview}...\n")

    # Step 5: Get legal text references
    print_section("STEP 5: Extract Legal Text References")
    legal_response = client.get_legal_texts_cyberbullying()
    
    if legal_response.get("status") == "success":
        legal_refs = legal_response.get("data", {}).get("legal_references", [])
        print(f"Legal references ({len(legal_refs)} found):\n")
        
        for i, ref in enumerate(legal_refs, 1):
            print(f"{i}. {ref}")

    # Step 6: Fetch details for one of the search results
    if fiche_ids_to_fetch:
        print_section(f"STEP 6: Get Detailed Information for First Search Result (ID: {fiche_ids_to_fetch[0]})")
        detail_response = client.get_fiche_by_id(fiche_ids_to_fetch[0])
        
        if detail_response.get("status") == "success":
            detail_data = detail_response.get("data", {})
            print(f"Title: {detail_data.get('title')}")
            print(f"ID: {detail_data.get('id')}")
            
            sections = detail_data.get("sections", [])
            if sections:
                print(f"\nFirst section from this document:")
                first_section = sections[0]
                print(f"  Title: {first_section.get('title')}")
                content_preview = first_section.get("content", "")[:200]
                print(f"  Content: {content_preview}...")


if __name__ == "__main__":
    main()