Admin

Trigger Last.fm sync

POST https://api.rewind.rest/v1/admin/sync/listening

Manually trigger a Last.fm listening sync. Supports scrobbles, top_lists, stats, full, and backfill sync types.

Authorization

Authorizationheaderstringrequired

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

Body

typebodyenum (string)

Allowed valuesscrobblestop_listsstatsfullbackfillartist_tagsartist_biosartist_similar

Response

application/json

Sync completed successfully

statusenum (string)required

Allowed valuescompleted

items_syncedintegerrequired

timestampstring

geocodedinteger

Running only: activities reverse-geocoded in this call (bounded batch).

geocode_remaininginteger

Running only: activities with coordinates still awaiting geocoding. Call again to drain.

cURL

curl -X POST 'https://api.rewind.rest/v1/admin/sync/listening' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{"type": "scrobbles"}'

200

{
  "status": "completed",
  "items_synced": 42,
  "timestamp": "date-time",
  "geocoded": 200,
  "geocode_remaining": 864
}