OFF SZN Hoops
Developers

OFF SZN API & Embeds

Free, read-only access to OFF SZN player profiles and composite rankings. Embed on your site, build apps, or just integrate our ranking number into your own coverage. Attribution required.

Rate limit
60 req/min/IP
Free tier · no key required
Endpoints
3 stable
Versioned at /api/v1
CORS
Enabled
Fetch from any origin

Endpoints

GET/api/v1/players/:id

Fetch a single player profile + their composite ranking.

Sample response
{
  "apiVersion": "v1",
  "data": {
    "id": "${realId}",
    "firstName": "Jaden",
    "lastName": "Smith",
    "position": "SG",
    "classYear": 2027,
    "starRating": 5,
    "state": "AZ",
    "composite": {
      "compositeRating": 0.985,
      "nationalRank": 12,
      "positionRank": 3,
      "stateRank": 1
    },
    "url": "https://offsznhoops.com/players/${realId}",
    "attribution": "Data via OFF SZN Hoops · offsznhoops.com"
  }
}
GET/api/v1/rankings

List rankings, filterable by state, classYear, and position. Paginated via offset.

ParamDescription
state2-letter code, e.g. AZ
classYearClass year, e.g. 2027
positionPG, SG, SF, PF, C
limit1–100 (default 25)
offsetPagination offset
Sample response
{
  "apiVersion": "v1",
  "filters": { "state": "AZ", "classYear": 2027, "position": null },
  "pagination": { "offset": 0, "limit": 25, "total": 87 },
  "data": [
    {
      "rank": 12,
      "positionRank": 3,
      "stateRank": 1,
      "composite": 0.985,
      "player": {
        "id": "${realId}",
        "firstName": "Jaden",
        "lastName": "Smith",
        "starRating": 5,
        "position": "SG",
        "classYear": 2027,
        "state": "AZ",
        "url": "https://offsznhoops.com/players/${realId}"
      }
    }
  ]
}
GET/embed/rankings

Iframable HTML widget showing the top 10 by composite. Drop into any blog or news article.

Embed code
<iframe
  src="https://offsznhoops.com/embed/rankings?state=AZ&classYear=2027"
  width="100%"
  height="520"
  frameborder="0"
></iframe>

Attribution

Free tier requires a visible attribution link to offsznhoops.com on the page or article using our data. The API responses include an attribution string you can render verbatim. Embed widgets carry attribution natively.

Partner access

Need higher rate limits, an SLA, or richer endpoints? Reach out and we'll set up a partner integration.

Email us →
Share