Find categories, rounds, groups, teams and players of a tournament by name
Turns the names an organizer uses («4a varonil», «grupo B», «Juan Pérez») into identifiers for the other operations. Accents and case are ignored, and nouns such as «categoría», «grupo» or «pareja» are dropped from the query (normalizedQuery). Hits are ranked (100 exact, 80 prefix, 60 word prefix, 40 contains, 20 shared words) and carry where they sit (context); a team hit also says whether the team was withdrawn («Baja», withdrawn). ambiguous: true when two or more hits of one kind match well (score 60 or more): ask the organizer which one, never guess. A player and the team they play in never count together: the operation that takes the idx picks the kind. kinds narrows what is searched; limit 1-25, default 10. Needs only the read scope. All identifiers (idx) are v4 UUIDs.
Authorization
apiToken API token (organization or personal)
In: header
Path Parameters
Tournament identifier
uuidQuery Parameters
What to look for: a category, round, group, team or player name, accents and case ignored («grupo b», «juan perez», «4a»)
1 <= length <= 100Comma-separated subset of divisions, rounds, pools, teams, players. Default: all of them.
Most hits, 1-25
1 <= value <= 2510Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/external/tournaments/497f6eca-6276-4993-bfeb-53cbbbba6f08/search?q=juan+perez"{ "query": "Grupo B", "normalizedQuery": "b", "ambiguous": false, "results": [ { "kind": "team", "idx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c", "name": "Pérez / Ruiz", "score": 100, "withdrawn": false, "context": { "divisionIdx": "a7b8c9d0-e1f2-4345-8a6b-7c8d9e0f1a2b", "divisionName": "4a varonil", "roundIdx": "f1a2b3c4-d5e6-4f70-8a1b-2c3d4e5f6a7b", "roundLabel": { "es": "Fase de Grupos", "en": "Group stage" }, "poolIdx": "c1d2e3f4-a5b6-4789-8c0d-1e2f3a4b5c6d", "poolName": "Grupo B", "teamIdx": "b8c9d0e1-f2a3-4456-8b7c-8d9e0f1a2b3c", "teamName": "Pérez / Ruiz", "players": [ { "idx": "c9d0e1f2-a3b4-4567-8c8d-9e0f1a2b3c4d", "firstName": "Mario", "lastName": "Lugo", "avatar": "https://cdn.setto.io/avatars/mario-lugo.png" } ] } } ]}