Views

Get views number

Requires Authorization.

GET /v6/views/eyeball

Response:

• viewedCount — integer
• mostRecent — object or null
  • profileId — string with number
  • photoHash — string, See Media -> Public CDN files -> Profile Images
  • timestamp — unix timestamp in milliseconds

Get viewers list

Requires Authorization.

GET /v7/views/list

Response:

• totalViewers — integer
• previews — array of ViewPreview
• profiles — array of ViewerProfile
• ttl — long integer, viewers-list time-to-live
• lastDistanceInKm — string, distance (km) of the last returned viewer, pagination cursor or null
• lastProfileId — string, profile ID of the last returned viewer, pagination cursor or null
• upsells — object, ad placement indices or null
  • mpuFree — integer or null
  • mpuXtra — integer or null
  • boostUpsell — array of integers or null
  • mrecCascadeFirst — integer or null
  • mrecCascadeSecond — integer or null
  • mrecCascadeThird — integer or null

Record profile views (batch) (deprecated), WIP

NOTE

This endpoint hasn't been researched yet

Requires Authorization.

Not present in the official client as of app 26.10.0+ — the client records views one profile at a time via POST /v5/views/{profileId}. This batch endpoint still works server-side but is documented for older/compat use. The foundVia field is only ever sent as null by observed clients.

POST /v4/views

Body:

• viewedProfileIds — array of strings with numeric profile IDs
• foundVia — ViewSourceEnum or null

Record single profile view, WIP

NOTE

This endpoint hasn't been researched yet

Requires Authorization.

POST /v4/views/{profileId}

Record profile view v2, WIP

NOTE

This endpoint hasn't been researched yet

Requires Authorization.

POST /v5/views/{profileId}

Body:

• foundVia — Free-form discovery source string (not the source enum). or null
• source — ViewSourceEnum

ViewSourceEnum

View source.

• DISCOVER
• FOR_YOU
• UNKNOWN — (fallback)

ViewsEyeballResponse

• viewedCount — integer
• mostRecent — object or null
  • profileId — string with number
  • photoHash — string, See Media -> Public CDN files -> Profile Images
  • timestamp — unix timestamp in milliseconds

ViewPreview

• everything from ProfileMasked
• isInBadNeighborhood — boolean
• isViewedMeFreshFace — boolean
• isSecretAdmirer — boolean
• viewedCount — object
  • totalCount — integer
  • maxDisplayCount — integer
• rightNowStatus — RightNowAttributionStatus, Right Now attribution status. Added in app 26.11.0 under key rightNowStatus (distinct from rightNow). or null, optional

ViewerProfile

• everything from ViewPreview
• everything from ProfileShort
• hasFaceRecognition — boolean
• isIncognito — boolean
• boosting — boolean
• showUnlockReward — boolean
• unreadMessageCount — integer
• hasChatted — boolean

ViewsListResponse

• totalViewers — integer
• previews — array of ViewPreview
• profiles — array of ViewerProfile
• ttl — long integer, viewers-list time-to-live, optional
• lastDistanceInKm — string, distance (km) of the last returned viewer, pagination cursor or null, optional
• lastProfileId — string, profile ID of the last returned viewer, pagination cursor or null, optional
• upsells — object, ad placement indices or null, optional
  • mpuFree — integer or null
  • mpuXtra — integer or null
  • boostUpsell — array of integers or null
  • mrecCascadeFirst — integer or null
  • mrecCascadeSecond — integer or null
  • mrecCascadeThird — integer or null