Skip to main content
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

​
workspace_id
string | null
Workspace tied to the API key (null for personal-scope keys).
​
targets
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 access
  • 500 - unexpected database/analytics service error
All error responses from analytics endpoints include an error_code field.