Your GET endpoint for domain stats

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>"
    }
  ]
}

GET

leaks

stats

domain

Your GET endpoint for domain stats

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

Parameter	Type	Description
`domain`	string	Required. The domain to get leak statistics for
`unmask_email`	boolean	Whether 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

leak_devices_count

DevicesCount · object[]

Show child attributes

leak_devices_count.devices

number

leak_customers_count

CustomersCount · object[]

Show child attributes

leak_customers_count.customers

number

leak_user_count

UsersCount · object[]

Show child attributes

leak_user_count.user

number

leak_employees_count

EmployeesCount · object[]

Show child attributes

leak_employees_count.employees

number

combolist_exposure

CombolistExposureCount · object[]

Show child attributes

combolist_exposure.combolist_exposure

number

leak_country_stats

LeakCountryStats · object[]

Show child attributes

leak_country_stats.Country

string

leak_country_stats.CredentialsCount

number

top_used_urls_by_customers

UsedUrlsCount · object[]

Show child attributes

top_used_urls_by_customers.count

number

top_used_urls_by_customers.url

string

top_used_urls_by_employees

UsedUrlsCount · object[]

Show child attributes

top_used_urls_by_employees.count

number

top_used_urls_by_employees.url

string

top_used_urls_by_user

UsedUrlsCount · object[]

Show child attributes

top_used_urls_by_user.count

number

top_used_urls_by_user.url

string

leak_customers_timeline

LeaksTimeline · object[]

Show child attributes

leak_customers_timeline.CredentialsCount

number

leak_customers_timeline.Month

number

leak_customers_timeline.Year

number

leak_user_timeline

LeaksTimeline · object[]

Show child attributes

leak_user_timeline.CredentialsCount

number

leak_user_timeline.Month

number

leak_user_timeline.Year

number

leak_employees_timeline

LeaksTimeline · object[]

Show child attributes

leak_employees_timeline.CredentialsCount

number

leak_employees_timeline.Month

number

leak_employees_timeline.Year

number

customers_sample_data

LeaksUsersSampleData · object[]

Show child attributes

customers_sample_data.password

string

customers_sample_data.username

string

customers_sample_data.url

string

customers_sample_data.country

string

customers_sample_data.log_date

string

employees_sample_data

LeaksUsersSampleData · object[]

Show child attributes

employees_sample_data.password

string

employees_sample_data.username

string

employees_sample_data.url

string

employees_sample_data.country

string

employees_sample_data.log_date

string

user_sample_data

LeaksUsersSampleData · object[]

Show child attributes

user_sample_data.password

string

user_sample_data.username

string

user_sample_data.url

string

user_sample_data.country

string

user_sample_data.log_date

string

Your POST endpoint Your GET endpoint for email stats

⌘I

API Reference

​Overview

​Query Parameters

​Response Structure

​Usage Examples

​Get basic domain stats

​Get stats with unmasked emails

​Best Practices

​Regular Monitoring

​Performance Considerations

Authorizations

Query Parameters

Response

Overview

Query Parameters

Response Structure

Usage Examples

Get basic domain stats

Get stats with unmasked emails

Best Practices

Regular Monitoring

Performance Considerations