Skip to main content
GET
/
api
/
partner
/
v1
/
analytics
/
targets
/
{id}
curl --request GET \
  --url https://www.genviral.io/api/partner/v1/analytics/targets/e7a7f417-56db-4320-9e9a-fd6fdabda09d \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "code": 200,
  "message": "Analytics target retrieved",
  "data": {
    "target": {
      "id": "e7a7f417-56db-4320-9e9a-fd6fdabda09d",
      "platform": "tiktok",
      "identifier": "@brand",
      "display_name": "Brand HQ"
    },
    "summary": {
      "profile": {},
      "totals": {},
      "timeline": [],
      "topPosts": [],
      "latestRefresh": null
    }
  }
}
Returns a single analytics target plus its summary data (profile, totals, timeline, top posts, and refresh status).

​
Path Parameters

​
id
string
required
Analytics target ID.
Use Update Analytics Target to update target settings and Delete Analytics Target to remove a target.
curl --request GET \
  --url https://www.genviral.io/api/partner/v1/analytics/targets/e7a7f417-56db-4320-9e9a-fd6fdabda09d \
  --header 'Authorization: Bearer <token>'

{
  "ok": true,
  "code": 200,
  "message": "Analytics target retrieved",
  "data": {
    "target": {
      "id": "e7a7f417-56db-4320-9e9a-fd6fdabda09d",
      "platform": "tiktok",
      "identifier": "@brand",
      "display_name": "Brand HQ"
    },
    "summary": {
      "profile": {},
      "totals": {},
      "timeline": [],
      "topPosts": [],
      "latestRefresh": null
    }
  }
}

​
Error Responses

  • 400 missing_target_id - missing path parameter
  • 404 - target not found in current key scope
  • 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.