Skip to main content
GET
/
v1
/
leaks
/
stats
/
domain
Get leak statistics for a domain
curl --request GET \
  --url https://api.projectdiscovery.io/v1/leaks/stats/domain \
  --header 'X-API-Key: <api-key>'
{
  "leak_devices_count": [
    {
      "devices": 123
    }
  ],
  "leak_customers_count": [
    {
      "customers": 123
    }
  ],
  "leak_user_count": [
    {
      "user": 123
    }
  ],
  "leak_employees_count": [
    {
      "employees": 123
    }
  ],
  "combolist_exposure": [
    {
      "combolist_exposure": 123
    }
  ],
  "leak_country_stats": [
    {
      "Country": "<string>",
      "CredentialsCount": 123
    }
  ],
  "top_used_urls_by_customers": [
    {
      "count": 123,
      "url": "<string>"
    }
  ],
  "top_used_urls_by_employees": [
    {
      "count": 123,
      "url": "<string>"
    }
  ],
  "top_used_urls_by_user": [
    {
      "count": 123,
      "url": "<string>"
    }
  ],
  "leak_customers_timeline": [
    {
      "CredentialsCount": 123,
      "Month": 123,
      "Year": 123
    }
  ],
  "leak_user_timeline": [
    {
      "CredentialsCount": 123,
      "Month": 123,
      "Year": 123
    }
  ],
  "leak_employees_timeline": [
    {
      "CredentialsCount": 123,
      "Month": 123,
      "Year": 123
    }
  ],
  "customers_sample_data": [
    {
      "password": "<string>",
      "username": "<string>",
      "url": "<string>",
      "country": "<string>",
      "log_date": "<string>"
    }
  ],
  "employees_sample_data": [
    {
      "password": "<string>",
      "username": "<string>",
      "url": "<string>",
      "country": "<string>",
      "log_date": "<string>"
    }
  ],
  "user_sample_data": [
    {
      "password": "<string>",
      "username": "<string>",
      "url": "<string>",
      "country": "<string>",
      "log_date": "<string>"
    }
  ]
}

Overview

Get statistical information about leaks associated with a specific domain. This endpoint provides aggregate data for monitoring and reporting purposes.
This endpoint requires domain verification. You can only get stats for domains you have verified ownership of.

Query Parameters

ParameterTypeDescription
domainstringRequired. The domain to get leak statistics for
unmask_emailbooleanWhether to unmask email addresses in the response

Response Structure

The response provides comprehensive statistics about leaks for the specified domain:
{
  "domain": "example.com",
  "total_leaks": 150,
  "open_leaks": 120,
  "fixed_leaks": 30,
  "leak_types": {
    "employee_leaks": 100,
    "customer_leaks": 50
  },
  "recent_activity": {
    "last_30_days": 15,
    "last_7_days": 3
  },
  "top_services": [
    {
      "service": "facebook.com",
      "count": 45
    },
    {
      "service": "linkedin.com", 
      "count": 32
    }
  ],
  "geographic_distribution": [
    {
      "country": "United States",
      "count": 89
    },
    {
      "country": "Canada",
      "count": 23
    }
  ]
}

Usage Examples

Get basic domain stats

curl -X GET "https://api.projectdiscovery.io/v1/leaks/stats/domain?domain=example.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get stats with unmasked emails

curl -X GET "https://api.projectdiscovery.io/v1/leaks/stats/domain?domain=example.com&unmask_email=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Best Practices

Regular Monitoring

  • Check domain stats regularly to identify new leaks quickly
  • Set up automated alerts when leak counts increase
  • Monitor the ratio of open vs fixed leaks

Performance Considerations

  • Cache stats data appropriately to avoid excessive API calls
  • Use this endpoint for summary data, detailed leak info requires other endpoints
  • Consider rate limiting when building automated monitoring systems

Authorizations

X-API-Key
string
header
required

Query Parameters

domain
string
unmask_email
boolean

Response

OK

leak_devices_count
DevicesCount · object[]
leak_customers_count
CustomersCount · object[]
leak_user_count
UsersCount · object[]
leak_employees_count
EmployeesCount · object[]
combolist_exposure
CombolistExposureCount · object[]
leak_country_stats
LeakCountryStats · object[]
top_used_urls_by_customers
UsedUrlsCount · object[]
top_used_urls_by_employees
UsedUrlsCount · object[]
top_used_urls_by_user
UsedUrlsCount · object[]
leak_customers_timeline
LeaksTimeline · object[]
leak_user_timeline
LeaksTimeline · object[]
leak_employees_timeline
LeaksTimeline · object[]
customers_sample_data
LeaksUsersSampleData · object[]
employees_sample_data
LeaksUsersSampleData · object[]
user_sample_data
LeaksUsersSampleData · object[]