Skip to main content
Returns the top 10 client domains ranked by the number of email conversations within the given date range. The endpoint counts how many new emails came from each domain. Results are sorted by descending frequency (highest first).

Request

Headers

Path Parameters

Parameter Format

  • Format: YYYY-MM-DD (ISO 8601 date)
  • Timezone: UTC
  • Default: Last 7 days if not provided

Response

200 OK - Successfully retrieved top client domains

400 Bad Request

401 Unauthorized

500 Internal Server Error

Example

Data Fields Explained

Top Clients Array

Analysis Examples

Market Share Analysis

Domain Type Classification

Trend Analysis

Use Cases

  • Client Segmentation: Understand client base composition
  • Market Analysis: Identify dominant email providers
  • Resource Planning: Allocate resources based on client volume
  • Partnership Opportunities: Identify potential email provider partnerships
  • Security Analysis: Monitor unusual domain patterns

Visualization Examples

Pie Chart

Bar Chart

Best Practices

  1. Regular Monitoring: Track top domains weekly or monthly
  2. Trend Analysis: Compare with previous periods
  3. Domain Classification: Group domains by type for analysis
  4. Anomaly Detection: Monitor for unusual domain patterns
  5. Integration: Combine with other client metrics

Performance Considerations

  • Caching: Results cached for 15 minutes by default
  • Date Range: Larger ranges may take longer to process
  • Data Volume: Top 10 provides focused view while managing performance
  • Use /email-meter/stats/clients/incoming-trends for domain-specific trends
  • Use /email-meter/stats/clients/response-times for domain performance analysis
  • Use /email-meter/stats/clients/lowest-resolved for problem domain identification

Notes

  • Only domains with at least one conversation are included
  • Counts are based on new email conversations started
  • Internal domains may be excluded based on configuration
  • Data is updated in real-time as new emails are processed
  • Subdomains are counted separately from parent domains