Users

List the account's profile viewers

Returns a cursor-paginated list of the account's recent profile viewers, each classified by disclosure fidelity (identified, semi-anonymous, or aggregate). A free account is capped at semi-anonymous; Premium sees identified. Page until cursor is null.

get/v1/{account_id}/profile/visitors

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/profile/visitors
  • Auth: HTTP bearer

Path parameters

account_idstring required

The connected LinkedIn account whose own insights to read.

Query parameters

limitinteger

Maximum viewers per page (1-100, default 20). The returned count can exceed this; the response includes a cursor to continue.

cursorstring

Opaque cursor from a prior response's cursor; omit for the first page. Page until cursor is null, even on a page with zero people.

Response

A page of the account's recent profile viewers, each classified by disclosure fidelity. A free account is capped at semi-anonymous fidelity (an in-band 200, never a 403). Empty account -> items:[], cursor:null.

object'profile_visitor_list' required

Response type discriminator.

cursorstring nullable required

Opaque cursor for the next page; null when the list is known-exhausted. A non-null cursor means more may exist, keep paging (zero individuals on a page is not exhaustion). There is no total (the upstream total is unreliable).

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.