Org APIchess.org.il ↗
Search and find detailed information about chess players registered with the Israel Chess Federation, including their ratings, rankings, and tournament history. Get comprehensive player profiles to research opponents, track performance statistics, or explore the Israeli chess community.
curl -X GET 'https://api.parse.bot/scraper/c7da0745-f5a9-4d91-86c2-e239a7a526ae/search_players?name=%D7%9B%D7%94%D7%9F' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace chess-org-il-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Israel Chess Federation API — search players by name."""
from parse_apis.chess_org_il_api import IsraelChess, ParseError
client = IsraelChess()
# Search for players by a common Hebrew surname, cap at 5 results
for player in client.players.search(name="כהן", limit=5):
print(player.name, player.israeli_rating, player.club)
# Take one player and inspect details
player = client.players.search(name="לוי", limit=1).first()
if player:
print(player.name, player.fide_number, player.country, player.rank)
# Handle errors gracefully
try:
result = client.players.search(name="אור", limit=3).first()
if result:
print(result.name, result.player_id, result.birth_year)
except ParseError as e:
print(f"Error: {e}")
print("exercised: players.search")
Search for chess players registered with the Israel Chess Federation by name. Returns up to 250 matching players with their ratings, club affiliations, FIDE numbers, and other details. The search matches against player names in Hebrew.
| Param | Type | Description |
|---|---|---|
| namerequired | string | Player name or partial name to search for, in Hebrew (e.g. כהן, אור, לוי). |
{
"type": "object",
"fields": {
"total": "integer count of returned players",
"players": "array of player objects with player_id, name, player_number, country, gender, num_tournaments, club, fide_number, status, israeli_rating, fide_standard_rating, rank, chess_card, birth_year, role",
"search_name": "string echo of the search query"
},
"sample": {
"data": {
"total": 250,
"players": [
{
"club": "מועדון שחמט עירוני ת\"א",
"name": "כהן אור",
"rank": "אמן פידה",
"role": "",
"gender": "זכר",
"status": "פעיל",
"country": "ISR",
"player_id": "5810",
"birth_year": "1981",
"chess_card": "31/12/2024",
"fide_number": "2806010",
"player_number": "5810",
"israeli_rating": "2196",
"num_tournaments": "22",
"fide_standard_rating": "2162"
}
],
"search_name": "כהן"
},
"status": "success"
}
}About the Org API
The Org API on Parse exposes 1 endpoint for the publicly available data on chess.org.il. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.