Thomas' Alkimi Publisher API documentation

This API provides access to the daily publisher count for Alkimi Exchange.

Endpoint

https://worm.me/api/publisher_api.php

Method

GET or POST

Parameters

Response Formats

HTML (format=html)

Returns an HTML table containing the date and total results for each day in the specified range.

GET /publisher_api.php?from-date=2025-03-05&to-date=2025-03-07&format=html

JSON (format=json)

Returns a JSON array of objects, where each object represents a day's data with date and total_results properties.

GET /publisher_api.php?format=json&from-date=2025-03-05

[
  {
    "date": "2025-03-05",
    "total_results": 1234
  },
  {
    "date": "2025-03-06",
    "total_results": 5678
  },
  {
    "date": "2025-03-07",
    "total_results": 9012
  }
]

CSV (format=csv)

Returns a CSV (Comma Separated Values) file with headers date and total_results. The response will be sent as a file download.

GET /publisher_api.php?format=csv

date,total_results
2025-03-05,1234
2025-03-06,5678
2025-03-07,9012

Error Handling

The API may return the following HTTP status codes:

• 200 OK: Successful request.
• 400 Bad Request: Invalid request parameters (e.g., invalid date format, invalid format option). An error message will be included in the response body.
• 500 Internal Server Error: An error occurred on the server (e.g., database connection error, query error). An error message *may* be included, but for security, detailed error messages should be logged on the server, not returned to the client.

Example form

A simple form is provided to interact with this API. The form is available at publisher_count_form.php

Notes

• Dates are in YYYY-MM-DD format.
• The timezone for dates is GMT.
• The API is read-only; it does not support creating, updating, or deleting data.
• If no data is found for the specified date range, an empty HTML table, an empty JSON array (`[]`), or an empty string(for CSV) will be returned.