Discover/Ogol API
live

Ogol APIogol.com.br

Access Brazilian women's football player profiles, match logs, season stats, honours, and club squads via the ogol.com.br API. 6 endpoints.

This API takes change requests — .
Endpoint health
verified 22h ago
player_match_log
search_player
player_season_by_season
player_honours
player_profile
6/6 passing latest checkself-healing
Endpoints
6
Updated
8d ago

What is the Ogol API?

The ogol.com.br API provides 6 endpoints covering Brazilian women's football, including player search, biographical profiles, match-by-match logs, career statistics, titles, and club squads. The player_match_log endpoint returns per-game data with fields like minutes played, goals, assists, and starter status for any given season. Player IDs returned by search_player serve as the primary key across all other endpoints.

This call costs2 credits / call— charged only on success
Try it
Player name or partial name to search for.
api.parse.bot/scraper/8ca53bd8-548e-425c-8969-2e2e7e8a2201/<endpoint>
Ready to send
Fill in the parameters and hit sign in to send to see live response data here.
Call it over HTTPgrab a free API key at signup
curl -X GET 'https://api.parse.bot/scraper/8ca53bd8-548e-425c-8969-2e2e7e8a2201/search_player?name=Marta' \
  -H 'X-API-Key: $PARSE_API_KEY'
Python SDK · recommended

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 ogol-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: Ogol Football Player Stats API SDK — bounded, re-runnable; every call capped."""
from parse_apis.Ogol_Football_Player_Stats_API import Ogol, PlayerNotFound

client = Ogol()

# Search for a player by name
for player in client.players.search(name="Marta", limit=3):
    print(player.full_name, player.position, player.nationality)

# Get full profile for the first match
hit = client.players.search(name="Marta", limit=1).first()
try:
    profile = client.players.get(player_id=hit.player_id)
    print(profile.full_name, profile.birth_date, profile.position)
    print(profile.national_team_stats.senior_caps, "caps,", profile.national_team_stats.senior_goals, "goals")
except PlayerNotFound as e:
    print(f"Player gone: {e.player_id}")

# Season-by-season career stats
if hit:
    full = client.players.get(player_id=hit.player_id)
    stats = full.season_by_season()
    for rec in stats.seasons[:3]:
        print(rec.season, rec.club, rec.squad_level, rec.jogos, rec.gols)

# Match log for current season
if hit:
    full = client.players.get(player_id=hit.player_id)
    log = full.match_log(season="155")
    print(log.data_status)
    for match in log.matches[:3]:
        print(match.date, match.competition, match.opponent, match.goals, match.unused_substitute)
    for total in log.resumo_totals[:2]:
        print(total.competition, total.jogos, total.gols_marcados)

# Honours / titles
if hit:
    full = client.players.get(player_id=hit.player_id)
    for title in full.honours(limit=3):
        print(title.competition, title.club, title.season)

# Club squad
corinthians = client.club(team_id="31546")
for member in corinthians.squad(season="155", limit=3):
    print(member.shirt_number, member.name, member.age, member.position)

print("exercised: players.search / players.get / season_by_season / match_log / honours / club.squad")
All endpoints · 6 totalmissing one? ·

Search for football players by name across all ogol.com.br listings (men/women, senior/youth, all leagues). Returns a list of matching players with their IDs, positions, and nationalities. Results are ordered by popularity.

Input
ParamTypeDescription
namerequiredstringPlayer name or partial name to search for.
Response
{
  "type": "object",
  "fields": {
    "players": "array of player search results with player_id, full_name, position, nationality, href"
  },
  "sample": {
    "players": [
      {
        "href": "/jogador/marta/86678?search=1",
        "position": "ATA, MEI",
        "full_name": "Marta",
        "player_id": "86678",
        "nationality": "BR"
      }
    ]
  }
}

About the Ogol API

Player Discovery and Profiles

Use search_player with a full or partial name to retrieve a ranked list of players, each carrying a player_id, position, nationality, and href. Pass any player_id into player_profile to get biographical details: birth_date (ISO YYYY-MM-DD), birthplace, preferred foot, height_weight, current club, and situacao — the active/retired status recorded in Portuguese as *Em atividade* or *Retirado*. Dual nationalities are exposed in the nationality field when applicable.

Match Logs and Career Statistics

player_match_log accepts a player_id and a season parameter (the epoca_id, e.g. 155 for the 2025/2026 season) and returns a chronological array of match entries. Each entry includes date, competition, club, opponent, score, minutes, goals, assists, result, round, home_away, and substitution status. For aggregated career data, player_season_by_season returns one record per club-season with jogos, gols, and assistencias, plus a separate national_team array covering international appearances.

Honours and Club Squads

player_honours returns all recorded titles for a player as an array of competition, club, and season entries. Competition names are preserved in Portuguese as they appear on the source. club_squad accepts a team_id and season and returns the full squad list with shirt_number, name, age, nationality, player_id, and position group — making it straightforward to iterate over a squad and call player_profile or player_season_by_season for each member.

Reliability & maintenanceVerified

The Ogol API is a managed, monitored endpoint for ogol.com.br — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ogol.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 ogol.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.

Last verified
22h ago
Latest check
6/6 endpoints passing
Maintenance
Monitored & self-healing
Will this API break when the source site changes?+
It's built not to. Every endpoint is health-checked on a schedule with automated test probes. When the source site changes and a check fails, the API is automatically queued for repair and re-verified — that's the self-healing layer. Each API page shows when its endpoints were last verified. And because marketplace APIs are shared, any fix reaches everyone using it.
Is this an official API from the source site?+
No — Parse APIs are independent, managed REST wrappers over publicly available data. That is the point: where a site has no official API (or only a limited one), Parse gives you a maintained, monitored endpoint for that data and keeps it working as the site changes — so you get a stable contract over a source that never promised one.
Can I fix or extend this API myself if I need a new endpoint or field?+
Yes — and you don't have to wait on us. This API was generated by the Parse agent, which stays attached. Describe the change in plain English ("add an endpoint that returns reviews", "fix the price field") in the revise box on the API page or via the revise_api MCP tool, and the agent rebuilds it against the live site in minutes. Contributing the change back to the public API is free.
What happens if I call an endpoint that has an issue?+
Errors are machine-readable: a bad call returns a clean status with the list of available endpoints and a repair hint, so an agent (or you) can recover or trigger a fix instead of failing silently. Confirmed failures feed the automatic repair queue.
Common use cases
  • Build a career timeline for any Brazilian women's footballer using player_season_by_season goals and appearances data.
  • Track match-level performance (minutes, goals, assists) across a full season using player_match_log.
  • Compare squad compositions across clubs and seasons using club_squad nationality and position data.
  • Identify active vs. retired players programmatically via the situacao field in player_profile.
  • Aggregate titles by club or competition from player_honours to analyse historic trophy distributions.
  • Cross-reference national team caps from player_season_by_season with club stats to evaluate dual-role workloads.
  • Seed a player database by iterating search_player results and enriching each entry with full profile and career data.
Pricing & limitsSee full pricing →
TierPriceCredits/monthRate limit
Free$0/mo2005 req/min
Hobby$30/mo1,00020 req/min
Developer$100/mo5,000100 req/min
Team$300/mo20,000300 req/min
Company$1,000/mo100,000500 req/min

Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.

Frequently asked questions
Does ogol.com.br have an official developer API?+
No. ogol.com.br does not publish a public developer API or documented data feed. This Parse API is the structured way to access the data it contains.
What does the `player_match_log` endpoint distinguish about a player's role in each match?+
Each match entry includes a status field that records whether the player started, came on as a substitute, or was unused. It also captures minutes played, goals, assists, home_away context, and the result of the match, so you can filter logs to starting appearances or substitute contributions specifically.
How do I find a team_id to use with `club_squad`?+
The team_id is a numeric identifier. It appears in player_profile results under the current club reference, and can also be extracted from player profile href links returned by search_player. There is no dedicated club search endpoint currently. You can fork this API on Parse and revise it to add a club search endpoint that returns team_id values directly.
Does the API cover men's football or other competitions on ogol.com.br?+
The current endpoints are scoped to women's football player and club data. Men's football and other competition types on the site are not covered. You can fork this API on Parse and revise it to add endpoints targeting other competition contexts.
Are historical seasons available in `player_match_log`, or only the current season?+
The season parameter accepts any valid epoca_id, not just the current season. The value 155 maps to the 2025/2026 season. Passing other epoca_id values will return logs for those seasons, provided the player has recorded activity in that period on ogol.com.br. A full mapping of epoca_id values to season labels is not exposed by the current endpoints. You can fork this API on Parse and revise it to add a seasons lookup endpoint.
Page content last updated . Spec covers 6 endpoints from ogol.com.br.
Related APIs in SportsSee all →
transfermarkt.com.br API
Access comprehensive football data including club squads, player profiles, statistics, and agency information to research teams, analyze player performance, and find representation details. Get detailed club information, player page data, and search for agencies all in one place.
corinthians.com.br API
Access official Corinthians team data including player rosters, detailed player profiles, staff information, news updates, and upcoming match schedules across men's, women's, and youth divisions. Stay informed about the club's latest news and upcoming games with real-time information directly from the official source.
whoscored.com API
Search for players and teams, then dive deep into their performance metrics, match statistics, and detailed passing data to analyze football games and player abilities. Get comprehensive insights on team performance, individual player stats, and play-by-play event information to power your football analysis and decision-making.
playerelo.football API
playerelo.football API
fminside.net API
Search and explore the Football Manager player database to find detailed profiles, stats, and information about individual players. Quickly look up players by ID or browse through the complete player catalog to discover talent, compare performance metrics, and research squad options.
soccerstats.com API
Access comprehensive soccer statistics including live league tables, match details, team performance metrics, and form rankings across multiple football leagues. Search for specific teams and analyze their season statistics, head-to-head records, and competitive standings to stay informed on the latest soccer data.
besoccer.com API
besoccer.com API
fbref.com API
Access comprehensive football statistics including player profiles, team performance data, league standings, and detailed match reports all in one place. Search for specific players and teams, compare their stats, and get up-to-date information on leagues and match outcomes.