Skip to content
Get a key
API reference / Soccer
GET/soccer/teams/{id}/facts

Team facts: streaks, records, first since, milestones

Insights plan feature (403 FEATURE_NOT_IN_PLAN without it). A soccer team's current facts, each with a sentence (lang de, es, it, fr): current runs (and whether one is the longest of the season), runs its last match ended ("first defeat after 11 unbeaten"), what that match ended that our data can date ("first away win at X since ..."; since and history_from on each: nothing is claimed before our data starts), home and away record, table place, gaps and zone, the next match's stakes, and players' milestones for the club (debut, first goal; 50/100/150 league appearances, 25/50/75 league goals; milestone_next: one short before the next match). coach_change: a head coach appointed in the last 45 days (Wikidata), with the record since when our matches cover the whole tenure. suspended_out and one_booking_from_ban: players banned for, or one booking from a ban before, the next league match (official card rules; only when every league match of the team has our cards). League milestones only when every league match of the team's season has our statistics and the player's earlier league seasons are complete in his profile; debut and first goal only when every match of the season in every competition has them. Kept for an hour. Facts only, no predictions.

Insights planPay per call without a key: $0.02 in USDC

Parameters

  • idinteger · pathrequired

    Team ID

  • langstring · query

    Language of sentences and names: de, es, it, fr

Response

JSON with success, the result in data, and where the endpoint pages its results meta.

  • dataobject
  • as_ofstring
  • factsarray of object
  • based_onarray of integer
  • history_fromstring
  • importanceinteger
  • incompleteboolean

    a match without a result cuts it: no sentence

  • opponentobject
  • player_idinteger
  • sincestring
  • teamobject
  • team_idinteger

    Flat fields for consumers that do not read values: the team's and player's id, the fact's main number, the day a run or "first since" reaches back to, and the start of our data (no claim reaches further).

  • textstring
  • typestring
  • valueinteger
  • valuesobject
  • history_fromstring
  • results_completeboolean
  • sportstring
  • teamobject
  • idinteger
  • namestring
  • errorobject
  • codestring
  • messagestring
  • metaobject
  • attributionstring

    Attribution a data source's licence asks for (Cricsheet's history).

  • limitinteger
  • offsetinteger
  • totalinteger
  • successboolean

Errors

StatusCodeWhen
402x402 offersNo key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
403FORBIDDENThe sport or feature is not in your plan (FEATURE_NOT_IN_PLAN for Insights and other plan features).
404NOT_FOUNDNo record with that id.

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON

Was this page helpful?