Images

Public endpoint — no API key required. Images are cached for 1 year and returned as image/png.

The image service lets you render official team or region icons without hosting assets yourself.

Teams: https://api.mrdoge.co/images/teams/{teamId}.png
Regions: https://api.mrdoge.co/images/regions/{regionId}.png

If an image is missing, the API responds with 204 No Content, so make sure to provide a fallback on the client.

Usage Examples

Plain HTML
Next.js Image

<img
  src="https://api.mrdoge.co/images/teams/95450.png"
  alt="Team badge"
  width="64"
  height="64"
  loading="lazy"
/>

import Image from "next/image";

export function TeamBadge({ teamId }: { teamId: number }) {
  return (
    <Image
      src={`https://api.mrdoge.co/images/teams/${teamId}.png`}
      alt="Team badge"
      width={64}
      height={64}
      sizes="64px"
    />
  );
}

Point any image component at the CDN URL and we stream the PNG instantly. Next.js will add responsive sizing and caching, while plain <img> tags still benefit from the 1-year cache headers.

Response

Content-Type

string

Always image/png

Cache-Control

string

public, max-age=31536000, immutable

Status

integer

200 (image found) or 204 (no image available)

Tip: When displaying shields in web apps, point your image tag directly at the CDN and apply lazy-loading or blur placeholders for a smoother UX.

Sports Endpoints

AI Endpoints

Core Utilities

Usage Examples

Response

Sports Endpoints

AI Endpoints

Core Utilities

​Usage Examples

​Response

Usage Examples

Response