Top scorers

Parameters

Name	What it does	Example
`match`id, optional	Count only this match.	mt_2QQ50R0
`season`id, optional	Count this season. Give a season or a match.	ss_1VSX6S8
`team`id, optional	Only this team's players.	tm_2QWN0R8

Any other parameter is refused with a 422 naming the ones this endpoint takes, so a typo never silently returns everything.

What each plan returns

Free key

Not included. Returns 403 with the upgrade link.

Archive

Included.

Live

Included.

Response fields

Field	Meaning
`data[].player, team`	ID and name of each
`data[].points`	Points scored
`data[].tries, conversions, penalties, drop_goals`	How they were scored

Errors you can get

Status	Code	When
`400`	`key_in_address`	The key was put in the address. Send it in a header (see Authentication).
`401`	`missing_key`	No Authorization: Bearer header, or the key was rotated (invalid_key, revoked_key).
`403`	`plan_required`	Your plan is below Archive.
`422`	`bad_parameter`	A parameter is malformed, or unknown (unknown_parameter names the ones this endpoint takes).
`422`	`missing_parameter`	Neither a match nor a season was given.
`429`	`daily_limit`	Today's lookups are used. Resets at 00:00 UTC.

Every error has the same shape. All error codes

Try it live

Runs this call from your browser with your own key and shows what comes back.

Your key Get a free key

curl https://api.rugbyapi.com/v1/stats/top-scorers?season=ss_1VSX6S8 \
  -H "Authorization: Bearer YOUR_KEY"

$ch = curl_init('https://api.rugbyapi.com/v1/stats/top-scorers?season=ss_1VSX6S8');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

import requests

r = requests.get(
    "https://api.rugbyapi.com/v1/stats/top-scorers",
    params={"season": "ss_1VSX6S8"},
    headers={"Authorization": "Bearer YOUR_KEY"},
)
data = r.json()

const r = await fetch('https://api.rugbyapi.com/v1/stats/top-scorers?season=ss_1VSX6S8', {
  headers: { Authorization: 'Bearer YOUR_KEY' }
});
const data = await r.json();

200ResponseExample from the live archive, lists cut to 3

{
  "count": 25,
  "data": [
    {
      "player": {
        "id": "pl_2018EXX",
        "name": "George Horne"
      },
      "team": {
        "id": "tm_0QPNGJQ",
        "name": "Glasgow Warriors"
      },
      "points": 28,
      "tries": 1,
      "conversions": 10,
      "penalties": 1,
      "drop_goals": 0
    },
    {
      "player": {
        "id": "pl_2DZ5JTP",
        "name": "James Grayson"
      },
      "team": {
        "id": "tm_228XDAM",
        "name": "Edinburgh"
      },
      "points": 27,
      "tries": 0,
      "conversions": 9,
      "penalties": 3,
      "drop_goals": 0
    },
    {
      "player": {
        "id": "pl_38P3Y97",
        "name": "Joe Roberts"
      },
      "team": {
        "id": "tm_2XWF461",
        "name": "Scarlets"
      },
      "points": 22,
      "tries": 4,
      "conversions": 1,
      "penalties": 0,
      "drop_goals": 0
    }
  ]
}

PreviousMatches NextTry scorers