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.