Content Freshness

What It Does

Extracts dates from Last-Modified headers, article:published_time, article:modified_time, og:updated_time, og:published_time, meta name="date", meta name="revised", meta http-equiv="last-modified", JSON-LD (datePublished, dateModified, dateCreated), HTML <time> elements, URL path date patterns, and visible text patterns. Analyzes Cache-Control directives (max-age, s-maxage, no-cache, no-store, stale-while-revalidate), ETag presence, Age header, Expires header, and CDN cache indicators. Cross-validates dates across sources for consistency and assigns a confidence level (high/medium/low/none) based on signal agreement.

Why It's Useful

Content freshness is a ranking factor for search engines, especially for news and time-sensitive queries (Google's QDF algorithm). AI assistants cite content that is 25% fresher on average than organic search results. This endpoint helps identify stale content, validate date metadata accuracy across sources, audit cache configuration, and prioritize content refresh efforts based on actual freshness data and signal confidence.

Use Cases

Parameters

Response Fields

Code Examples

curl "https://api.edgedns.dev/v1/domain/content-freshness" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "domain=example.com"

const response = await fetch(
  'https://api.edgedns.dev/v1/domain/content-freshness?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/content-freshness',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={
    'domain': 'example.com'
    }
)

data = response.json()
print(data)

Related Endpoints

External References

Learn more about the standards and protocols behind this endpoint.