Welcome to ScamDB API

Use this API to report and look up scams, fraud entities, and more.

🔍 /lookup

Query scam reports by entity type and value.

GET /lookup
Headers: Authorization: Bearer <API_KEY>
Parameters:
type (email,ip,domain,wallet,sm-profile)
value (ex. [email protected]

Example URL:
GET /[email protected]
    

Response (JSON):

{
    "entity": {
        "id": 248,
        "domain_name": "test.com",
        "created_at": "2025-05-31T21:13:15"
    },
    "reports": [],
    "sources": [
        {
            "source": "https://www.fma.govt.nz/library/warnings-and-alerts/",
            "verified": 1,
            "verified_at": "2025-05-31T21:13:15"
        }
    ]
}		  
		  

📩 /submit

Submit a scam report to the system.

POST /submit
Content-Type: application/json
Headers: Authorization: Bearer <API_KEY>
{
  "description": "Scammer posing as delivery service",
  "reporter_email": "[email protected]",
  "email": "[email protected]",
  "wallet": "0x123456789012346765754",
  "wallet_type": "ETH",
  "domain": "paypal-support.com",
  "ip": "11.22.33.444",
}

Response (JSON):

{
    "status":"ok",
	"report_id":21,
	"usage_remaining":713
}	  
		  

💳 /purchase

Generate an API key (proof of concept).

POST /purchase
{
  "email": "[email protected]"
}

Response (JSON):

{
    "status": "ok",
    "email": "[email protected]",
    "api_key": "7123fef0040f21211af1400bef096ab1"
}	  
		  

🔐 Authentication

Pass the API key in the Authorization header for paid access.

Authorization: Bearer YOUR_API_KEY

Free users may access with limitations, without an API key.