API Dokumentation

v1.0

Integriere Scammyfy-Daten in deine App, Browser-Extension oder dein Sicherheits-Tool.
GET-Endpunkte sind öffentlich. POST benötigt einen API-Key.

Base URL

https://scammyfy.de/api/v1

Antwortformat

{
  "success": true,
  "timestamp": "2026-03-29T12:00:00.000Z",
  "data": { ... },
  "pagination": { "page": 1, "limit": 20, "total": 35, "totalPages": 2 }
}

🔑 Authentifizierung

POST-Endpunkte erfordern einen API-Key. Diesen per E-Mail anfragen:kontakt@scammyfy.de

Authorization: Bearer scfy_...
# oder
X-API-Key: scfy_...

Endpunkte

GET/api/v1/reports

Liste aller genehmigten Scam-Meldungen

Parameter
pageSeite (default: 1)
limitEinträge pro Seite (max: 100, default: 20)
categoryFilter: phishing, fake-shop, krypto, ...
qVolltextsuche (min. 3 Zeichen)
Beispiel
curl https://scammyfy.de/api/v1/reports?limit=5&category=phishing
GET/api/v1/reports/:id

Einzelne Meldung abrufen

Parameter
idID der Meldung
Beispiel
curl https://scammyfy.de/api/v1/reports/42
GET/api/v1/check

Smart-Check: Domain, URL, Telefon, IBAN oder Wallet prüfen. Erkennt den Typ automatisch.

Parameter
qZu prüfender Wert (min. 2 Zeichen)
Beispiel
curl "https://scammyfy.de/api/v1/check?q=dpd-paket.de"
GET/api/v1/stats

Statistiken über alle Meldungen

Beispiel
curl https://scammyfy.de/api/v1/stats
POST/api/v1/reports🔑 API-Key

Neue Scam-Meldung einreichen (API-Key erforderlich). Meldung geht in Prüfung.

Parameter
titleTitel der Meldung (Pflicht)
categoryKategorie (Pflicht): phishing, fake-shop, investment, romance, telefon, job-betrug, krypto, erpressung, paket, inkasso, sonstiges
descriptionBeschreibung min. 50 Zeichen (Pflicht)
scam_urlURL des Scammers (optional)
scam_phoneTelefonnummer (optional)
scam_emailE-Mail (optional)
scam_nameName / Firma (optional)
evidenceBeweise / Links (optional)
Beispiel
curl -X POST https://scammyfy.de/api/v1/reports   -H "Authorization: Bearer scfy_..."   -H "Content-Type: application/json"   -d '{
    "title": "Fake DPD Shop",
    "category": "phishing",
    "description": "Diese Website gibt vor DPD zu sein und fordert Zahlungsdaten an.",
    "scam_url": "https://dpd-fake.com"
  }'

Rate Limiting

GET (öffentlich)100 Requests / Stunde / IP
POST (mit Key)500 Requests / Stunde / Key

API-Key anfragen

Schreib uns mit deinem Use-Case – API-Keys sind kostenlos.

API-Key anfragen