Response Time
free/v1/domain/response-timeMeasures the time to first byte (TTFB) and total response time for a domain. Provides latency breakdown including DNS, TCP connect, TLS handshake, and server processing time.
What It Does
Performs timed HTTP requests and breaks down latency into components: DNS resolution, TCP connection establishment, TLS handshake, time to first byte, and total content transfer time.
Why It's Useful
Response time directly impacts user experience and SEO rankings. Understanding the latency breakdown helps identify bottlenecks in DNS, TLS, or server processing.
Use Cases
Performance Monitoring
Monitor server response times to detect performance degradation.
Identify performance issues before they impact users.
Bottleneck Analysis
Analyze latency breakdown to identify whether issues are in DNS, TLS, or server processing.
Focus optimization efforts on the right component.
Competitive Benchmarking
Compare response times against competitors to benchmark performance.
Set performance targets based on competitive landscape.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
domain | string | Required | The domain to measure response time forExample: example.com |
samples | number | Optional | Number of measurement samples (1-5, default: 3)Example: 3 |
Response Fields
| Field | Type | Description |
|---|---|---|
domain | string | The queried domain |
samples | number | Number of measurement samples taken |
timing | object | Aggregate timing stats (min, max, avg, median, p90, p99) in ms |
individual | array | Individual sample measurements (totalMs, ttfbMs) |
status | string | Performance rating: fast, acceptable, or slow |
statusDescription | string | Human-readable performance description |
recommendations | array | Performance improvement suggestions |
Code Examples
curl "https://api.edgedns.dev/v1/domain/response-time" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d "domain=example.com"const response = await fetch(
'https://api.edgedns.dev/v1/domain/response-time?domain=example.com',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);import requests
response = requests.get(
'https://api.edgedns.dev/v1/domain/response-time',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={
'domain': 'example.com'
}
)
data = response.json()
print(data)Read the full Response Time guide
Why it matters, real-world use cases, parameters, response fields, and how to call it from Claude, ChatGPT, or Gemini via MCP.
Read the guide →Related Endpoints
External References
Learn more about the standards and protocols behind this endpoint.
Try This Endpoint
Test the Response Time endpoint live in the playground.