WordPress APIwordpress.org ↗

"""Walkthrough: WordPress.org Statistics SDK — version adoption and ecosystem health."""
from parse_apis.wordpress.org_statistics_api import WordPressStats, UpstreamError

client = WordPressStats()

# Fetch WordPress version distribution — single call, typed result.
wp = client.distributions.wordpress()
print(f"WordPress stats source: {wp.source}")
for version, pct in sorted(wp.data.items(), key=lambda x: x[1], reverse=True)[:5]:
    print(f"  WP {version}: {pct}%")

# Fetch PHP version distribution to assess security posture.
php = client.distributions.php()
print(f"\nPHP stats: {php.description}")
for version, pct in sorted(php.data.items(), key=lambda x: x[1], reverse=True)[:3]:
    print(f"  PHP {version}: {pct}%")

# Database distribution — MySQL vs MariaDB split.
db = client.distributions.mysql()
print(f"\nDatabase stats from: {db.source}")
for version, pct in sorted(db.data.items(), key=lambda x: x[1], reverse=True)[:3]:
    print(f"  {version}: {pct}%")

# Typed error handling on a real call.
try:
    locales = client.distributions.locales()
    print(f"\nLocales tracked: {len(locales.data)} languages")
    for lang, pct in sorted(locales.data.items(), key=lambda x: x[1], reverse=True)[:3]:
        print(f"  {lang}: {pct}%")
except UpstreamError as exc:
    print(f"Upstream error: {exc}")

# Aggregated call — all four distributions in one round-trip.
all_stats = client.distributions.all()
print(f"\nAggregated stats generated at: {all_stats.generated_at}")
print(f"  WP versions tracked: {len(all_stats.data.wordpress_versions)}")
print(f"  PHP versions tracked: {len(all_stats.data.php_versions)}")
print(f"  DB versions tracked: {len(all_stats.data.mysql_versions)}")
print(f"  Locales tracked: {len(all_stats.data.locales)}")

print("\nexercised: distributions.wordpress / .php / .mysql / .locales / .all")