Public statistics API · v1

WordPress, by the numbers.

Explore collected WordPress download counters through a small, read-only JSON API. No API key required.

BASE URLhttps://api.wpcentral.io/api/v1

Start here

Make your first request

List tracked releases, ordered by version from newest to oldest.

REQUEST

curl 'https://api.wpcentral.io/api/v1/releases'

“Tracked” means a release has stored download observations. The newest tracked release is not an independently verified current-release flag.

Four endpoints. Plain JSON.

Available endpoints

Service health

Checks that the API process is responding. Does not test database availability.

GET/health

EXAMPLE RESPONSE

{
  "data": { "status": "ok" }
}

Open health response ↗

Tracked releases

Version identifiers and their first and last recorded observation timestamps.

GET/releases

ILLUSTRATIVE RESPONSE · ABBREVIATED

{
  "data": [{
    "version": "6.8",
    "first_observed_at": "2025-04-15T16:13:01Z",
    "last_observed_at": "2025-12-02T20:13:01Z"
  }],
  "meta": {
    "timezone": "UTC",
    "release_source": "download_observations"
  }
}

Download summary

The latest valid cumulative counter for a tracked release, with its observation time.

GET/releases/{version}/downloads/summary

REQUEST

curl 'https://api.wpcentral.io/api/v1/releases/6.8/downloads/summary'

Download history

Daily closing observations and changes between adjacent observed days.

GET/releases/{version}/downloads/history

REQUEST

curl 'https://api.wpcentral.io/api/v1/releases/6.8/downloads/history?from=2025-04-16&to=2025-04-30&interval=day'

Read the data correctly

History and observation quality

The date range is inclusive, uses UTC, and supports up to 366 days per request. Without dates, history covers the last 30 days including today. Only interval=day is supported.

History point status values
Status	Meaning
observed	Adjacent days have valid closing observations. The delta can be zero.
missing	No valid observation for this day. Counts and deltas are null.
no_baseline	A counter exists, but there is no earlier valid observation. Delta is null.
gap	The previous observation is older than the preceding UTC day. Delta is null.
counter_reset	The cumulative counter decreased between adjacent observed days. Delta is null.

cumulative_downloads is the observed counter, not an independently verified lifetime total.
downloads_since_previous_observation covers the actual observation interval, not exact midnight-to-midnight totals. Today is partial.
Zero counters after a release’s first positive observation are excluded. Genuine launch zeros remain valid. After a missing day, recovery is a gap rather than a daily spike.
Missing values stay null. Never treat them as zero downloads.

Responses & errors

Success responses use data and usually meta. Errors use error.code and error.message.

{
  "error": {
    "code": "release_not_found",
    "message": "No observations exist for this release."
  }
}

400 — invalid parameters
404 — unknown endpoint or release
405 — unsupported method
503 — service unavailable; retry later

Time, caching & browser access

Timestamps are UTC, formatted as ISO 8601.
Data responses advertise a 60-second cache lifetime. Errors and health responses are not cached.
GET and HEAD are supported. There are no public write endpoints.
Browser CORS access is currently allowed from https://wpcentral.io https://www.wpcentral.io, and https://new.wpcentral.io.
The OpenAPI specification includes the full response schemas.

Download the specification ↗