Sellers API

Access seller profile information, listings, and reviews.

Public Endpoints

Method	Endpoint	Description	Auth
GET	/api/sellers/:slug	Get seller profile by slug	No
GET	/api/sellers/:slug/listings	Get seller's active listings	No
GET	/api/sellers/:slug/reviews	Get seller reviews	No
POST	/api/sellers/:slug/reviews	Create a review	Required
POST	/api/sellers/:slug/reviews/:reviewId/respond	Respond to review	Seller

Authenticated Seller Endpoints

Method	Endpoint	Description	Auth
GET	/api/sellers/me	Get own seller profile	Seller
PUT	/api/sellers/me	Update own profile	Seller
GET	/api/seller/dashboard	Seller dashboard stats	Seller
GET	/api/seller/analytics	Seller analytics	Seller
GET	/api/seller/profile	Get seller profile	Seller
PUT	/api/seller/profile	Update seller profile	Seller

List Sellers

Retrieve a list of sellers.

Request

GET /v1/sellers
Authorization: Bearer YOUR_API_KEY

Query Parameters

Parameter	Type	Description
page	integer	Page number
limit	integer	Items per page
type	string	individual, business
verified	boolean	Only verified sellers
country	string	Filter by country
sort	string	Sort field

Response

{
  "success": true,
  "data": {
    "sellers": [
      {
        "id": "sel_abc123",
        "name": "ABC Trucks GmbH",
        "type": "business",
        "logo": "https://cdn.menonmobility.com/sellers/abc.jpg",
        "location": {
          "country": "Germany",
          "city": "Munich"
        },
        "verified": true,
        "trust_score": 92,
        "listing_count": 45,
        "rating": {
          "average": 4.8,
          "count": 127
        },
        "member_since": "2020-03-15"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1250
    }
  }
}

Get Seller Profile

Retrieve detailed seller information.

Request

GET /v1/sellers/sel_abc123
Authorization: Bearer YOUR_API_KEY

Response

{
  "success": true,
  "data": {
    "id": "sel_abc123",
    "name": "ABC Trucks GmbH",
    "type": "business",
    "description": "Leading commercial vehicle dealer...",
    "logo": "https://cdn.menonmobility.com/sellers/abc.jpg",
    "cover_image": "https://cdn.menonmobility.com/sellers/abc_cover.jpg",
    "contact": {
      "phone": "+49 123 456789",
      "email": "contact@abctrucks.com",
      "website": "https://www.abctrucks.com",
      "whatsapp": "+49 123 456789"
    },
    "location": {
      "country": "Germany",
      "country_code": "DE",
      "region": "Bavaria",
      "city": "Munich",
      "address": "123 Example Street",
      "coordinates": {
        "lat": 48.1351,
        "lng": 11.5820
      }
    },
    "business_info": {
      "registration_number": "HRB 123456",
      "tax_id": "DE123456789",
      "founded": 2010
    },
    "verification": {
      "email": true,
      "phone": true,
      "identity": true,
      "business": true
    },
    "trust_score": 92,
    "badges": ["verified", "business", "top_rated"],
    "statistics": {
      "listing_count": 45,
      "total_sales": 320,
      "response_rate": 98,
      "response_time": "< 1 hour"
    },
    "rating": {
      "average": 4.8,
      "count": 127,
      "distribution": {
        "5": 98,
        "4": 22,
        "3": 5,
        "2": 1,
        "1": 1
      }
    },
    "hours": {
      "monday": { "open": "08:00", "close": "18:00" },
      "tuesday": { "open": "08:00", "close": "18:00" },
      "wednesday": { "open": "08:00", "close": "18:00" },
      "thursday": { "open": "08:00", "close": "18:00" },
      "friday": { "open": "08:00", "close": "17:00" },
      "saturday": { "open": "09:00", "close": "13:00" },
      "sunday": null
    },
    "social": {
      "facebook": "https://facebook.com/abctrucks",
      "instagram": "https://instagram.com/abctrucks",
      "linkedin": "https://linkedin.com/company/abctrucks"
    },
    "member_since": "2020-03-15",
    "last_active": "2024-01-15T14:30:00Z"
  }
}

Get Seller Listings

Retrieve listings from a specific seller.

Request

GET /v1/sellers/sel_abc123/listings
Authorization: Bearer YOUR_API_KEY

Query Parameters

Parameter	Type	Description
page	integer	Page number
limit	integer	Items per page
status	string	active, sold (public only shows active)
category	string	Filter by category
sort	string	Sort field

Response

{
  "success": true,
  "data": {
    "listings": [
      {
        "id": "lst_123",
        "title": "2021 Volvo FH 500",
        "price": 85000,
        "currency": "EUR",
        "thumbnail": "https://cdn.menonmobility.com/thumb.jpg",
        "year": 2021,
        "mileage": 245000,
        "category": "trucks",
        "featured": true
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 45
    }
  }
}

Get Current Seller (Me)

Get the authenticated seller's profile.

Request

GET /v1/sellers/me
Authorization: Bearer YOUR_API_KEY

Returns full seller profile with additional private fields.

Update Seller Profile

Update the authenticated seller's profile.

Request

PUT /v1/sellers/me
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Body

{
  "name": "ABC Trucks GmbH",
  "description": "Updated description...",
  "contact": {
    "phone": "+49 123 456789",
    "website": "https://www.abctrucks.com"
  },
  "location": {
    "address": "New Address 456"
  },
  "hours": {
    "saturday": { "open": "10:00", "close": "14:00" }
  }
}

Response

{
  "success": true,
  "data": {
    "id": "sel_abc123",
    "name": "ABC Trucks GmbH",
    "updated_at": "2024-01-15T16:30:00Z"
  }
}

Seller Reviews

Get Seller Reviews

GET /v1/sellers/sel_abc123/reviews
Authorization: Bearer YOUR_API_KEY

Query Parameters

Parameter	Type	Description
page	integer	Page number
limit	integer	Items per page
rating	integer	Filter by rating
sort	string	recent, rating_high, rating_low

Response

{
  "success": true,
  "data": {
    "reviews": [
      {
        "id": "rev_123",
        "rating": 5,
        "title": "Excellent experience",
        "comment": "Professional and helpful...",
        "reviewer": {
          "name": "John D.",
          "verified": true
        },
        "listing": {
          "id": "lst_456",
          "title": "2021 Volvo FH 500"
        },
        "response": {
          "comment": "Thank you for your feedback!",
          "date": "2024-01-10"
        },
        "created_at": "2024-01-08"
      }
    ],
    "summary": {
      "average": 4.8,
      "count": 127,
      "distribution": {
        "5": 98,
        "4": 22,
        "3": 5,
        "2": 1,
        "1": 1
      }
    }
  }
}

Upload Seller Images

Upload Logo

POST /v1/sellers/me/logo
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

logo: [file]

Upload Cover Image

POST /v1/sellers/me/cover
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

cover: [file]

Seller Statistics

Get Statistics

GET /v1/sellers/me/statistics
Authorization: Bearer YOUR_API_KEY

Query Parameters

Parameter	Type	Description
period	string	7d, 30d, 90d, 1y

Response

{
  "success": true,
  "data": {
    "period": "30d",
    "views": {
      "total": 12500,
      "change": 15.5
    },
    "inquiries": {
      "total": 320,
      "change": 8.2
    },
    "favorites": {
      "total": 450,
      "change": 12.1
    },
    "response_rate": 98,
    "response_time_hours": 0.8,
    "top_listings": [
      {
        "id": "lst_123",
        "title": "2021 Volvo FH 500",
        "views": 850,
        "inquiries": 24
      }
    ]
  }
}

Related Topics

• Listings API
• Messages API