NEOLearn

DiscoveryService

Discovery: the home page's rows, search, and the impressions that measure them.

Updated October 21, 2026

On this page

Discovery: the home page's rows, search, and the impressions that measure them. The charts are CatalogService.ListExperiences' sorts. Every method is a POST with a JSON body; see the overview for the protocol, authentication and errors.

Summary#

MethodAuthDescription
GetHomeOptionalThe home page: personal rows (continue playing, friends), then rows of the ranked sorts for the caller's age group and device, with about one tile in ten from the exploration pool (new and updated games getting their first chance). Anyone may call it; signed out it has no personal rows.
RecordImpressionsNoneTiles the client showed (in view for half a second or more). Each viewer counts once per game, surface, row and hour; impressions measure play-through (how many who see a game play it for a minute) and spend new games' exploration budgets. Anyone may call it.
SearchNoneGames, creators and groups matching a query: full-text and typo-tolerant, ranked by text match, then players and rating. Filtered by the caller's age; searches for harmful topics return support resources instead of results.

Methods#

GetHome#

The home page: personal rows (continue playing, friends), then rows of the ranked sorts for the caller's age group and device, with about one tile in ten from the exploration pool (new and updated games getting their first chance). Anyone may call it; signed out it has no personal rows.

HTTP
POST /neo.platform.v1.DiscoveryService/GetHome
Content-Type: application/json

Auth: Optional. Signed-in callers get personalised fields.

Request: GetHomeRequest. Response: GetHomeResponse.

RecordImpressions#

Tiles the client showed (in view for half a second or more). Each viewer counts once per game, surface, row and hour; impressions measure play-through (how many who see a game play it for a minute) and spend new games' exploration budgets. Anyone may call it.

HTTP
POST /neo.platform.v1.DiscoveryService/RecordImpressions
Content-Type: application/json

Auth: None.

Request: RecordImpressionsRequest. Response: RecordImpressionsResponse.

Games, creators and groups matching a query: full-text and typo-tolerant, ranked by text match, then players and rating. Filtered by the caller's age; searches for harmful topics return support resources instead of results.

HTTP
POST /neo.platform.v1.DiscoveryService/Search
Content-Type: application/json

Auth: None.

Request: SearchRequest. Response: SearchResponse.

Types#

GetHomeRequest#

FieldTypeDescription
platformstringThe client's platform (web, macos, windows, linux, ios, android, blackbox; empty: web): only games with content for it are shown.

GetHomeResponse#

FieldTypeDescription
rowsarray of HomeRow
rankedAtstringwhen the rankings were computed (empty: computed live, no refresh has run yet)
segmentstringthe audience segment the rows are for (age group and device, e.g. adult.web)

HomeRow#

FieldTypeDescription
idstringrecent, friends, testing, popular, trending, up_and_coming, top_rated, most_engaging, recommended, new
titlestring
sortstringthe chart it opens (CatalogService.ListExperiences sort); empty for personal rows
tilesarray of HomeTile
personalbooleanpersonal rows (continue playing, friends, testing) aren't discovery surfaces: their impressions aren't counted

HomeTile#

FieldTypeDescription
experienceExperience
slotstringorganic (ranked) or exploration (the pool of new games): report it back with the impression

Impression#

FieldTypeDescription
experienceIdstringexp_...
surfacestringhome, charts, search or other
slotstringorganic or exploration (from HomeTile.slot; empty: organic)
variantIdstringthe thumbnail test variant the tile showed (Experience.variant_id), if any
rowstringthe row it was in (HomeRow.id, a chart's sort): a game shown in two rows is two impressions

RecordImpressionsRequest#

FieldTypeDescription
impressionsarray of ImpressionUp to 100 per call.

RecordImpressionsResponse#

FieldTypeDescription
acceptednumberhow many counted (repeats within the hour and over the rate limit don't)

SafetyResource#

FieldTypeDescription
namestring
actionstringwhat to do: "Call or text 988"
urlstring

SearchNotice#

FieldTypeDescription
topicstringself_harm, child_safety
messagestring
resourcesarray of SafetyResource

SearchRequest#

FieldTypeDescription
querystring
genrestringonly games of this genre
limitnumbergames (default 30, at most 60); creators and groups get up to 12 each
platformstring

SearchResponse#

FieldTypeDescription
gamesarray of Experience
creatorsarray of UserSummary
groupsarray of GroupSummary
noticeSearchNoticeset when the query is about a harmful topic: no results, support resources instead

See also#