Authentication
All API requests require a valid API key passed via the X-API-Key header. Keys are generated from your account dashboard and are tied to your subscription tier.
curl -X GET "https://api.refty.wtf/v1/search" \
-H "X-API-Key: rfty_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json"
Endpoints
GET /v1/search
Execute a unified search across all accessible sources. Returns correlated results grouped by category.
{
"query": "example@email.com",
"sources": ["snusbase", "intelx", "dehashed"],
"limit": 50,
"offset": 0
}
GET /v1/sources
List all available intelligence sources with current status, record counts, and pricing.
GET /v1/sources
Response: {
"sources": [
{
"name": "Snusbase",
"status": "online",
"records": "1.4B+",
"type": "breach_data",
"price_tier": "premium"
}
]
}
POST /v1/correlate
Cross-reference a target across multiple sources and return a correlated intelligence profile.
POST /v1/correlate
{
"email": "target@example.com",
"include": ["breaches", "social", "darkweb", "financial"]
}
Response: {
"profile_id": "prof_abc123",
"confidence": 0.94,
"data_points": 47,
"sources_matched": 23
}
Rate Limiting
Rate limits are enforced per API key based on your subscription plan. Limits are reset hourly.
X-RateLimit-Limit: 1200
X-RateLimit-Remaining: 1147
X-RateLimit-Reset: 1640995200
Webhooks
Configure webhooks to receive real-time intelligence alerts when new data matches your monitored targets.
POST /v1/webhooks
{
"url": "https://your-server.com/webhook",
"events": ["breach_match", "darkweb_mention", "credential_leak"],
"targets": ["email@example.com", "username"]
}
SDKs & Libraries
Official client libraries for Python, JavaScript, Go, and Rust are in development.
pip install refty-sdk
from refty import ReftyClient
client = ReftyClient(api_key="rfty_live_xxxxxxxxxxxx")
results = client.search("target@example.com")