Motomarks

https://motomarks.io/docs
Admin
Motomarks is a comprehensive automotive logo API that provides high-quality car brand logos through...
Tokens:3,505
Snippets:52
Trust Score:2.3
Update:6 months ago
Show doc for...
Tokens:
Raw
### List Brands Response Example

Source: https://motomarks.io/docs/api-reference

Example JSON response containing a list of brand objects.

```json
[
  {
    "id": "ferrari",
    "name": "Ferrari",
    "color": "#FF2800"
  },
  {
    "id": "toyota",
    "name": "Toyota",
    "color": "#EB0A1E"
  }
]
```

--------------------------------

### Get Brand Response Example

Source: https://motomarks.io/docs/api-reference

Example JSON response for a specific brand request.

```json
{
    "id": "ferrari",
    "name": "Ferrari",
    "color": "#FF2800",
    "website": "https://www.ferrari.com",
    "social": {
        "twitter": "https://twitter.com/Ferrari",
        "youtube": "https://www.youtube.com/c/FerrariOfficial",
        "facebook": "https://www.facebook.com/Ferrari",
        "linkedin": "https://www.linkedin.com/company/ferrari/",
        "instagram": "https://www.instagram.com/ferrari/"
    },
    "description": "The Ferrari logo centers on the 'Cavallino Rampante' (prancing horse), a motif originally painted on the fighter plane of Italian World War I ace Francesco Baracca. Enzo Ferrari adopted the symbol in the early 1920s at the suggestion of Baracca's mother; it became associated with his racing cars and was formalized as the brand emblem when Ferrari began producing road cars in 1947. The logo typically pairs the black prancing horse with a yellow shield (a nod to the color of Modena, Enzo Ferrari's birthplace) and often includes the national colors of Italy along the top. Over time the mark has remained highly consistent, becoming one of the most recognized automotive badges in the world while being used across racing, road cars, merchandising and corporate branding.",
    "updatedAt": "2025-11-19T00:10:58.031Z"
}
```

--------------------------------

### GET /brands

Source: https://motomarks.io/docs/api-reference

Retrieve a list of all available automotive brands.

```APIDOC
## GET https://api.motomarks.io/brands

### Description
List all available brands in the Motomarks database.

### Method
GET

### Endpoint
https://api.motomarks.io/brands

### Response
#### Success Response (200)
- **id** (string) - The unique brand identifier
- **name** (string) - The display name of the brand
- **color** (string) - The primary brand color hex code

#### Response Example
[
  {
    "id": "ferrari",
    "name": "Ferrari",
    "color": "#FF2800"
  },
  {
    "id": "toyota",
    "name": "Toyota",
    "color": "#EB0A1E"
  }
]
```

--------------------------------

### Implement Brand Logos with Attribution

Source: https://motomarks.io/docs/platform/attribution

Example structure for displaying brand logos alongside the required attribution link.

```html
<div class="brand-logos">
  <img
    src="https://img.motomarks.io/toyota?token=YOUR_PUBLIC_KEY"
    alt="Toyota"
  />
  <img
    src="https://img.motomarks.io/bmw?token=YOUR_PUBLIC_KEY"
    alt="BMW"
  />
  <img
    src="https://img.motomarks.io/mercedes-benz?token=YOUR_PUBLIC_KEY"
    alt="Mercedes-Benz"
  />
</div>
<p class="attribution">
  <a href="https://motomarks.io">Logos provided by Motomarks</a>
</p>
```

--------------------------------

### Get Brand Details

Source: https://motomarks.io/docs/api-reference

Retrieve detailed information for a specific brand using its identifier.

```http
GET https://api.motomarks.io/brands/{id}
```

--------------------------------

### GET /brands/{id}

Source: https://motomarks.io/docs/api-reference

Retrieve detailed information and metadata for a specific automotive brand.

```APIDOC
## GET https://api.motomarks.io/brands/{id}

### Description
Retrieve detailed information for a specific brand using its unique identifier.

### Method
GET

### Endpoint
https://api.motomarks.io/brands/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The brand identifier (e.g. "ferrari")

### Response
#### Success Response (200)
- **id** (string) - The unique brand identifier
- **name** (string) - The display name of the brand
- **color** (string) - The primary brand color hex code
- **website** (string) - The official brand website
- **social** (object) - Social media links
- **description** (string) - Historical and brand information
- **updatedAt** (string) - ISO timestamp of the last update

#### Response Example
{
    "id": "ferrari",
    "name": "Ferrari",
    "color": "#FF2800",
    "website": "https://www.ferrari.com",
    "social": {
        "twitter": "https://twitter.com/Ferrari",
        "youtube": "https://www.youtube.com/c/FerrariOfficial",
        "facebook": "https://www.facebook.com/Ferrari",
        "linkedin": "https://www.linkedin.com/company/ferrari/",
        "instagram": "https://www.instagram.com/ferrari/"
    },
    "description": "The Ferrari logo centers on the 'Cavallino Rampante' (prancing horse)...",
    "updatedAt": "2025-11-19T00:10:58.031Z"
}
```

--------------------------------

### GET /img.motomarks.io/{slug}

Source: https://motomarks.io/docs/image-cdn

Retrieves a specific automotive brand logo from the Motomarks CDN with customizable parameters.

```APIDOC
## GET https://img.motomarks.io/{slug}

### Description
Retrieves an optimized car brand logo based on the provided slug and query parameters.

### Method
GET

### Endpoint
https://img.motomarks.io/{slug}

### Parameters
#### Path Parameters
- **slug** (string) - Required - The URL-friendly brand name (e.g., toyota, mercedes-benz, bmw).

#### Query Parameters
- **token** (string) - Required - Your publishable API key.
- **size** (string) - Optional - Image dimensions (xs: 64px, sm: 128px, md: 256px, lg: 512px, xl: 1024px). Default: md.
- **type** (string) - Optional - The variant of the logo (full, badge, wordmark). Default: full.
- **format** (string) - Optional - Output file format (webp, png). Default: webp.
- **aspect** (string) - Optional - Aspect ratio behavior (square, height). Default: square.

### Request Example
GET https://img.motomarks.io/toyota?size=lg&type=full&format=png&token=YOUR_API_KEY
```

--------------------------------

### List All Brands

Source: https://motomarks.io/docs/api-reference

Retrieve a list of all available automotive brands.

```http
GET https://api.motomarks.io/brands
```

--------------------------------

### Display Car Logo with React/Next.js

Source: https://motomarks.io/docs

Integrate car logos in a React or Next.js application using the Image component. The logo slug and publishable API key (from environment variables) are used to construct the image source URL.

```javascript
import Image from "next/image";

function CarBrandLogo({ slug }: { slug: string }) {
  return (
    <Image
      src={`https://img.motomarks.io/${slug}?token=${process.env.NEXT_PUBLIC_MOTOMARKS_KEY}`}
      alt={`${slug} logo`}
      width={128}
      height={128}
    />
  );
}
```

--------------------------------

### Authenticate API Requests

Source: https://motomarks.io/docs/api-reference

Include the API key in the Authorization header for all requests.

```http
Authorization: Bearer YOUR_SECRET_KEY
```

--------------------------------

### Display Toyota Logo with HTML

Source: https://motomarks.io/docs

Use a simple HTML image tag to display a car logo from the Motomarks CDN. Include your publishable API token as a query parameter. Logos are automatically optimized for WebP and AVIF.

```html
<img
  src="https://img.motomarks.io/toyota?token=YOUR_PUBLISHABLE_KEY"
  alt="Toyota logo"
/>
```

--------------------------------

### Add Attribution Link

Source: https://motomarks.io/docs/platform/attribution

Include this HTML anchor tag on any page displaying Motomarks logos to satisfy attribution requirements.

```html
<a href="https://motomarks.io">Logos provided by Motomarks</a>
```
Tokens:
Raw