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
- Regular Monitoring: Track top domains weekly or monthly
- Trend Analysis: Compare with previous periods
- Domain Classification: Group domains by type for analysis
- Anomaly Detection: Monitor for unusual domain patterns
- 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
Related Endpoints
- Use
/email-meter/stats/clients/incoming-trendsfor domain-specific trends - Use
/email-meter/stats/clients/response-timesfor domain performance analysis - Use
/email-meter/stats/clients/lowest-resolvedfor 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