Form Guide

A club's league position, recent form and next games. For requests like "how are Arsenal doing?", "what's Spurs' form?", "when do Birmingham play next?"

{
  "type": "object",
  "properties": {
    "team": {
      "type": "string",
      "description": "Club name as the user said it, up to 80 characters. Nicknames and small typos are fine."
    },
    "league": {
      "type": "string",
      "description": "One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404. Only needed if two clubs share a name."
    },
    "q": {
      "type": "string",
      "description": "Older name for team, kept for existing callers; team is the current name."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code for the shirt link (US, GB and IE get local Amazon links). Default from the request. When passed as US or CA, the say line also gives the next kick-off in US Eastern time."
    }
  },
  "required": [
    "team"
  ],
  "additionalProperties": false
}

Upcoming fixtures for a club or a league. For requests like "who do Liverpool play next?" or "what's on in La Liga this weekend?". Without team or league, gives the Premier League.

{
  "type": "object",
  "properties": {
    "team": {
      "type": "string",
      "description": "A club name, for example Liverpool or Real Madrid."
    },
    "league": {
      "type": "string",
      "description": "One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "description": "How far ahead, a whole number from 1 to 60. Default 21. If nothing falls in the window (an international break), the next fixtures are returned anyway."
    },
    "country": {
      "type": "string",
      "description": "US or CA adds US Eastern kick-off times to the say line (and to each fixture's us_eastern, which is always there when a time is known)."
    }
  },
  "required": [],
  "additionalProperties": false
}

Latest results for a club, or the last round of a league. For requests like "how did Chelsea get on?" or "what were the Serie A results?". Without team or league, gives the Premier League.

{
  "type": "object",
  "properties": {
    "team": {
      "type": "string",
      "description": "A club name, for example Liverpool or Real Madrid."
    },
    "league": {
      "type": "string",
      "description": "One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404."
    },
    "n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "How many of the club's results, a whole number from 1 to 20. Default 5."
    }
  },
  "required": [],
  "additionalProperties": false
}

League table. For requests like "show me the Championship table" or "who is top of La Liga?". Points include official deductions; a deducted club's row has points_deducted.

{
  "type": "object",
  "properties": {
    "league": {
      "type": "string",
      "description": "One of: premier league, championship, la liga, bundesliga, serie a, ligue 1 (common variants like EPL or German Bundesliga work too). Any other league returns 404. Default premier league."
    }
  },
  "required": [],
  "additionalProperties": false
}

Two clubs side by side before they meet. For requests like "Arsenal v Leeds, how do they compare?". Gives positions, form, goals, this season's meeting and the next date they play. Stats only, not betting advice.

{
  "type": "object",
  "properties": {
    "home": {
      "type": "string",
      "description": "The home club, for example Arsenal."
    },
    "away": {
      "type": "string",
      "description": "A different club from home."
    },
    "team1": {
      "type": "string",
      "description": "Older name for home, kept for existing callers; home is the current name."
    },
    "team2": {
      "type": "string",
      "description": "Older name for away, kept for existing callers; away is the current name."
    },
    "country": {
      "type": "string",
      "description": "US or CA adds US Eastern kick-off times to the say line (and to each fixture's us_eastern, which is always there when a time is known)."
    }
  },
  "required": [
    "home",
    "away"
  ],
  "additionalProperties": false
}