Places

Check-in stats

GET https://api.rewind.rest/v1/places/stats

Returns aggregate check-in statistics: total check-ins, unique venues, this-year count, top categories, top cities, and top venues. Optional date/from/to params scope every aggregation to the range except this_year, which always counts the current UTC year.

Authorization

Authorizationheaderstringrequired

API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.

Query Parameters

datequerystring

Single day (YYYY-MM-DD). Overrides from/to.

fromquerystring

Range start, inclusive (ISO 8601)

toquerystring

Range end, inclusive (ISO 8601)

Response

application/json

Check-in statistics

totalnumberrequired

unique_venuesnumberrequired

this_yearnumberrequired

top_categoriesarray of objectrequired

properties

top_citiesarray of objectrequired

properties

top_venuesarray of objectrequired

properties

cURL

curl -X GET 'https://api.rewind.rest/v1/places/stats' \
  -H 'Authorization: Bearer <token>'

200

{
  "total": 0,
  "unique_venues": 0,
  "this_year": 0,
  "top_categories": [
    {
      "category": "string",
      "count": 0,
      "icon": "string"
    }
  ],
  "top_cities": [
    {
      "city": "string",
      "count": 0
    }
  ],
  "top_venues": [
    {
      "venue_name": "string",
      "count": 0,
      "icon": "string",
      "city": "string"
    }
  ]
}