Search

Scout aims to maintain the most comprehensive database of gamers anywhere. You can search the database by providing various search parameters including: username/handle (such as an Xbox Gamertag, PSN ID, Steam URL, etc.), platform (Xbox Live, Playstation Network, Steam, Origin, etc.) and title (Fortnite, COD, etc.)

If a persona (a gamer's account on a specific platform) is not found in our database during search, we'll perform a more comprehensive search on possible sources.


Finding a player

  • Node.js
  • Native SDK (iOS)
  • Web SDK (Javascript)
  • GraphQL
      

Results explanation

Because data for some titles is inherently sparse, and because of the variance in how certain publishers allow that data to be accessed, it's difficult to create a perfect representation of a player's identity in some cases. There are however two pieces of information that are typically available: a player's ID, and their display name. On each search result, Scout will provide this information using the playerId and handle properties on the player object.

We recommend that you use the properties of the player object to make programmatic calls to the Scout API.

In many cases, we may also provide a persona object on a results item. The persona object is a representation of that player on a specific platform (such as Xbox Live, Playstation Network, Steam, etc.) We recommend that you use the persona properties for the purpose of displaying a user's identity when it is available.


Parameters by title

Some titles require specific search patterns in order to find the intended player. This means for instance, some games require you to provide an in-game username instead of the player's Xbox gamertag or PSN ID. Because of this, we recommend using the UI provided by our SDK to perform searches. We've outlined the specific requirements for each title we support on the title's documentation page, which can be found in the navigation on the left.