These endpoints stay closer to table-shaped rows, historical exports, assets, and stat-heavy research surfaces. They are powerful, but they are not the default starting point for most app integrations.
Reach for these groups when you are doing ETL, warehousing, analytics, asset retrieval, or historical research. If you are building a product surface, the curated endpoint families are usually the better first stop.
Use these routes when you want flatter, table-like records that can be pulled into pipelines, notebooks, or reporting layers without reshaping app-facing objects first.
Reach for the history surfaces when you need stadium changes, logo history, official records, venue context, or older season-linked reference rows across time.
If a curated endpoint already exists for teams, players, games, seasons, staff, contributors, or executives, start there first and use reference data only when you truly want the raw row shape.
The raw surface is concentrated in four groups: static assets, historical tables, reference rows, and stats-heavy exports for research-oriented workflows.
/List curated image assets
Direct asset discovery for logos or image catalogs.
Operation ID: listImageAssets
Path parameters are part of the URL itself. Query parameters are optional filters you add after a ?.
| Name | In | What it means | Type | Required | Example |
|---|---|---|---|---|---|
group | query | — | all|brand|players | no | brand |
search | query | — | string | no | logo |
limit | query | Maximum number of rows to return in one response. | integer | no | 50 |
offset | query | Number of rows to skip before returning results. Use with limit for pagination. | integer | no | 0 |
GET /api/v1/assets/images?limit=50{
"data": [
{
"id": "brand-nflmeta-logo",
"group": "brand",
"key": "nflmeta_logo",
"label": "NFLMeta Logo",
"url": "https://nflmeta.org/hero_main/NFLMeta_Logo.png",
"source": "local"
}
],
"meta": {
"total": 11,
"limit": 100,
"offset": 0,
"returned": 1,
"has_more": false,
"groups": [
"all",
"brand",
"players"
]
}
}/List logo assets
Direct asset discovery for logos or image catalogs.
Operation ID: listLogoAssets
Path parameters are part of the URL itself. Query parameters are optional filters you add after a ?.
| Name | In | What it means | Type | Required | Example |
|---|---|---|---|---|---|
category | query | — | all|team|season|super_bowl|stadium | no | team |
search | query | — | string | no | steelers |
limit | query | Maximum number of rows to return in one response. | integer | no | 50 |
offset | query | Number of rows to skip before returning results. Use with limit for pagination. | integer | no | 0 |
GET /api/v1/assets/logos?limit=50{
"data": [
{
"id": "team-pit",
"category": "team",
"key": "PIT",
"label": "Pittsburgh Steelers",
"url": "https://nflmeta.org/hero_main/logos/pittsburgh-steelers-logo-transparent.png",
"source": "local"
}
],
"meta": {
"total": 32,
"limit": 100,
"offset": 0,
"returned": 1,
"has_more": false,
"categories": [
"all",
"team",
"season",
"super_bowl",
"stadium"
]
}
}