IodidDOCUMENTATION

api/summoner/search.mdx

/doc/api/summoner/search

PUBLIC DOCUMENTATION

Search

Autocomplete search by Riot ID or partial puuid — validation, response and curl.

GET/api/lol/search

Autocomplete search by Riot ID or partial puuid

Query params

Request
https://api.safjnest.com/api/lol/search
curl "https://api.safjnest.com/api/lol/search"

Missing required: q

CORS enabled (*) — runs directly in your browser against https://api.safjnest.com

GET /api/lol/search?q=

Autocomplete search by Riot ID or partial puuid across all active shards. Add shard to limit results to one platform shard.

  • Controller: LolController.java:47
  • Validation: requiredText(q, "search query") (LolApiParameters.java:230) + SummonerService.normalizeSearch(query).isEmpty() → 400
  • Response: 200 with List<SummonerView> (max 25 from MongoDB.MAX_SEARCH_RESULTS), 400 on empty query
ParameterPositionRequiredTypeValidationNotes
qqueryyesStringrequiredText + normalizeSearch non-emptyremoves spaces/-/#, at least 1 char
shardquerynoLeagueShardrequiredShard when provided :163omit to search all active shards

Response — List<SummonerView>

Same shape as profile SummonerView but without overview statistics — only summoner + ranks.

curl

bash
curl "https://api.safjnest.com/api/lol/search?q=Faker%23KR1"
curl "https://api.safjnest.com/api/lol/search?q=Hide%20on%20bush%23KR1&shard=KR"

Notes

  • Invalid provided shard → 400 invalid_request
  • Empty q → 400