Skip to main content
Xbox endpoints accept a gamertag or XUID. POST /search is validation-only: it normalizes the identifier type and does not call Xbox or consume credits. 
{
  "value": "SomeGamertag",
  "type": "gamertag"
}

​
Search types

Canonical types:
  • gamertag
  • xuid
Aliases:
  • xbox, xbl, and username -> gamertag
  • id, xbox_id, and xuid -> xuid

​
Endpoint groups

OperationEndpointCostNotes
SearchPOST /tools/xbox/searchFreeValidates and normalizes only.
SuggestionsPOST /tools/xbox/suggestionsFreePeopleHub search suggestions.
ResolvePOST /tools/xbox/resolve1Resolves gamertag or XUID.
ProfilePOST /tools/xbox/profile1Identity, avatar, gamerscore, reputation, and profile fields.
PresencePOST /tools/xbox/presence1Online state, current device, current game, and last seen.
SocialPOST /tools/xbox/social1Friend, follower, following, verification, and multiplayer summary.
Linked AccountsPOST /tools/xbox/linked-accounts1Linked external account metadata.
GamesPOST /tools/xbox/games1Title history and achievement summaries.
MediaPOST /tools/xbox/media1Game clips and screenshots.
ClubsPOST /tools/xbox/clubs1Club memberships and metadata.
Title DetailPOST /tools/xbox/title-detailFreeTitle details and achievements for one titleId.
AllPOST /tools/xbox/all3Runs the main collectors and charges once.
POST /tools/xbox/title-detail also requires a numeric titleId in the body.

​
Fast path

Validate an input before launching enrichment. 
curl -X POST "https://api.osint.ly/tools/xbox/search" \
  -H "Authorization: Bearer $OSINTLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "value": "SomeGamertag", "type": "xbox" }'
Use /all when you need a complete Xbox profile without full per-title achievements. 
curl -X POST "https://api.osint.ly/tools/xbox/all" \
  -H "Authorization: Bearer $OSINTLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "value": "SomeGamertag", "type": "gamertag" }'
Fetch title-specific details separately. 
curl -X POST "https://api.osint.ly/tools/xbox/title-detail" \
  -H "Authorization: Bearer $OSINTLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "value": "SomeGamertag", "type": "gamertag", "titleId": "12345" }'