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.

Returns an empty list while account preferences have hideViewedMe set. Views are not recorded either, so the list stays empty for the period the setting was on.

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.

Removed in the official Android client v26.10.0. The client records views one profile at a time via POST /v5/views/{profileId}. 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