API reference

Authentication

Create a key in the dashboard and send it in the Authorization header. Keep keys server-side — never ship them in browser or mobile code.

export BASE=https://data.sportshustle.com
export KEY=sk_live_…
curl $BASE/api/v1/sports -H "Authorization: Bearer $KEY"

Responses

Success responses wrap results in data; lists add meta for paging. Errors always use the same shape.

// 200
{ "data": [ … ], "meta": { "total": 104, "limit": 25, "offset": 0 } }

// 4xx / 5xx
{ "error": { "code": "invalid_parameter", "message": "state must be a 2-letter abbreviation" } }

CSV downloads

Add format=csv to any endpoint to get the same page of results as a CSV file. Nested fields become dotted columns (conference.division.name) and lists are joined with semicolons. Paging, limits and quotas work exactly as for JSON, and errors are still returned as JSON. Prefer a UI? The Data Downloads page lets you build a search with every filter and download the results.

curl "$BASE/api/v1/colleges?state=TX&limit=100&format=csv" \
  -H "Authorization: Bearer $KEY" -o colleges.csv

Postman

Download the collection, then in Postman choose Import and select the file. Open the collection's Variables tab and set apiKey to one of your keys — every request already uses it as a Bearer token.

Rate limits & quotas

Each plan has a per-minute rate limit and a monthly request quota, shared by all keys on your account. Every response tells you where you stand:

Errors