{
    "title": "RansomFeed API",
    "description": "Questa API restituisce dati relativi agli attacchi ransomware monitorati da RansomFeed.",
    "base_url": "https:\/\/api.ransomfeed.it",
    "method": "GET",
    "default_limit": 100,
    "max_limit": 1000,
    "endpoints": {
        "base": {
            "description": "Endpoint base per recuperare i dati delle rivendicazioni",
            "filters": [
                {
                    "name": "country",
                    "type": "path",
                    "description": "Filtra i dati per nazione della vittima. Spazi supportati: URL-encoding (%20), plus (+) o virgolette.",
                    "example": "\/country\/New%20Zealand"
                },
                {
                    "name": "gang",
                    "type": "path",
                    "description": "Filtra i dati per gruppo ransomware. Spazi supportati come sopra.",
                    "example": "\/gang\/black%20 basta"
                },
                {
                    "name": "date",
                    "type": "path",
                    "description": "Filtra per anno dell'attacco (es. 2025).",
                    "example": "\/date\/2025"
                },
                {
                    "name": "search",
                    "type": "path",
                    "description": "Cerca nei campi testuali (victim, description, city, region, work_sector).",
                    "example": "\/search\/hospital"
                },
                {
                    "name": "offset",
                    "type": "path",
                    "description": "Numero massimo di righe da restituire (default 100, max 1000).",
                    "example": "\/offset\/200"
                }
            ]
        },
        "stats": {
            "description": "Statistiche generali delle rivendicazioni",
            "endpoints": {
                "\/stats": "Statistiche generali (totali, anno corrente, mese, ultimi 7 giorni, oggi, gang attive, paesi colpiti)",
                "\/stats\/months": "Statistiche mensili per anno corrente e precedente",
                "\/stats\/months\/country\/{country}": "Statistiche mensili filtrate per paese",
                "\/stats\/months\/gang\/{gang}": "Statistiche mensili filtrate per gang",
                "\/stats\/gangs": "Statistiche per ogni gang (totale, anno corrente, anno precedente)",
                "\/stats\/gangs\/{gang}": "Statistiche per gang specifica",
                "\/stats\/countries": "Statistiche per ogni paese (totale, anno corrente, anno precedente)",
                "\/stats\/countries\/{country}": "Statistiche per paese specifico",
                "\/stats\/sectors": "Statistiche per ogni settore lavorativo (totale, anno corrente, anno precedente)",
                "\/stats\/sector\/country\/{country}": "Statistiche settori filtrate per paese",
                "\/stats\/sector\/gang\/{gang}": "Statistiche settori filtrate per gang"
            }
        },
        "lists": {
            "description": "Liste ordinate alfabeticamente di valori disponibili",
            "endpoints": {
                "\/list\/country": "Lista di tutti i paesi disponibili",
                "\/list\/gang": "Lista di tutte le gang disponibili",
                "\/list\/sector": "Lista di tutti i settori lavorativi disponibili"
            }
        },
        "info": {
            "description": "Informazioni sui threat actors",
            "endpoints": {
                "\/ganginfo\/{gang}": "Informazioni dettagliate su una gang specifica",
                "\/ta\/{gang}": "Alias per \/ganginfo\/{gang}"
            }
        }
    },
    "combinazioni_supportate": [
        "\/country\/Italy\/offset\/200",
        "\/gang\/blackbasta\/date\/2024",
        "\/date\/2025\/country\/Germany\/offset\/300",
        "\/search\/hospital\/country\/USA",
        "\/search\/healthcare\/gang\/lockbit3"
    ],
    "note": "Tutti i risultati sono ordinati per data decrescente. I filtri possono essere combinati liberamente, tranne offset che controlla solo il numero massimo di righe restituite. Tutti gli endpoint statistici rispettano le condizioni di default (id_parent = 0, admin_notes <> 'NC')."
}