BizKitHub
DocsAPI ReferenceProduct/api/v1/product/feed
getProductPublic API v1

/api/v1/product/feed

Load full list of products from organisation database. By default, we only return basic properties for all products. If you want to return entire products, you need to specify additional properties.

Default properties (contains in all returned products): id, name, slug, shortDescription, mainImageUrl, mainCategory, price, priceWithoutVat, vat, position, active, soldOut, warehouseAllQuantity, warehouseLimit, customFields, event.

productgetApiV1ProductFeed

Parameters

8 query

Query parameters

· 8
apiKeystringRequired

Your BizKitHub API key (passed as GET parameter).

Key format: A 32-character string matching: ^(PROD|DEV_|ROOT)[A-Za-z0-9]{28}$
Prefixes: PROD (production key), DEV_ (individual developer), ROOT (system key with no limits). Learn more

ExamplePRODPGrFxpGEtrOZfuWhnoJohUYBXuOE
querystringOptional

Search query

Exampleiphone
localestringOptional

Locale code (e.g. "cs", "en"). Returns translated read models for the given locale with fallback to default.

Examplecs
orderBystringOptional

Order by indexed internal field.

Supported values: position, price, priceDesc, eventDate.

Default: position
Exampleposition
categorystringOptional

Filter products from category by slug.

Examplesmartphone
pagestringOptional
Default: 1
Example1
limitstringOptional
Default: 32
Example32
propertiesstringOptional

Add extra on demand properties separated by semicolon.

Supported values:

Property Description
orderStatistics Extra statistics data like totalQuantitySold and count of orders in states.
galleryItemsCount Count of public images in product detail.
ExampleorderStatistics;galleryItemsCount

Response schema

1 status code documented

200SuccessPaginated product feed response.
countnumberRequired

Number of items returned on this page. For the total number of items matching the filter across all pages use totalCount.

totalCountnumberRequired

Total number of products matching the filter (query + category), independent of page and limit. Use Math.ceil(totalCount / limit) to compute the page count.

itemsobject[]Required

List of product feed items.

Each array item:

Product feed item. Returned properties depend on the properties query parameter.

idnumberRequired

Internal product ID.

Example42
namestringRequired

Localized product name.

ExampleCheese Burger
slugstringRequired

URL-friendly product identifier.

Examplecheese-burger
shortDescriptionstringOptional

Short HTML description.

mainImageUrlstringOptional

URL of the main product image.

mainCategoryobjectOptional

Product category reference.

slugstringRequired

URL-friendly category identifier.

Examplesmartphone
codestringRequired

Internal category code.

ExampleCAT-001
namestringRequired

Localized category name.

ExampleSmartphones
pricenumberRequired

Product price including VAT.

Example250
priceWithoutVatnumberOptional

Product price excluding VAT.

vatnumberOptional

VAT percentage rate.

positionnumberRequired

Display position for sorting.

Example1
activebooleanRequired

Whether the product is active.

soldOutbooleanRequired

Whether the product is sold out.

warehouseAllQuantitynumberOptional

Total available warehouse quantity.

warehouseLimitnumberOptional

Minimum warehouse quantity threshold.

customFieldsobjectOptional

Custom key-value fields.

eventobjectOptional

Calendar event linked to the product.

idstringRequired

Event code identifier.

startTimeDate | string | string | numberRequired

Event start date and time.

One of 4:
Variant 1
Date

Event start date and time.

Variant 2
stringdate-time
Variant 3
stringdate
Variant 4
number
endTimeDate | string | string | numberRequired

Event end date and time.

One of 4:
Variant 1
Date

Event end date and time.

Variant 2
stringdate-time
Variant 3
stringdate
Variant 4
number
isAllDaybooleanRequired

Whether the event spans the entire day.

isBlockingbooleanRequired

Whether the event blocks other bookings.

titlestringRequired

Event title.

descriptionstringOptional

Event description text.

agendastringOptional

Event agenda or schedule.

urlstringOptional

External URL for the event.

locationTitlestringOptional

Name of the event location.

orderStatisticsobjectOptional

Aggregated order statistics for the product.

totalQuantitySoldnumberRequired

Total quantity sold across all order statuses.

statusNewnumberRequired

Quantity in new orders.

statusProcessingnumberRequired

Quantity in processing orders.

statusStornonumberRequired

Quantity in canceled orders.

statusDonenumberRequired

Quantity in completed orders.

galleryItemsCountnumberOptional

Count of public images in product detail.

Response example

application/json
{
  "count": 0,
  "totalCount": 0,
  "items": [
    {
      "id": 42,
      "name": "Cheese Burger",
      "slug": "cheese-burger",
      "shortDescription": "example_shortDescription",
      "mainImageUrl": "example_mainImageUrl",
      "mainCategory": {
        "slug": "smartphone",
        "code": "CAT-001",
        "name": "Smartphones"
      },
      "price": 250,
      "priceWithoutVat": 0,
      "vat": 0,
      "position": 1,
      "active": false,
      "soldOut": false,
      "warehouseAllQuantity": 0,
      "warehouseLimit": 0,
      "customFields": {},
      "event": {
        "id": "example_id",
        "isAllDay": false,
        "isBlocking": false,
        "title": "example_title",
        "description": "example_description",
        "agenda": "example_agenda",
        "url": "example_url",
        "locationTitle": "example_locationTitle"
      },
      "orderStatistics": {
        "totalQuantitySold": 0,
        "statusNew": 0,
        "statusProcessing": 0,
        "statusStorno": 0,
        "statusDone": 0
      },
      "galleryItemsCount": 0
    }
  ]
}

Request example

GET /api/v1/product/feed

get
curl -X GET "https://api.bizkithub.com/api/v1/product/feed?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&query=iphone&locale=cs&orderBy=position&category=smartphone&page=1&limit=32&properties=orderStatistics%3BgalleryItemsCount" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key