Skip to content

Discover, WIP ​

NOTE

This page is a work in progress. Endpoints below haven't been fully researched. Help needed.

Get discover profiles (deprecated), WIP ​

Removed in the official Android client v26.10.0. The client now uses GET /v4/discover.

Response type: DiscoverResponse (undocumented).

GET /v3/discover

Query:

  • geohash — Geohash
  • previewedProfiles — array of long integers

Response:

If subscription is purchased,

Unknown, WIP.

If subscription is not purchased,

  • status — string, "SubscriptionRequired"
  • body — object
    • upsell — string, "Unknown"
    • profiles — array, unknown

Get discover profiles (legacy) (deprecated), WIP ​

Removed in the official Android client v26.10.0. The client now uses GET /v4/discover.

Response type: DiscoverResponse (undocumented).

GET /v2/discover

Query:

Response:

If subscription is purchased,

Unknown, WIP.

If subscription is not purchased,

  • status — string, "SubscriptionRequired"
  • body — object
    • upsell — string, "Unknown"

Post a pass, WIP ​

POST /v1/me/pass/{profileId}

Get discover profiles ​

Requires Authorization.

The sole discover endpoint as of app 26.10.0 (replaced /v3/discover and /v2/discover). Response body shape: { status, body: { items, metadata, storedPreferences, types } } (DiscoverFeedData). With status "SubscriptionRequired", body is { profiles, upsell } instead, profiles an array and upsell a string. metadata.exhausted is a boolean and may be absent. A profile item's data.resolution is { action, actionTakenAt } for a profile that was already acted on (action is "PASS", "TAP" or "CHAT", actionTakenAt a long integer), null or absent otherwise. Full item/metadata modeling is pending.

GET /v4/discover

Query:

  • geohash — string
  • previewedProfile — Single previewed profile id (v3 sent an array previewedProfiles)., optional

Response:

Discover feed (DiscoverFeedData); see description for the body shape.

Update discover preferences ​

Requires Authorization.

PUT /v1/discover/preferences

Body:

  • preferences — object
    • lastOnline — integer
    • maxDistance — integer

Open Grind is not affiliated with Grindr in any way.