Grid

Cascade returns stuff like advertisements, upsells and partial profiles, presumably ranked by algorithms or paid subscriptions. Search returns full profiles, seemingly ranked simply by distance.

Get Cascade

Requires Authorization.

Fetching the cascade also marks our profile online by always instantly setting onlineUntil to current time + exactly 600 s.

GET /v4/cascade

Query:

• everything from CascadeQuery

Response:

• items — array of CascadeItem
• nextPage — integer or null
• shuffled — boolean
• hiddenProfiles — array of long integers, profile IDs hidden from the cascade or null
• hiddenProfileInfo — array of strings or null

Get Cascade (legacy) (deprecated)

Requires Authorization.

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

GET /v3/cascade

Query:

• everything from CascadeQuery
• exploreUuid — string, unknown, WIP, optional
• sexualHealth — array of integers concatenated with a ,, -1 means "Not Specified", see Sexual health, optional

Response:

• items — array of CascadeItem
• nextPage — integer or null
• shuffled — boolean
• hiddenProfiles — array of long integers, profile IDs hidden from the cascade or null
• hiddenProfileInfo — array of strings or null

Search

Requires Authorization.

Results array appears to be capped to 600 per page. Use searchAfterProfileId or searchAfterDistance for pagination.

GET /v7/search

Query:

• everything from GridQuery
• online — boolean, optional
• ageMinimum — integer, optional
• ageMaximum — integer, optional
• heightMinimum — float, optional
• heightMaximum — float, optional
• weightMinimum — float, optional
• weightMaximum — float, optional
• grindrTribesIds — array of integers concatenated with a ,, -1 means "Not Specified", see Tribes, optional
• lookingForIds — array of integers concatenated with a ,, -1 means "Not Specified", see Looking for, optional
• relationshipStatusIds — array of integers concatenated with a ,, -1 means "Not Specified", see Relationship status, optional
• bodyTypeIds — array of integers concatenated with a ,, -1 means "Not Specified", see Body type, optional
• sexualPositionIds — array of integers concatenated with a ,, -1 means "Not Specified", see Sexual position, optional
• meetAtIds — array of integers concatenated with a ,, -1 means "Not Specified", see Meet at, optional
• nsfwIds — array of integers concatenated with a ,, -1 means "Not Specified", see Accept NSFW pics, optional
• profileTags — string, see Profile tags, optional
• searchAfterDistance — string, optional
• searchAfterProfileId — string, optional
• freeFilter — boolean, optional

Response:

• profiles — array of SearchProfileResult
• lastDistanceInKm — float
• lastProfileId — integer
• inserts — object
  • mpuFree — integer
  • mpuXtra — integer
  • boostUpsell — array of integers
  • mrecCascadeFirst — integer
  • mrecCascadeSecond — integer
  • mrecCascadeThird — integer

GridQuery

• nearbyGeoHash — Geohash
• exploreGeoHash — Geohash, optional
• photoOnly — boolean, optional
• faceOnly — boolean, optional
• notRecentlyChatted — boolean, optional
• hasAlbum — boolean, optional
• fresh — boolean, optional
• genders — string, comma-separated list of gender IDs, see Get genders — a filter query param (CSV string), unlike the profile-write genders field which is an integer array, optional
• pageNumber — integer, optional

CascadeQuery

• everything from GridQuery
• onlineOnly — boolean, optional
• ageMin — integer, optional
• ageMax — integer, optional
• heightCmMin — float, optional
• heightCmMax — float, optional
• weightGramsMin — float, optional
• weightGramsMax — float, optional
• tribes — array of integers concatenated with a ,, -1 means "Not Specified", see Tribes, optional
• lookingFor — array of integers concatenated with a ,, -1 means "Not Specified", see Looking for, optional
• relationshipStatuses — array of integers concatenated with a ,, -1 means "Not Specified", see Relationship status, optional
• bodyTypes — array of integers concatenated with a ,, -1 means "Not Specified", see Body type, optional
• sexualPositions — array of integers concatenated with a ,, -1 means "Not Specified", see Sexual position ID, optional
• meetAt — array of integers concatenated with a ,, -1 means "Not Specified", see Meet at, optional
• nsfwPics — array of integers concatenated with a ,, -1 means "Not Specified", see Accept NSFW pics, optional
• tags — string, see Profile tags, optional
• rightNow — boolean, optional
• favorites — boolean, optional
• showSponsoredProfiles — boolean, optional
• shuffle — boolean, optional
• hot — boolean, optional

CascadeItem

• type — string
• data — object, shape depends on type — full_profile_v1, partial_profile_v1, advert_v1, top_picks_v1, explore_aggregation_v1, boost_upsell_v1, unlimited_mpu_v1, xtra_mpu_v1, favs_header_v1, hidden_profile_v1, smart_boost_profile_v1, sponsored_profile_v1, braze_event_profile_v1, favs_xtra_upsell_v1, favs_unlimited_upsell_v1, favorites_header_no_free_results_v1, favorites_header_no_xtra_results_v1, profile_hide_status, rewarded_profiles_entry_point_v1, right_now_carousel_v1. For profile_hide_status, count is on the item itself, not under data.

CascadeResponse

• items — array of CascadeItem
• nextPage — integer or null, optional
• shuffled — boolean
• hiddenProfiles — array of long integers, profile IDs hidden from the cascade or null, optional
• hiddenProfileInfo — array of strings or null, optional

full_profile_v1

• everything from CascadeResponseProfile

Only for v3/cascade:

• everything from ProfileFields
• @type — string, "CascadeItemData$FullProfileV1"
• tribes — array of integers, see Tribes
• socialNetworks — array of SocialNetwork
• takenOnGrindrMetadata — object
  • key is Media hash
  • takenOnGrindr — boolean
  • createdAt — unix timestamp in milliseconds

Only for v4/cascade:

• age — integer, optional
• heightCm — integer, optional
• weightGrams — integer, optional
• bodyType — integer, see Body type, optional
• sexualPosition — integer, see Sexual position ID, optional

partial_profile_v1

• everything from CascadeResponseProfile
• upsellItemType — string, e.g. "xtra_mpu_v1"

Only for v3/cascade:

• @type — string, "CascadeItemData$PartialProfileV1"

advert_v1

• cascadePlacementName — string, e.g. "mrec-cascade-first"

Only for v3/cascade:

• @type — string, "CascadeItemData$Advert"

top_picks_v1

Empty for v4/cascade.

Only for v3/cascade:

• @type — string, "CascadeItemData$TopPicksV1"

explore_aggregation_v1

• uuid — string, UUIDv4
• headerName — string, e.g. "🌎 Explore"
• source — string, e.g. "cascade"
• items — array of objects. @type determines contents: "ExploreAggregationItem$Location": data.onlineCount (integer), data.uuid (UUIDv3 string), data.location (id integer, name string e.g. "Minneapolis", suffix string e.g. "🇺🇸", lat float, lon float), data.profiles (array of objects with profileImageUrl URL string). "ExploreAggregationItem$Cta": empty.

Only for v3/cascade:

• @type — string, "CascadeItemData$ExploreAggregationV1"

boost_upsell_v1

Empty for v4/cascade.

Only for v3/cascade:

• @type — string, "CascadeItemData$BoostUpsellV1"

unlimited_mpu_v1

Empty for v4/cascade.

Only for v3/cascade:

• @type — string, "CascadeItemData$UnlimitedMpuV1"

xtra_mpu_v1

Empty for v4/cascade.

Only for v3/cascade:

• @type — string, "CascadeItemData$XtraMpuV1"

favs_header_v1

• available — integer
• displayed — integer
• total — integer

Only for v3/cascade:

• @type — string, "CascadeItemData$FavHeaderV1"

right_now_carousel_v1

Right Now carousel of nearby profiles with an active Right Now post.

• items — array of objects
  • profileId — long integer
  • onlineUntil — long integer or null
  • displayName — string or null
  • primaryImageUrl — string or null
  • favorite — boolean or null
  • chatted — boolean or null
  • rightNow — string or null
  • unreadCount — integer or null
  • viewed — boolean or null
  • roaming — boolean or null
  • isVisiting — boolean or null
  • isPopular — boolean or null
  • distanceMeters — number or null
  • isRewarded — boolean or null
  • fuzzedLat — number or null
  • fuzzedLon — number or null
  • rightNowPin — the pin thumbnail: thumbnailUrl, fullImageUrl, isNsfw, text or null
  • rightNowPost — the active post: id, thumbnailUrl, fullImageUrl, isNsfw, text, expirationTimestamp or null

hidden_profile_v1

Hidden profile. Same shape as full_profile_v1.

• everything from CascadeResponseProfile

Only for v4/cascade:

• age — integer, optional
• heightCm — integer, optional
• weightGrams — integer, optional
• bodyType — integer, see Body type, optional
• sexualPosition — integer, see Sexual position ID, optional

smart_boost_profile_v1

Smart boost profile. Same shape as full_profile_v1.

• everything from CascadeResponseProfile

Only for v4/cascade:

• age — integer, optional
• heightCm — integer, optional
• weightGrams — integer, optional
• bodyType — integer, see Body type, optional
• sexualPosition — integer, see Sexual position ID, optional

sponsored_profile_v1

• cascadePlacementName — string
• alternativeProfile — CascadeResponseProfile, Fallback full_profile_v1 shape, shown when the sponsored ad is unavailable.

braze_event_profile_v1

• profileId — integer
• onlineUntil — unix timestamp in milliseconds, optional
• displayName — string, optional
• primaryImageUrl — string, URL, optional
• eventName — string, Braze event name

favs_xtra_upsell_v1

• available — integer

favs_unlimited_upsell_v1

Empty.

favorites_header_no_free_results_v1

Empty.

favorites_header_no_xtra_results_v1

Empty.

profile_hide_status

Unlike other cascade items, count sits directly on the item alongside type, not under data.

• count — integer

rewarded_profiles_entry_point_v1

Entry point card offering to unlock profiles by watching a rewarded ad, see Rewarded Ad Type CASCADE_PROFILES_UNLOCK. Rendered full width rather than as a grid tile.

• previewImageUrls — array of strings, URLs of the profile images that would be unlocked, see Media -> Public CDN files -> Profile Images
• remainingRewards — integer, how many times the reward can still be redeemed
• profilesPerRedemption — integer, how many profiles a single redemption unlocks

SearchProfileResult

• age — integer or null
• displayName — string
• distance — float
• hasFaceRecognition — boolean
• isFavorite — boolean
• new — boolean
• lastChatTimestamp — number, may be 0
• lastViewed — unix timestamp in milliseconds or null
• lastUpdatedTime — unix timestamp in milliseconds
• medias — array of ProfileMedia or null
• profileId — integer
• profileImageMediaHash — string, See Media -> Public CDN files -> Profile Images or null
• profileTags — array of Profile tags
• seen — unix timestamp in milliseconds
• showAge — boolean
• showDistance — boolean
• approximateDistance — boolean
• boosting — boolean
• hasAlbum — boolean
• gender — array of integers or [-1], see Get genders

SearchProfilesResponse

• profiles — array of SearchProfileResult
• lastDistanceInKm — float
• lastProfileId — integer
• inserts — object, optional
  • mpuFree — integer
  • mpuXtra — integer
  • boostUpsell — array of integers
  • mrecCascadeFirst — integer
  • mrecCascadeSecond — integer
  • mrecCascadeThird — integer

CascadeResponseProfile

Profile data returned in cascade items.

• profileId — integer
• onlineUntil — unix timestamp in milliseconds
• displayName — string, optional
• distanceMeters — integer, optional
• lastOnline — unix timestamp in milliseconds, optional
• rightNow — RightNowStatus
• unreadCount — integer
• isVisiting — boolean
• isPopular — boolean

Only for v3/cascade:

• photoMediaHashes — array of strings, see Media
• lookingFor — array of integers, see Looking for
• sexualPosition — integer, see Sexual position ID, optional
• approximateDistance — boolean
• isFavorite — boolean
• isBoosting — boolean
• hasChattedInLast24Hrs — boolean
• hasUnviewedSpark — boolean
• isTeleporting — boolean
• isRoaming — boolean
• isRightNow — boolean
• hasUnreadThrob — boolean
• isBlockable — boolean, optional
• isBoostingSomewhereElse — boolean

Only for v4/cascade:

• primaryImageUrl — string, URL
• favorite — boolean
• viewed — boolean
• chatted — boolean
• roaming — boolean