BizKitHub
DocsAPI ReferenceProduct Import/bff/product-import/from-url
postProduct ImportAdmin BFF

/bff/product-import/from-url

Fetches the URL, runs an LLM to extract structured product data (name, description, price, images, attributes), creates a new shop__product row with a generated code/slug and queues its images for async blob storage. Deduplicated by (vendor, external_id) — repeated calls with the same listing return the existing product.

ProductImportpostBffProduct-importFrom-url

Parameters

JSON body

Request body

application/json
urlstringRequired

Absolute http(s) URL of the source product/listing page.

Length: 8
Examplehttps://www.sreality.cz/detail/pronajem/komercni/obchodni-prostor/brno/310894668
mainCategoryCodestringOptional

Optional product category code to pre-assign to the imported product.

Examplereal-estate

Response schema

1 status code documented

200Success
successbooleanRequired
codestringRequired

Generated product code (use for /product/{code}).

slugstringRequired

Generated URL slug.

reusedbooleanRequired

True when the product already existed and was not re-imported.

Response example

application/json
{
  "success": false,
  "code": "example_code",
  "slug": "example_slug",
  "reused": false
}

Request example

POST /bff/product-import/from-url

post
curl -X POST "https://api.bizkithub.com/bff/product-import/from-url" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "url": "https://www.sreality.cz/detail/pronajem/komercni/obchodni-prostor/brno/310894668",
  "mainCategoryCode": "real-estate"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key