Grid

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

Get Cascade

Requires Authorization.

GET /v4/cascade

Query:

• everything from CascadeQuery

Response:

• items — array of CascadeItem
• nextPage — integer
• shuffled — boolean
• hiddenProfiles — unknown
• hiddenProfileInfo — unknown

Get Cascade (legacy)

Requires Authorization.

GET /v3/cascade

Query:

• everything from CascadeQuery
• exploreUuid — string, unknown, WIP, optional
• sexualHealth — see Sexual health, optional

Response:

• items — array of CascadeItem
• nextPage — integer
• shuffled — boolean
• hiddenProfiles — unknown
• hiddenProfileInfo — unknown

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 — string, 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, see Get genders, 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 — string, see Tribes, optional
• lookingFor — string, see Looking for, optional
• relationshipStatuses — string, see Relationship status, optional
• bodyTypes — string, see Body type, optional
• sexualPositions — array of integers concatenated with a ,, see Sexual position ID, optional
• meetAt — string, see Meet at, optional
• nsfwPics — string, 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, fav_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. For profile_hide_status, count is on the item itself, not under data.

CascadeResponse

• items — array of CascadeItem
• nextPage — integer
• shuffled — boolean
• hiddenProfiles — unknown
• hiddenProfileInfo — unknown

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

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"

fav_header_v1

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

Only for v3/cascade:

• @type — string, "CascadeItemData$FavHeaderV1"

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

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

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

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
  • 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
• distanceMeters — integer, optional
• rightNow — RightNowStatus
• unreadCount — integer
• isVisiting — boolean
• isPopular — boolean

Only for v3/cascade:

• lastOnline — unix timestamp in milliseconds
• 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