API Documentation

Everything you need to integrate car manufacturer logos using TecDoc IDs.

Introduction

The TecDoc Logos API provides instant access to car manufacturer logos using TecDoc manufacturer IDs (mfrId). Get JSON metadata with all logo URLs, or fetch images directly.

API Playground

Test the API directly in your browser. Enter your API key and manufacturer ID to see live results.

Authentication

All API requests require authentication. You can authenticate using either method:

Server-Side: Bearer Token (Recommended)

Pass your API key in the Authorization header. This keeps your token secure and out of URLs.

Authorization: Bearer your_api_key

Client-Side: URL Parameter

For browser/frontend usage where you can't set headers (like <img> tags), pass your token as a query parameter.

GET mfrlogo.com/121.svg?token=your_api_key

Base URL

All API requests should be made to:

https://mfrlogo.com

Get Logo (JSON)

Returns metadata and URLs for all available logo formats.

# With Bearer token
GET https://mfrlogo.com/121
Authorization: Bearer your_api_key

# With URL parameter
GET https://mfrlogo.com/121?token=your_api_key

Response

{
  "mfrId": 121,
  "name": "Volkswagen",
  "formats": ["svg", "png"],
  "variants": ["black", "white"],
  "logos": {
    "svg": "https://mfrlogo.com/121.svg",
    "png_64": "https://mfrlogo.com/121_64.png",
    "png_128": "https://mfrlogo.com/121_128.png",
    "png_256": "https://mfrlogo.com/121_256.png"
  }
}

Note: formats shows available file types (svg, png). variants shows available color versions (black, white) for SVG logos only.

Get Logo (Direct Image)

Returns the image file directly. Perfect for <img> tags and direct embedding.

# SVG (recommended for scaling)
GET https://mfrlogo.com/121.svg?token=your_api_key

# PNG - default 128px
GET https://mfrlogo.com/121.png?token=your_api_key

# PNG - specific sizes
GET https://mfrlogo.com/121_64.png?token=your_api_key
GET https://mfrlogo.com/121_256.png?token=your_api_key

HTML Example

<!-- Using direct image URL -->
<img
  src="https://mfrlogo.com/121.svg?token=your_api_key"
  alt="Volkswagen"
  width="64"
/>

Image Formats

Color Variants

Some logos have monochrome variants for use on light or dark backgrounds. Check the variants field in the JSON response to see what's available.

Error Handling

The API returns standard HTTP status codes:

Error Response

{
  "error": "Invalid API key"
}

Rate Limits

No usage limits on logo delivery! You're billed automatically based on actual usage with Stripe's metered billing.

There's only one rate limit for abuse protection:

How billing works:

• Make as many requests as you need
• Each request is tracked and reported to Stripe
• At the end of the month, you're billed for actual usage
• Graduated pricing = volume discounts automatically applied
• No surprises, no blocked requests

Contact support if you need higher limits for legitimate high-traffic use cases.