Corinthians APIcorinthians.com.br ↗
Access official Corinthians squad rosters, player profiles, staff listings, news articles, and upcoming match data via a structured REST API.
What is the Corinthians API?
The Corinthians API exposes 7 endpoints covering the official Sport Club Corinthians Paulista website, including player rosters for the men's, women's, and Sub-20 squads, detailed player profiles, professional football department staff, paginated news articles, and upcoming fixture data. The get_player_detail endpoint, for example, returns position, age, height in meters, and birthplace for any named player in the men's professional squad.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/06ce581e-a6ce-4578-af17-dba5e11eafc3/get_futebol_masculino_elenco' \ -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 corinthians-com-br-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: Corinthians SDK — squad data, player profiles, news, and schedules."""
from parse_apis.corinthians_official_website_api import Corinthians, Category, NotFoundError
corinthians = Corinthians()
# List the men's professional squad — limit caps total items fetched.
for player in corinthians.squads.men(limit=5):
print(player.name, player.photo)
# Drill into a specific player's detailed profile via constructible Player.
detail = corinthians.player(name="Yuri Alberto").details()
print(detail.name, detail.position, detail.height, detail.age, detail.birthplace)
# Get upcoming matches from the event calendar.
for match in corinthians.schedules.upcoming(limit=3):
print(match.title, match.date, match.time)
# Browse news by category using the Category enum.
for article in corinthians.newses.list(category=Category.FUTEBOL, limit=5):
print(article.title, article.link)
# Get professional football department staff.
for member in corinthians.staffs.list(limit=5):
print(member.name, member.role)
# Typed error handling: catch NotFoundError on a bad player lookup.
try:
bad_detail = corinthians.player(name="Nonexistent Player").details()
print(bad_detail.name)
except NotFoundError as exc:
print(f"Player not found: {exc}")
print("exercised: squads.men / player.details / schedules.upcoming / newses.list / staffs.list")
Get the professional men's football squad roster. Returns all players with their names, photos, and profile links. Players are listed without position grouping.
No input parameters required.
{
"type": "object",
"fields": {
"players": "array of player objects with name, photo URL, and profile_link URL"
},
"sample": {
"data": {
"players": [
{
"name": "John Doe",
"photo": "https://static.corinthians.com.br/uploads/177826429334d8bbe82e79d45f13cf5e7acd7ac21c.png",
"profile_link": "https://www.corinthians.com.br/futebol/profissional/elenco/John+Doe"
},
{
"name": "Jane Doe",
"photo": "https://static.corinthians.com.br/uploads/1778265070e92c33518f5a71ec431f7e6d6b3e4fb4.png",
"profile_link": "https://www.corinthians.com.br/futebol/profissional/elenco/Jane+Doe"
}
]
},
"status": "success"
}
}About the Corinthians API
Squad and Player Data
Three squad endpoints cover the club's full football program. get_futebol_masculino_elenco returns every player in the professional men's squad with name, photo URL, and a profile link. get_futebol_feminino_elenco returns the women's squad pre-grouped by position categories — Goleiras, Zagueiras, Laterais, Meias, and Atacantes — along with the same name, photo, and profile fields. get_formacao_sub20 covers the under-20 roster with names, positions, and profile links.
Player Profiles and Staff
get_player_detail accepts a player_name string (matching the exact name as listed on the squad page, e.g. 'Yuri Alberto' or 'Rodrigo Garro') and returns the player's display name, position in Portuguese, age, height formatted with a comma decimal ('1,78'), and birthplace as city and country. get_depto_futebol_profissional returns the full professional football department staff list — name and role for every member from coaching staff through support personnel.
News and Fixtures
get_noticias supports two optional query parameters: page for pagination and category for filtering by content type (e.g. 'futebol' or 'futebol+feminino'). Each article object in the response includes a title, link, date, and thumbnail. get_proxima_partida returns the next scheduled match from the homepage with home team, away team, competition name, venue (state, city, and stadium), and date/time in Brazilian format.
Coverage Notes
All data reflects the official corinthians.com.br website. Player profile fields are limited to what the site's profile pages expose — detailed season statistics (goals, appearances, cards) are not part of the current response shape. Staff roles are returned as strings in Portuguese, matching the site's own labels.
The Corinthians API is a managed, monitored endpoint for corinthians.com.br — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when corinthians.com.br changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official corinthians.com.br API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display the current Corinthians men's or women's starting squad on a fan application using
get_futebol_masculino_elencoorget_futebol_feminino_elenco - Build a player lookup tool that shows height, position, age, and birthplace via
get_player_detail - Populate a match countdown widget with opponent, stadium, and kick-off time from
get_proxima_partida - Aggregate Corinthians news by category (e.g. women's football) using the
categoryandpageparameters onget_noticias - List the full coaching and support staff for a club directory or media guide using
get_depto_futebol_profissional - Track the Sub-20 squad roster and player positions for youth football coverage via
get_formacao_sub20 - Cross-reference player birthplaces from
get_player_detailfor geographic scouting or fan demographic analysis
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Sport Club Corinthians Paulista provide an official public developer API?+
What exactly does `get_proxima_partida` return, and does it include past results?+
get_proxima_partida returns the single next upcoming match as shown on the homepage: home team, away team, competition name, venue (state, city, and stadium name), and date/time in Brazilian format. Past match results are not currently covered. The API covers squad data, staff, news, and one upcoming fixture. You can fork it on Parse and revise to add a historical results endpoint.Does `get_player_detail` return statistics like goals scored or appearances?+
How does pagination work for `get_noticias`?+
page string parameter to retrieve subsequent pages of results. The category parameter accepts slugs such as 'futebol' or 'futebol+feminino' to filter articles. Both parameters are optional; omitting them returns the default latest news. Each article in the response includes a title, link, date, and thumbnail.