Manufacturer List and Detailpage

Store API

PremsManufacturer provides three store-api routes for retrieving manufacturer data from composable storefronts or custom frontends.

Load Manufacturer List

Returns a paginated list of manufacturers, optionally filtered by starting letter or search term.

Endpoint: POST /store-api/prems-manufacturer/list
Login required: No

Parameter Type Required Description
page int No Page number (starting at 1). Default: 1.
limit int No Number of manufacturers per page. Default: 24.
letter string No Starting letter (A–Z) or "0-9" for numeric manufacturers.
search string No Search term inside the manufacturer name (contains filter).

Response: Returns a manufacturer collection with total count and — if the Advanced version is active — a list of letters that have at least one manufacturer for the A-Z navigation.

Errors:

  • The free version returns at most 5 manufacturers; the A-Z letter list is empty.

Load Manufacturer Detail

Returns a single manufacturer including a fully-featured product listing.

Endpoint: POST /store-api/prems-manufacturer/detail/{manufacturerId}
Login required: No

Parameter Type Required Description
manufacturerId string Yes Manufacturer ID, taken from the URL path.
order string No Sorting key (see core.listing.defaultSorting).
p int No Product list page.
limit int No Products per page.
manufacturer-filter, rating-filter, price-filter, shipping-free-filter, property-filter bool No Toggles individual listing filters (same semantics as Shopware's standard listing filters).

Response: Returns the manufacturer entity and the product listing with available sortings, aggregations, applied filters, and the current filter state.

Errors:

  • 404 – No manufacturer exists with the given ID.

Manufacturer Suggest

Returns a reduced manufacturer list for the search suggest dropdown in the header.

Endpoint: POST /store-api/prems-manufacturer/suggest
Login required: No

Parameter Type Required Description
search string No Search term (contains filter on the manufacturer name).
limit int No Maximum number of results (1–20). Default: 5.

Response: Returns a small manufacturer collection including the logo media association.

Errors:

  • This route is only available in the Advanced version; the free version always returns an empty collection.