curl --request GET \
--url https://www.genviral.io/api/partner/v1/analytics/targets \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Analytics targets retrieved",
"data": {
"workspace_id": "4cb5d3fd-8c8f-4ed7-a17c-4ffb52c7e6ac",
"targets": [
{
"id": "e7a7f417-56db-4320-9e9a-fd6fdabda09d",
"target_id": "e7a7f417-56db-4320-9e9a-fd6fdabda09d",
"platform": "tiktok",
"identifier": "@brand",
"display_name": "Brand HQ",
"free_refresh_available": true
}
]
}
}
Analytics
List Analytics Targets
List tracked analytics accounts in the authenticated key scope
GET
/
api
/
partner
/
v1
/
analytics
/
targets
curl --request GET \
--url https://www.genviral.io/api/partner/v1/analytics/targets \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Analytics targets retrieved",
"data": {
"workspace_id": "4cb5d3fd-8c8f-4ed7-a17c-4ffb52c7e6ac",
"targets": [
{
"id": "e7a7f417-56db-4320-9e9a-fd6fdabda09d",
"target_id": "e7a7f417-56db-4320-9e9a-fd6fdabda09d",
"platform": "tiktok",
"identifier": "@brand",
"display_name": "Brand HQ",
"free_refresh_available": true
}
]
}
}
Returns tracked analytics targets for the authenticated key scope (workspace or personal).
Behavior
- Returns all targets scoped to the API key.
- Includes last snapshot/refresh status and
free_refresh_available. - This dataset is the source of account-level stats shown in the internal analytics UI.
Use Create Analytics Target to add a
new account to track.
Response
string | null
Workspace tied to the API key (
null for personal-scope keys).array
Analytics targets with status metadata and last snapshot totals. Each row
includes canonical
id and a backward-compatible target_id alias.curl --request GET \
--url https://www.genviral.io/api/partner/v1/analytics/targets \
--header 'Authorization: Bearer <token>'
{
"ok": true,
"code": 200,
"message": "Analytics targets retrieved",
"data": {
"workspace_id": "4cb5d3fd-8c8f-4ed7-a17c-4ffb52c7e6ac",
"targets": [
{
"id": "e7a7f417-56db-4320-9e9a-fd6fdabda09d",
"target_id": "e7a7f417-56db-4320-9e9a-fd6fdabda09d",
"platform": "tiktok",
"identifier": "@brand",
"display_name": "Brand HQ",
"free_refresh_available": true
}
]
}
}
Error Responses
401/403- authentication failed or key lacks workspace access500- unexpected database/analytics service error
error_code field.