Mezger Listings

Dealer Integration Options

Multiple ways to sync your dealership inventory with Mezger Marketplace

REST API

Direct integration via our REST API

Use our REST API to programmatically manage your listings. Perfect for custom integrations with your existing inventory management system.

Webhooks

Real-time updates via webhooks

Set up webhooks to automatically sync changes from your website to our marketplace in real-time. Ideal for keeping listings in sync.

XML/CSV Feed

Scheduled imports via data feeds

Provide an XML or CSV feed of your inventory that we can import on a regular schedule. Simple to set up with minimal technical requirements.

REST API Documentation

Integrate your dealer inventory system directly with our API

Authentication

All API requests require an API key that should be included in the request headers.

X-API-Key: your_api_key_here

Base URL

All API requests should be made to:

https://api.mezger-marketplace.com/v1

Endpoints

Sync Inventory

POST /dealer-sync

Send your complete inventory or updates to existing listings.

// Request
POST /dealer-sync
{
  "dealerId": "your_dealer_id",
  "dealerName": "Your Dealership Name",
  "items": [
    {
      "id": "your_item_id_1",
      "type": "car", // or "part"
      "title": "2007 Porsche 997 GT3",
      "description": "Detailed description...",
      "price": 92000,
      "currency": "USD",
      "condition": "Very Good",
      "mileage": 38500,
      "year": 2007,
      "make": "Porsche",
      "model": "911",
      "trim": "GT3",
      "vin": "WP0AC29977S792213",
      "location": "Miami, FL",
      "images": [
        "https://your-site.com/images/car1-1.jpg",
        "https://your-site.com/images/car1-2.jpg"
      ],
      "features": ["Mezger Engine", "Manual Transmission"],
      "contactInfo": "sales@yourdealership.com"
    }
  ]
}
// Response
{
  "success": true,
  "message": "Successfully synced 1 listings for Your Dealership Name",
  "syncedAt": "2023-06-15T14:22:31.000Z"
}

Get Listings

GET /dealer-listings

Retrieve your current listings on the marketplace.

// Request
GET /dealer-listings?dealerId=your_dealer_id
// Response
{
  "success": true,
  "listings": [
    {
      "id": "marketplace_id_1",
      "originalId": "your_item_id_1",
      "title": "2007 Porsche 997 GT3",
      "price": 92000,
      "status": "active",
      "createdAt": "2023-06-15T14:22:31.000Z",
      "updatedAt": "2023-06-15T14:22:31.000Z",
      "url": "https://mezger-marketplace.com/listings/cars/marketplace_id_1"
    }
  ],
  "total": 1
}

Delete Listing

DELETE /dealer-listings/{originalId}

Remove a listing from the marketplace.

// Request
DELETE /dealer-listings/your_item_id_1
X-API-Key: your_api_key_here
// Response
{
  "success": true,
  "message": "Listing successfully removed"
}

Rate Limits

API requests are limited to 100 requests per minute per API key. If you exceed this limit, you'll receive a 429 Too Many Requests response.

Error Handling

The API returns standard HTTP status codes and a JSON response with error details.

// Error Response Example
{
  "error": "Invalid data format",
  "details": "Missing required field: price",
  "code": "VALIDATION_ERROR"
}

Getting Started

  1. Register for a Dealer Account

    Sign up for a dealer account on Mezger Marketplace to get access to our integration tools.

  2. Generate API Keys

    Once registered, generate API keys from your dealer dashboard to authenticate your integration.

  3. Choose Your Integration Method

    Select the integration method that works best for your business needs and technical capabilities.

  4. Test Your Integration

    Use our sandbox environment to test your integration before going live.

  5. Go Live

    Once testing is complete, switch to production mode and start syncing your inventory.

Need Help?

Our integration team is available to assist you with setting up your dealer integration.