Skip to content

About Product Vendor

Access scope

Multiple access scopes needed — refer to each endpoint for access scope requirements.

vendor Search is a core search functionality within Genstore's product vendor system, providing quick vendor retrieval capabilities through efficient RESTful interfaces. This feature aims to optimize vendor discovery experience, improve product finding efficiency, and help merchants build better product vendor navigation systems.

Core Features

Support flexible searching through vendor names, helping users quickly locate target vendor.

Use Cases

  • vendor Navigation Enhancement: E-commerce managers can organize product hierarchies, customize vendor relationships, and optimize search parameters through the API, enabling customers to quickly find relevant products and improve discovery efficiency.
  • Smart Product Recommendations: Marketing teams can leverage vendor data to configure related product suggestions, implement cross-vendor promotions, and personalize product discovery flows, increasing customer engagement and conversion rates.

Endpoints

GET /api/202412/vendors: Get product vendor list

Product vendor Object

The product vendor object.

Properties

productVendorobject
The product vendor.
- Hide child properties
vendorIdnumber
An unsigned 64-bit integer that's used as a unique identifier for the product vendor.
vendorNamestring
The name of the product vendor.
bash
{
  "productVendor": {
    "vendorId": "209148956145",
    "vendorName": "apple"
  }
}

GET Get product vendor list

Get product vendor list.

Access scope

Requires ANY of the following access scopes: read_product_vendor write_product_vendor

Endpoint

GET /api/202412/vendors 

Request Params

vendorNamestring
The name of the product vendor.
sinceIdstring
Start querying from a specific resource ID, primarily used for initiating pagination from a specific position.
limitstring
Page count limit, default limit is 50.
pageTokenstring
A pagination cursor that marks the position of a specific page. Defaults to the first page.

Response Data

productVendorsarray
The product vendor.
- Hide child properties
vendorIdstring
An unsigned 64-bit integer that's used as a unique identifier for the product vendor.
vendorNamestring
The name of the product vendor.
bash
curl -X GET \ 
https://{shop}.genmystore.com/api/202412/vendors" \ 
-H "X-Genstore-Access-Token: {access_token}" \
json
HTTP/1.1 200 OK
{
  "productVendors": [
    {
      "vendorId": "209148956145",
      "vendorName": "apple"
    }
  ]
}