API reference / Analytics
Import from Plausible
Imports the CSV export of Plausible (the zip from its site settings, as base64). The export has visitors, pageviews, visits, bounces and time on site by day. It also has sources, UTM, pages, entry pages, countries, devices, browsers and systems. Troopy leaves out the days that the script already tracked. Reports without filters add the rest.
post
/api/v1/analytics/importsOther ways to call it
CLI
troopy analytics imports createMCP toolNone. Call it over REST or with the CLI.
Rate limit5 calls in 60 seconds, for each key
RetriesSend an
Idempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Body
application/jsonsource*"plausible"file*stringThe export zip, base64 (20 MB at most)
At most 28000000 characters · base64
Response
201 · application/jsondata*object6 properties
id*stringsource*stringfrom*stringThe first day of the import, YYYY-MM-DD
to*stringdays*integercreatedAt*stringISO 8601 date and time
Errors
400 invalid_inputFix the field named in detail. Each operation's schema is in /api/v1/openapi.json.
401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
409 conflictThis Idempotency-Key was used for a different request, or that request is still running. Use a new key for a new request.
429 rate_limitedWait the number of seconds in Retry-After, then retry.