/api/v1/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 with reused: true.

productpostApiV1ProductImport-from-url

Parameters

1 query · JSON body

Query parameters

· 1

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

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

object | object

One of 2:

Variant 1

state"ok"Required

codestringRequired

Generated product code (use for /product/detail?slug=…).

slugstringRequired

Generated URL slug.

reusedbooleanRequired

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

Variant 2

state"error"Required

messagestringRequired

code"200"Required

hintstring | nullRequired

One of 2:

Variant 1

string

Variant 2

null

Response example

application/json

{
  "state": "ok",
  "code": "example_code",
  "slug": "example_slug",
  "reused": false
}

Request example

POST /api/v1/product/import-from-url

post

curl -X POST "https://api.bizkithub.com/api/v1/product/import-from-url?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE" \
  -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