DeepSINT Enterprise API Specification

DeepSINT REST API Reference

Integra l'intelligence di DeepSINT direttamente nei tuoi SIEM, SOAR, script di automazione o bot di investigazione. Tutti gli endpoint rispondono in formato JSON standard, con cifratura TLS obbligatoria e latenze ottimizzate tramite indici locali in tempo reale.

BASE URL DI PRODUZIONE

https://deepsint.cc

FORMATO RICHIESTE

application/json

CODIFICA CARATTERI

UTF-8

Endpoint principali

Le stesse ricerche della console, richiamabili dalle tue macchine. Base URL https://deepsint.cc. La chiave si genera da Accesso API in console e resta valida finché l'account è attivo: ogni endpoint qui sotto accetta sia Authorization: Bearer sia X-API-Key.

Ricerca universale

POST/api/searchUna ricerca su un modulo per chiamata, rapida o approfondita.

Credenziali e dump

GET · POST/api/usernameNickname su piattaforme e database violati.
GET · POST/api/emailServizi su cui un indirizzo ha un account.
GET · POST/api/phoneOperatore, prefisso e record associati.

Gaming e social

GET · POST/api/discordProfilo, avatar, server pubblici e violazioni correlate a un ID.
GET · POST/api/minecraftSkin, storico nomi Mojang, UUID e leak correlati.
GET · POST/api/robloxProfilo, badge, inventario pubblico e credenziali compromesse.
GET · POST/api/fivemLicenza Rockstar, handle CFX e identificativi collegati.
GET · POST/api/steam-osintProfilo Steam pubblico, libreria visibile e storico nomi.

Registri e identità

GET · POST/api/italian-registriesVIES, catalogo PA di dati.gov.it e Wikidata su una Partita IVA.

Account, crediti e chiavi

GET/api/meAccount, stato, saldo crediti e storico delle ultime ricerche.
GET · POST/api/user/api-keyLegge la chiave attiva, oppure ne genera una nuova invalidando la precedente.

Limiti e quote dipendono dal piano: la tabella completa è in Piani e prezzi, e le regole applicate dal gateway sono nella sezione Rate limiting.

Autenticazione & API Keys

Ogni chiamata API deve essere autenticata tramite la tua chiave personale univoca fornita nella dashboard. DeepSINT supporta entrambi i metodi standard RFC:

Authorization: Bearer ds_live_tua_api_key

X-API-Key: ds_live_tua_api_key

Idoneità dei Piani per Accesso API:

Plus (€10/mese): Accesso API non incluso (solo interfaccia Web, 60 ricerche/giorno, 2 IP whitelist).
Premium (€20/mese): Accesso API abilitato (30 richieste/minuto per modulo), 160 ricerche/giorno, 3 IP whitelist.
Professional (€50/mese): Accesso API prioritario (30 richieste/minuto per modulo), 350 ricerche/giorno, 3 IP whitelist.
Enterprise (€60/mese): Accesso API illimitato (30 richieste/minuto per modulo), ricerche illimitate al giorno, 10 IP whitelist.
Owner: Ricerche, IP e crediti illimitati.

Esempio Rapido di Integrazione

POST /api/search (curl)

curl -X POST https://deepsint.cc/api/search \
  -H "Authorization: Bearer ds_live_tua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "module": "discord",
    "query": "1528074425163845672"
  }'

Endpoint: Username OSINT (Async)

Scansione cross-platform asincrona su 278+ moduli locali Python

POSTGEThttps://deepsint.cc/api/username

Async Engine · 1 Credito

Esegue in modo completamente asincrono la verifica dell'handle utente su oltre 278 moduli locali Python (social network, repository di codice, gaming, community e forum). Interamente elaborato in locale con pool asincrono ad alta velocità senza dipendenze API esterne.

PARAMETRI RICHIESTA

Parametro	Tipo	Obbligatorio	Descrizione
query	string	Sì	Nickname o handle utente (es. `"admin"`). Accetta anche `"username"`.

ESEMPIO DI CHIAMATA CURL

curl -X POST https://deepsint.cc/api/username \
  -H "Authorization: Bearer ds_live_tua_api_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "admin"}'

Endpoint: Email OSINT Accounts (Async)

Verifica registrazioni su 283+ piattaforme con Holehe & moduli dedicati

POSTGEThttps://deepsint.cc/api/email

Async Engine · 1 Credito

Verifica in parallelo asincrono se un indirizzo email è registrato su centinaia di servizi e piattaforme (Google, Microsoft, Apple, Amazon, Twitter/X, GitHub, ecc.), recuperando eventuali domini associati ed email o recapiti di recupero mascherati.

PARAMETRI RICHIESTA

Parametro	Tipo	Obbligatorio	Descrizione
query	string	Sì	Indirizzo email valido (es. `"[email protected]"`). Accetta anche `"email"`.

ESEMPIO DI CHIAMATA CURL

curl -X POST https://deepsint.cc/api/email \
  -H "Authorization: Bearer ds_live_tua_api_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "[email protected]"}'

Endpoint: Phone OSINT & Carrier (Async)

Risoluzione operatore, tipo linea e footprinting su 292+ moduli locali

POSTGEThttps://deepsint.cc/api/phone

Async Engine · 1 Credito

Esegue un'analisi telefonica asincrona basata su oltre 292 moduli Python locali per identificare operatore telefonico, carrier mobile, nazionalità prefisso, linea mobile/VoIP/fissa e verificare la presenza su app di messaggistica.

PARAMETRI RICHIESTA

Parametro	Tipo	Obbligatorio	Descrizione
query	string	Sì	Numero telefonico (es. `"+393331234567"`). Accetta anche `"phone"`.

ESEMPIO DI CHIAMATA CURL

curl -X POST https://deepsint.cc/api/phone \
  -H "Authorization: Bearer ds_live_tua_api_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "+393401234567"}'

Endpoint: Discord Profile & Leaks

POSTGEThttps://deepsint.cc/api/discord

1 Credito / Ricerca

Esegue un'indagine approfondita su un account Discord a partire dal suo Snowflake numerico. Correlazione istantanea con i database dei bot monitorati, cronologia dei messaggi, dati FiveM associati e log di violazioni dati.

PARAMETRI RICHIESTA (JSON BODY O QUERY STRING)

Parametro	Tipo	Obbligatorio	Descrizione
query	string / number	Sì	Snowflake Discord (17-20 cifre numeriche). Accetta anche `"id"` o `"discord_id"`.

ESEMPIO DI CHIAMATA CURL

curl -X POST https://deepsint.cc/api/discord \
  -H "Authorization: Bearer ds_live_tua_api_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "1528074425163845672"}'

Endpoint: Minecraft & Leaks

POSTGEThttps://deepsint.cc/api/minecraft

1 Credito / Ricerca

Recupera identità Minecraft, UUID ufficiale Mojang, texture della skin 3D e verifica presenze in database di violazioni e stealer logs storici.

PARAMETRI RICHIESTA

Parametro	Tipo	Obbligatorio	Descrizione
query	string	Sì	Nickname Minecraft (3-16 caratteri) oppure UUID standard (con o senza trattini). Accetta anche `"username"` o `"uuid"`.

ESEMPIO DI CHIAMATA CURL

curl -X POST https://deepsint.cc/api/minecraft \
  -H "Authorization: Bearer ds_live_tua_api_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "Notch"}'

Endpoint: Roblox Profile & Intel

POSTGEThttps://deepsint.cc/api/roblox

1 Credito / Ricerca

Estrae profilo Roblox, User ID numerico, data di iscrizione, gruppi di appartenenza e scansione delle combo breach collegate.

PARAMETRI RICHIESTA

Parametro	Tipo	Obbligatorio	Descrizione
query	string / number	Sì	Username Roblox o ID utente numerico. Accetta anche `"username"` o `"id"`.

ESEMPIO DI CHIAMATA CURL

curl -X POST https://deepsint.cc/api/roblox \
  -H "Authorization: Bearer ds_live_tua_api_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "Builderman"}'

Endpoint: Ricerca OSINT Universale

POSThttps://deepsint.cc/api/search

1 Credito / Ricerca

PARAMETRI DEL CORPO JSON (REQUEST BODY)

Parametro	Tipo	Obbligatorio	Descrizione
module	string	Sì	Identificatore del modulo target. Uno tra: `"username"`, `"email"`, `"phone"`, `"discord"`, `"breach"`, `"fivem"`, `"ip"`, `"domain"`, `"roblox"`, `"minecraft"`
query	string	Sì	Valore target da ricercare (handle username, email, numero telefonico E.164, Snowflake Discord, IP, licenza FiveM, ecc.).

FORMATO QUERY PER MODULO

module: "username" (Async Modules)

Handle o nickname (min. 2 caratteri). Esegue in modo asincrono ultra-rapido oltre 278 moduli locali Python (social, repo, forum, profili pubblici, gaming). Nessuna dipendenza esterna.

module: "email" (Async Modules)

Indirizzo email valido (es. [email protected]). Scansione asincrona parallela su 283+ moduli locali ed engine Holehe (Google, Microsoft, Apple, Amazon, Twitter, GitHub, email di recupero e telefoni mascherati).

module: "phone" (Async Modules)

Numero telefonico internazionale in formato E.164 (es. +393331234567) o nazionale. Esegue 292+ moduli locali Python (carrier, operatore, tipo linea e footprinting).

module: "discord"

Snowflake Discord da 17 a 20 cifre numeriche. Es: "1528074425163845672". Restituisce creazione, avatar, decorazione, banner, cronologia nomi e dump FiveM.

module: "breach"

Indirizzo email valido o username. Cerca in oltre 14 miliardi di record di combo leaks, stealer logs e dump pubblici.

module: "intelx"

Selettore Intelligence X: email, username, dominio, telefono o IP. Riservato ai piani Premium e superiori, con un massimo di 10 ricerche IntelX al giorno. Ogni record riporta bucket e nome dell'archivio di origine.

module: "fivem"

Licenza Rockstar (license:...), Steam Hex (steam:11000...), IP o nome giocatore.

module: "ip"

Indirizzo IPv4 o IPv6 valido. Es: 1.1.1.1. Restituisce ASN, geolocalizzazione e minacce.

module: "domain"

Nome a dominio valido (es. azienda.com). Restituisce record DNS, WHOIS e threat intel.

ESEMPIO DI RISPOSTA DISCORD (200 OK)

{
  "result": {
    "shape": "discord",
    "module": "discord",
    "query": "1528074425163845672",
    "status": "matched",
    "snowflake": {
      "id": "1528074425163845672",
      "createdAt": "2024-04-12T08:14:22.000Z",
      "ageDays": 887,
      "workerId": 1,
      "processId": 0,
      "increment": 248
    },
    "identity": {
      "username": "tg.consapevolezza",
      "globalName": "Consapevolezza",
      "discriminator": "0",
      "tag": "@tg.consapevolezza",
      "bot": false,
      "system": false
    },
    "avatar": {
      "url": "https://cdn.discordapp.com/avatars/1528074425163845672/0b281a8767f3f9843208dea385861092.png?size=256",
      "animated": false,
      "isDefault": false
    },
    "avatarDecoration": {
      "asset": "a_a19b7e105ab06eb1f366a3db6d5651fa",
      "url": "https://cdn.discordapp.com/avatar-decoration-presets/a_a19b7e105ab06eb1f366a3db6d5651fa.png?size=240&passthrough=true"
    },
    "banner": null,
    "bannerColor": null,
    "accentColor": "#5865f2",
    "badges": [],
    "attributes": [
      {
        "title": "Presenza Server Bot (4 server attivi)",
        "fields": [
          { "key": "Server", "value": "/stockcord, deepsint.cc, Community Hub" },
          { "key": "Messaggi Intercettati", "value": "100 messaggi recenti" }
        ]
      }
    ],
    "breach": {
      "total": 0,
      "sources": [],
      "exposedFields": []
    },
    "layers": [
      { "id": "snowflake", "label": "Snowflake", "ok": true },
      { "id": "discord-api", "label": "Discord API", "ok": true },
      { "id": "bot-db", "label": "Bot Locale", "ok": true, "detail": "100 messaggi, 1 username history" }
    ]
  },
  "creditsRemaining": 499,
  "unlimited": false
}

Altri Endpoint Disponibili

GET/api/user/api-key

Restituisce la chiave API attiva dell'utente corrente, il saldo crediti rimanente e lo stato illimitato.

{
  "apiKey": "ds_live_abcdef123...",
  "role": "PRO",
  "credits": 450,
  "unlimited": false
}

POST/api/user/api-key

Rigenera istantaneamente una nuova API Key. La chiave precedente viene immediatamente invalidata.

{
  "apiKey": "ds_live_newkey456...",
  "role": "PRO",
  "message": "Nuova API key generata con successo."
}

GET/api/me

Restituisce le informazioni sull'account (ID, email, ruolo, stato account, storico ultime ricerche eseguite).

GET/api/search

Restituisce l'elenco dinamico dei moduli di ricerca attualmente abilitati sulla piattaforma.

GETPOST/api/fivem

Licenza Rockstar o handle CFX: server di gioco, identificativi collegati e leak della community. Costo: 1 credito.

{
  "status": "success",
  "module": "fivem",
  "query": "license:e6594ce98095bb0cfa71e697f294da47aa9bd04f",
  "creditsRemaining": 449,
  "unlimited": false
}

GETPOST/api/steam-osint

Profilo Steam pubblico, libreria visibile, amici e storico dei nomi. Parametri accettati: query, steamid o id.

{
  "status": "success",
  "query": "76561197960287930",
  "result": { "profile": { "personaName": "..." } }
}

GETPOST/api/italian-registries

Una Partita IVA su tre fonti ufficiali: VIES, catalogo PA di dati.gov.it e Wikidata. Corpo JSON: { "kind": "vat" | "ckan" | "wikidata", "query": "00159560366" }.

{
  "result": {
    "source": "vies",
    "label": "VIES · Partita IVA",
    "status": "clean",
    "query": "00159560366",
    "fields": []
  }
}

Interactive API Playground

Testa gli endpoint API in tempo reale (inclusi i moduli dedicati /api/discord, /api/minecraft, /api/roblox). Inserisci la tua API Key (oppure esegui la prova autenticato con la tua sessione browser).

API Key (Opzionale se connesso via Web)

Endpoint Target

Query di Ricerca

Codici di Risposta & Errori

Codice	Nome	Significato & Azione Consigliata	Costo Credito
200	OK	Ricerca completata con successo. Il payload contiene il corpo del risultato.	1 Credito speso
400	Bad Request	Parametri mancanti o formato query non valido per il modulo scelto.	0 Crediti (Non addebitato)
401	Unauthorized	API Key non fornita, errata o revocata. Generane una nuova nella console.	0 Crediti
402	Payment Required	Crediti del piano esauriti. Ricarica i crediti o effettua l'upgrade di piano.	0 Crediti
403	Forbidden	Account sospeso, congelato o piano non idoneo (richiesto piano Pro o superiore).	0 Crediti
429	Too Many Requests	Limite di frequenza superato (30 req/min). Consulta l'header `Retry-After`.	0 Crediti
502	Bad Gateway	Indice o provider non raggiungibile. DeepSINT effettua il rimborso automatico del credito.	Rimborsato automaticamente

Sicurezza & Rate Limiting

Per proteggere la stabilità del servizio e garantire tempi di risposta inferiori a 1 secondo per tutti gli utenti, sono applicate le seguenti regole:

Rate Limit Standard:

Fino a 30 richieste al minuto per singola chiave API. Su piani Enterprise e Owner è possibile richiedere limiti dedicati ad alto throughput.

Protezione Credenziali:

Non esporre mai la tua chiave API in applicazioni frontend o repository pubblici. Esegui sempre le chiamate da server sicuri o funzioni serverless.