"Best analytics tool I've used in 14 years"

Get realtime visitors

GET https://datafa.st/api/v1/analytics/realtime

Return the current active visitor count.

Request

Authentication

  • df_ website API key for one website.
  • dft_ account token with analytics:read. Pass websiteId as a query parameter.

Query parameters

ParameterTypeRequiredDescription
fieldsstringNoControls which realtime metric is returned. Possible values: visitors. Example: fields=visitors.

Response

Returns a JSON object with status and endpoint-specific fields.

Response fields

FieldTypeDescription
data[].visitorsnumberNumber of visitors active in the realtime window. Use it for live counters or status widgets.

Errors

Common errors include 400 for invalid input, 401 for missing or invalid tokens, 403 for missing permission or suspended tracking, 404 for missing resources, and 500 for server errors.

✍️ Something missing? Suggest features.

🤖 AI agent or LLM? Read this page as markdown

Example request
curl -X GET "https://datafa.st/api/v1/analytics/realtime" \
  -H "Authorization: Bearer df_xxx"
Success response
{
  "status": "success",
  "data": [{
    "visitors": 42
  }]
}