Odds337Docs
    Odds337BackGet API key
    Getting started
    • Introduction
    • Authentication
    • Quickstart
    • Tokens & pricing
    • Limits
    • Errors
    • Odds formats
    Reference
    • GET/sports
    • GET/books
    • GET/teams
    • GET/players
    • Logos & headshots
    • GET/events
    • GET/odds
    • GET/scores
    • GET/history
    • GET/clv
    • POST /clv
    • GET/usage
    • GET/_health
    • WebSocket
    • Specs & SDKs
    Racing
    • GET/racing/meetings
    • GET/racing/race
    • GET/racing/history
    • race_id and status
    Concepts
    • event_id
    • selection_key
    • team_id & player_id
    • Open & close prices
    • 337 model price
    • Event links
    • Statuses
    Getting started
    • Introduction
    • Authentication
    • Quickstart
    • Tokens & pricing
    • Limits
    • Errors
    • Odds formats
    Reference
    • GET/sports
    • GET/books
    • GET/teams
    • GET/players
    • Logos & headshots
    • GET/events
    • GET/odds
    • GET/scores
    • GET/history
    • GET/clv
    • POST /clv
    • GET/usage
    • GET/_health
    • WebSocket
    • Specs & SDKs
    Racing
    • GET/racing/meetings
    • GET/racing/race
    • GET/racing/history
    • race_id and status
    Concepts
    • event_id
    • selection_key
    • team_id & player_id
    • Open & close prices
    • 337 model price
    • Event links
    • Statuses

    API reference

    Logos and headshots

    Team crests, league marks and player headshots, served by the API itself. No key, no tokens.

    URLs

    Images are served by this API, never a third-party link, so they keep working whatever the original host does. You normally do not build these URLs: use the logo_url and headshot_url fields on /sports, /teams, /players and each event's competitors.

    PathReturnsCost
    GET /media/logo/{file}A team crest, league mark or nation flag (PNG)0 tokens
    GET /media/player/{player_id}A player headshot0 tokens
    https://api.b337.ai/odds/v1/media/logo/b53e6f5dea67ed9a.png
https://api.b337.ai/odds/v1/media/player/nba:espn:3975

    Using them

    • No key needed. Use the URL straight in an <img src>. It is free on every plan.
    • Responses are cached for one week (Cache-Control), so let the browser cache them rather than re-fetching.
    • The file name in a logo URL is an opaque hash: store the URL, not a name you made up.
    • A few headshots and marks sit on our own storage host and the field links there directly.
    <img src="https://api.b337.ai/odds/v1/media/logo/2f6693605fb6dcfa.png" alt="Arsenal FC" width="32" height="32">

    When there is none

    A logo_url or headshot_url is null when we hold no image: show your own placeholder. A URL that answers 404 means the source no longer has the image; treat it the same way.

    PreviousGET /playersNextGET /events

    On this page

    • URLs
    • Using them
    • When there is none