REST API Documentation

Postman collection → OpenAPI spec →

Introduction

REST API for custom integrations with external systems. Allows bulk import of products and categories.

Base URL: https://api.pobo.space

Authenticating requests

To authenticate requests, include an Authorization header with the value "Bearer {YOUR_AUTH_KEY}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

You can retrieve your token by visiting your dashboard and clicking Generate API token.

API V2 (Multilang)

Products

Product list

GET

https://api.pobo.space

/api/v2/rest/products

requires authentication

Get paginated list of products with content in all active languages. Only returns products with is_delete=false (includes both visible and hidden products). Language variants are returned only if is_active=true.

By default, only content.html is returned. Use the include parameter to request additional content: marketplace (marketplace HTML), nested (raw widget JSON), site_link (anchor navigation on H2 headings), rich_snippet (JSON-LD structured data).

When site_link is included, response contains site_link.html (rendered nav HTML per language) and site_link.list (structured array of heading + slug per language). Requires enable_site_link to be enabled on the eshop.

When rich_snippet is included, response contains rich_snippet.html (JSON-LD script tags per language) and rich_snippet.json (parsed JSON-LD object per language). Requires enable_rich_snippet to be enabled on the eshop.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

page

integer

The page number. Default: 1.

Example:

per_page

integer

Items per page. Maximum: 100, Default: 100.

Example:

is_edited

boolean

Filter by edited status (is_loaded). Default: true.

Example:

true

last_update_time_from

string

Filter products updated after this datetime. Format: Y-m-d H:i:s.

Example:

2024-01-01 14:30:00

include

string

Comma-separated list of additional content to include: nested, marketplace, site_link, rich_snippet.

Example:

marketplace,nested,site_link,rich_snippet

lang

string

Comma-separated list of languages to include: default, cs, sk, en, de, pl, hu, all. Without this parameter only "default" is returned.

Example:

default,cs,sk

Auth

Bearer

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.pobo.space/api/v2/rest/products?page=1&per_page=50&is_edited=1&last_update_time_from=2024-01-01+14%3A30%3A00&include=marketplace%2Cnested%2Csite_link%2Crich_snippet&lang=default%2Ccs%2Csk" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "PROD-001",
            "guid": "550e8400-e29b-41d4-a716-446655440000",
            "is_visible": true,
            "is_loaded": false,
            "image_preview": "https://example.com/preview.jpg",
            "name": {
                "default": "Product Name",
                "sk": "Názov produktu"
            },
            "short_description": {
                "default": "Short description",
                "sk": "Krátky popis"
            },
            "description": {
                "default": "<p>Full description</p>",
                "sk": "<p>Plný popis</p>"
            },
            "url": {
                "default": "https://example.com/product",
                "sk": "https://example.com/sk/produkt"
            },
            "seo_title": {
                "default": "SEO Title",
                "sk": "SEO Názov"
            },
            "seo_description": {
                "default": "SEO Description",
                "sk": "SEO Popis"
            },
            "content": {
                "html": {
                    "default": "<div class=\"pobo-content\">...</div>",
                    "cs": "..."
                },
                "marketplace": {
                    "default": "<div class=\"pobo-content\">...</div>",
                    "cs": "..."
                },
                "nested": [
                    [
                        {
                            "id": 2,
                            "class": "empty",
                            "tag": "div",
                            "children": []
                        }
                    ]
                ]
            },
            "site_link": {
                "html": {
                    "default": "<div id=\"pobo-site-link\" class=\"pobo-site-link__container\"><nav class=\"pobo-site-link__nav\"><a href=\"#nadpis\" class=\"pobo-site-link__anchor\">Nadpis</a></nav></div>"
                },
                "list": {
                    "default": [
                        {
                            "heading": "Nadpis",
                            "slug": "nadpis"
                        }
                    ]
                }
            },
            "rich_snippet": {
                "html": {
                    "default": "<script type=\"application/ld+json\">{...}</script>"
                },
                "json": {
                    "default": {
                        "@context": "https://schema.org",
                        "@type": "FAQPage",
                        "mainEntity": []
                    }
                }
            },
            "created_at": "2024-01-15T10:30:00.000000Z",
            "updated_at": "2024-01-16T14:20:00.000000Z"
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 100,
        "total": 150
    }
}

Bulk import products

POST

https://api.pobo.space

/api/v2/rest/products

requires authentication

Import or update multiple products at once with multilingual content. Maximum 100 products per request. Invalid products will be skipped and reported in the errors array.

Supported languages: default, cs, sk, en, de, pl, hu

Validation rules:

name.default and url.default are always required
If a language key exists anywhere in the request, name.{lang} and url.{lang} are required
Other multilang fields (short_description, description, seo_title, seo_description) can be null but keys must exist
URL must start with https://
Unsupported languages are silently ignored

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

object

string

required

The unique identifier of the product. Maximum 255 characters.

Example:

PROD-123-ABC

is_visible

boolean

required

Whether the product is visible.

Example:

true

images

string[]

nullable Array of image URLs. First image will be set as preview.

Example:

["https:\/\/example.com\/img1.jpg","https:\/\/example.com\/img2.jpg"]

categories_ids

string[]

nullable Array of category IDs.

Example:

["CAT-001","CAT-002"]

brand_id

string

nullable External brand identifier (mapped to brand.remote_id). Optional and backwards compatible: when the key is absent, the existing product.brand_id is preserved; null clears the brand link; a string must reference an existing brand for the eshop.

Example:

BRAND-001

parameters_ids

string[]

nullable Array of parameter value IDs.

Example:

[1,2,3]

name

object

required

Object with language keys.

url

object

required

Object with language keys. Must start with https://.

short_description

object

nullable Object with language keys.

description

object

nullable Object with language keys. Supports HTML.

seo_title

object

nullable Object with language keys.

seo_description

object

nullable Object with language keys.

Auth

Bearer

Headers

Body

{ "*": { "id": "PROD-123-ABC", "is_visible": true, "images": [ "https:\/\/example.com\/img1.jpg", "https:\/\/example.com\/img2.jpg" ], "categories_ids": [ "CAT-001", "CAT-002" ], "brand_id": "BRAND-001", "parameters_ids": [ 1, 2, 3 ], "name": { "default": "Product Name", "*": "N\u00e1zov produktu" }, "url": { "default": "https:\/\/example.com\/product", "*": "https:\/\/example.com\/sk\/produkt" }, "short_description": { "*": "voluptas" }, "description": { "*": "est" }, "seo_title": { "*": "tempora" }, "seo_description": { "*": "distinctio" } } }

Received response

Example request:

curl --request POST \
    "https://api.pobo.space/api/v2/rest/products" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"*\": {
        \"id\": \"PROD-123-ABC\",
        \"is_visible\": true,
        \"images\": [
            \"https:\\/\\/example.com\\/img1.jpg\",
            \"https:\\/\\/example.com\\/img2.jpg\"
        ],
        \"categories_ids\": [
            \"CAT-001\",
            \"CAT-002\"
        ],
        \"brand_id\": \"BRAND-001\",
        \"parameters_ids\": [
            1,
            2,
            3
        ],
        \"name\": {
            \"default\": \"Product Name\",
            \"sk\": \"Názov produktu\",
            \"*\": \"Názov produktu\"
        },
        \"url\": {
            \"default\": \"https:\\/\\/example.com\\/product\",
            \"sk\": \"https:\\/\\/example.com\\/sk\\/produkt\",
            \"*\": \"https:\\/\\/example.com\\/sk\\/produkt\"
        },
        \"short_description\": {
            \"default\": \"Short desc\",
            \"sk\": \"Krátky popis\",
            \"*\": \"voluptas\"
        },
        \"description\": {
            \"default\": \"<p>Full description<\\/p>\",
            \"sk\": \"<p>Plný popis<\\/p>\",
            \"*\": \"est\"
        },
        \"seo_title\": {
            \"default\": \"SEO Title\",
            \"sk\": \"SEO Názov\",
            \"*\": \"tempora\"
        },
        \"seo_description\": {
            \"default\": \"SEO Description\",
            \"sk\": \"SEO Popis\",
            \"*\": \"distinctio\"
        }
    }
}"

$client = new \GuzzleHttp\Client();
$url = 'https://api.pobo.space/api/v2/rest/products';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            '*' => [
                'id' => 'PROD-123-ABC',
                'is_visible' => true,
                'images' => [
                    'https://example.com/img1.jpg',
                    'https://example.com/img2.jpg',
                ],
                'categories_ids' => [
                    'CAT-001',
                    'CAT-002',
                ],
                'brand_id' => 'BRAND-001',
                'parameters_ids' => [
                    1,
                    2,
                    3,
                ],
                'name' => [
                    'default' => 'Product Name',
                    'sk' => 'Názov produktu',
                    '*' => 'Názov produktu',
                ],
                'url' => [
                    'default' => 'https://example.com/product',
                    'sk' => 'https://example.com/sk/produkt',
                    '*' => 'https://example.com/sk/produkt',
                ],
                'short_description' => [
                    'default' => 'Short desc',
                    'sk' => 'Krátky popis',
                    '*' => 'voluptas',
                ],
                'description' => [
                    'default' => '<p>Full description</p>',
                    'sk' => '<p>Plný popis</p>',
                    '*' => 'est',
                ],
                'seo_title' => [
                    'default' => 'SEO Title',
                    'sk' => 'SEO Názov',
                    '*' => 'tempora',
                ],
                'seo_description' => [
                    'default' => 'SEO Description',
                    'sk' => 'SEO Popis',
                    '*' => 'distinctio',
                ],
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Example response:

{
    "success": true,
    "imported": 2,
    "updated": 1,
    "skipped": 1,
    "errors": [
        {
            "index": 3,
            "id": "PROD-004",
            "errors": [
                "The name.sk field is required when using language sk."
            ]
        }
    ]
}

Bulk delete products

DELETE

https://api.pobo.space

/api/v2/rest/products

requires authentication

Soft-delete multiple products at once by setting is_delete = true. Maximum 100 products per request. Products that don't exist or are already deleted will be skipped.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

object

Auth

Bearer

Headers

Body

{ "*": { "id": "PROD-123-ABC" } }

Received response

Example request:

curl --request DELETE \
    "https://api.pobo.space/api/v2/rest/products" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \

Example response:

{
    "success": true,
    "deleted": 2,
    "skipped": 1,
    "errors": [
        {
            "index": 2,
            "id": "PROD-999",
            "errors": [
                "Product not found"
            ]
        }
    ]
}

Category list

GET

https://api.pobo.space

/api/v2/rest/categories

requires authentication

Get paginated list of categories with content in all active languages. Only returns categories with is_delete=false (includes both visible and hidden categories). Language variants are returned only if is_active=true.

By default, only content.html is returned. Use the include parameter to request additional content: marketplace (marketplace HTML), nested (raw widget JSON), rich_snippet (JSON-LD structured data).

Note: site_link is not available for categories.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

page

integer

The page number. Default: 1.

Example:

per_page

integer

Items per page. Maximum: 100, Default: 100.

Example:

is_edited

boolean

Filter by edited status (is_loaded). Default: true.

Example:

true

last_update_time_from

string

Filter categories updated after this datetime. Format: Y-m-d H:i:s.

Example:

2024-01-01 14:30:00

include

string

Comma-separated list of additional content to include: nested, marketplace, rich_snippet.

Example:

marketplace,nested,rich_snippet

lang

string

Comma-separated list of languages to include: default, cs, sk, en, de, pl, hu, all. Without this parameter only "default" is returned.

Example:

default,cs,sk

Auth

Bearer

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.pobo.space/api/v2/rest/categories?page=1&per_page=50&is_edited=1&last_update_time_from=2024-01-01+14%3A30%3A00&include=marketplace%2Cnested%2Crich_snippet&lang=default%2Ccs%2Csk" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "CAT-001",
            "guid": "550e8400-e29b-41d4-a716-446655440000",
            "is_visible": true,
            "is_loaded": false,
            "name": {
                "default": "Electronics",
                "sk": "Elektronika"
            },
            "description": {
                "default": "<p>Electronics category</p>",
                "sk": "<p>Kategoria elektroniky</p>"
            },
            "url": {
                "default": "https://example.com/electronics",
                "sk": "https://example.com/sk/elektronika"
            },
            "seo_title": {
                "default": "Electronics | Shop",
                "sk": "Elektronika | Obchod"
            },
            "seo_description": {
                "default": "Best electronics",
                "sk": "Najlepsia elektronika"
            },
            "content": {
                "html": {
                    "default": "<div class=\"pobo-content\">...</div>",
                    "cs": "..."
                },
                "marketplace": {
                    "default": "<div class=\"pobo-content\">...</div>",
                    "cs": "..."
                },
                "nested": [
                    [
                        {
                            "id": 2,
                            "class": "empty",
                            "tag": "div",
                            "children": []
                        }
                    ]
                ]
            },
            "rich_snippet": {
                "html": {
                    "default": "<script type=\"application/ld+json\">{...}</script>"
                },
                "json": {
                    "default": {
                        "@context": "https://schema.org",
                        "@type": "FAQPage",
                        "mainEntity": []
                    }
                }
            },
            "created_at": "2024-01-15T10:30:00.000000Z",
            "updated_at": "2024-01-16T14:20:00.000000Z"
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 100,
        "total": 50
    }
}

Bulk import categories

POST

https://api.pobo.space

/api/v2/rest/categories

requires authentication

Import or update multiple categories at once with multilingual content. Maximum 100 categories per request. Invalid categories will be skipped and reported in the errors array.

Supported languages: default, cs, sk, en, de, pl, hu

Validation rules:

name.default and url.default are always required
If a language key exists anywhere in the request, name.{lang} and url.{lang} are required
Other multilang fields (description, seo_title, seo_description) can be null but keys must exist
URL must start with https://
Unsupported languages are silently ignored

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

object

string

required

The unique identifier of the category. Can be hierarchical (e.g., A01.01.07). Maximum 255 characters.

Example:

A01.01.07

is_visible

boolean

required

Whether the category is visible.

Example:

true

images

string[]

nullable Array of image URLs. First image will be set as preview.

Example:

["https:\/\/example.com\/img1.jpg"]

name

object

required

Object with language keys.

url

object

required

Object with language keys. Must start with https://.

description

object

nullable Object with language keys. Supports HTML.

seo_title

object

nullable Object with language keys.

seo_description

object

nullable Object with language keys.

Auth

Bearer

Headers

Body

{ "*": { "id": "A01.01.07", "is_visible": true, "images": [ "https:\/\/example.com\/img1.jpg" ], "name": { "default": "Electronics", "*": "Elektronika" }, "url": { "default": "https:\/\/example.com\/electronics", "*": "https:\/\/example.com\/sk\/elektronika" }, "description": { "*": "vel" }, "seo_title": { "*": "qui" }, "seo_description": { "*": "sed" } } }

Received response

Example request:

curl --request POST \
    "https://api.pobo.space/api/v2/rest/categories" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"*\": {
        \"id\": \"A01.01.07\",
        \"is_visible\": true,
        \"images\": [
            \"https:\\/\\/example.com\\/img1.jpg\"
        ],
        \"name\": {
            \"default\": \"Electronics\",
            \"sk\": \"Elektronika\",
            \"*\": \"Elektronika\"
        },
        \"url\": {
            \"default\": \"https:\\/\\/example.com\\/electronics\",
            \"sk\": \"https:\\/\\/example.com\\/sk\\/elektronika\",
            \"*\": \"https:\\/\\/example.com\\/sk\\/elektronika\"
        },
        \"description\": {
            \"default\": \"<p>Description<\\/p>\",
            \"sk\": \"<p>Popis<\\/p>\",
            \"*\": \"vel\"
        },
        \"seo_title\": {
            \"default\": \"SEO Title\",
            \"sk\": \"SEO Názov\",
            \"*\": \"qui\"
        },
        \"seo_description\": {
            \"default\": \"SEO Description\",
            \"sk\": \"SEO Popis\",
            \"*\": \"sed\"
        }
    }
}"

Example response:

{
    "success": true,
    "imported": 2,
    "updated": 1,
    "skipped": 1,
    "errors": [
        {
            "index": 3,
            "id": "CAT-004",
            "errors": [
                "The name.sk field is required when using language sk."
            ]
        }
    ]
}

Bulk delete categories

DELETE

https://api.pobo.space

/api/v2/rest/categories

requires authentication

Soft-delete multiple categories at once by setting is_delete = true. Maximum 100 categories per request. Categories that don't exist or are already deleted will be skipped.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

object

Auth

Bearer

Headers

Body

{ "*": { "id": "CAT-123" } }

Received response

Example request:

curl --request DELETE \
    "https://api.pobo.space/api/v2/rest/categories" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \

Example response:

{
    "success": true,
    "deleted": 2,
    "skipped": 1,
    "errors": [
        {
            "index": 2,
            "id": "CAT-999",
            "errors": [
                "Category not found"
            ]
        }
    ]
}

Parameters

Bulk import parameters

POST

https://api.pobo.space

/api/v2/rest/parameters

requires authentication

Import or update multiple parameters with their values at once. Maximum 100 parameters per request. Invalid parameters will be skipped and reported in the errors array.

Note: Parameters do not have multilang support - same structure as V1.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

object

integer

required

The unique identifier of the parameter.

Example:

name

string

required

The name of the parameter. Maximum 255 characters.

Example:

Color

values

string[]

required

Array of parameter values. At least one value is required.

integer

The unique identifier of the parameter value.

Example:

value

string

The value of the parameter. Must not be greater than 255 characters.

Example:

Red

object

Auth

Bearer

Headers

Body

{ "*": { "id": 1, "name": "Color", "values": { "id": 1, "value": "Red", "*": { "id": 1, "value": "Red" } } } }

Received response

Example request:

curl --request POST \
    "https://api.pobo.space/api/v2/rest/parameters" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"*\": {
        \"id\": 1,
        \"name\": \"Color\",
        \"values\": [
            {
                \"id\": 1,
                \"value\": \"Red\"
            },
            {
                \"id\": 2,
                \"value\": \"Blue\"
            }
        ]
    }
}"

Example response:

{
    "success": true,
    "imported": 2,
    "updated": 1,
    "skipped": 0,
    "values_imported": 5,
    "values_updated": 2,
    "errors": []
}

Brands

Brand list

GET

https://api.pobo.space

/api/v2/rest/brands

requires authentication

Get paginated list of brands with content in selected languages. Only returns brands with is_delete=false (includes both visible and hidden brands). The id field in response is the external identifier (mapped to brand.remote_id).

By default only content.html is returned. Use the include parameter to request additional content: marketplace, nested, site_link, rich_snippet.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

page

integer

The page number. Default: 1.

Example:

per_page

integer

Items per page. Maximum: 100, Default: 100.

Example:

is_edited

boolean

Filter by edited status (is_loaded). Default: true.

Example:

true

last_update_time_from

string

Filter brands updated after this datetime. Format: Y-m-d H:i:s.

Example:

2024-01-01 14:30:00

include

string

Comma-separated list of additional content to include: nested, marketplace, site_link, rich_snippet.

Example:

marketplace,nested,site_link,rich_snippet

lang

string

Comma-separated list of languages to include: default, cs, sk, en, de, pl, hu, all. Without this parameter only "default" is returned.

Example:

default,cs,sk

Auth

Bearer

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.pobo.space/api/v2/rest/brands?page=1&per_page=50&is_edited=1&last_update_time_from=2024-01-01+14%3A30%3A00&include=marketplace%2Cnested%2Csite_link%2Crich_snippet&lang=default%2Ccs%2Csk" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "BRAND-001",
            "guid": "550e8400-e29b-41d4-a716-446655440099",
            "is_visible": true,
            "is_loaded": false,
            "image_preview": "https://example.com/brands/apple-logo.png",
            "name": {
                "default": "Apple",
                "cs": "Apple",
                "sk": "Apple SK",
                "en": "Apple EN",
                "de": "Apple DE",
                "pl": "Apple PL",
                "hu": "Apple HU"
            },
            "description": {
                "default": "<p>Brand description</p>",
                "cs": "<p>Popis značky</p>",
                "sk": "<p>Popis značky SK</p>",
                "en": "<p>Brand description EN</p>",
                "de": "<p>Markenbeschreibung</p>",
                "pl": "<p>Opis marki</p>",
                "hu": "<p>Márkaleírás</p>"
            },
            "url": {
                "default": "https://example.com/znacky/apple",
                "cs": "https://example.com/cs/znacky/apple",
                "sk": "https://example.com/sk/znacky/apple",
                "en": "https://example.com/en/brands/apple",
                "de": "https://example.com/de/marken/apple",
                "pl": "https://example.com/pl/marki/apple",
                "hu": "https://example.com/hu/markak/apple"
            },
            "seo_title": {
                "default": "Apple | Eshop",
                "cs": "Apple | E-shop",
                "sk": "Apple | Obchod",
                "en": "Apple | Shop",
                "de": "Apple | Shop",
                "pl": "Apple | Sklep",
                "hu": "Apple | Bolt"
            },
            "seo_description": {
                "default": "SEO description",
                "cs": "SEO popis",
                "sk": "SEO popis SK",
                "en": "SEO description EN",
                "de": "SEO Beschreibung",
                "pl": "Opis SEO",
                "hu": "SEO leírás"
            },
            "content": {
                "html": {
                    "default": "<div class=\"pobo-content\">...</div>",
                    "cs": "<div class=\"pobo-content\">...</div>",
                    "sk": "<div class=\"pobo-content\">...</div>",
                    "en": "<div class=\"pobo-content\">...</div>",
                    "de": "<div class=\"pobo-content\">...</div>",
                    "pl": "<div class=\"pobo-content\">...</div>",
                    "hu": "<div class=\"pobo-content\">...</div>"
                },
                "marketplace": {
                    "default": "<div class=\"pobo-content\">...</div>",
                    "cs": "<div class=\"pobo-content\">...</div>"
                },
                "nested": [
                    [
                        {
                            "id": 2,
                            "class": "empty",
                            "tag": "div",
                            "children": []
                        }
                    ]
                ]
            },
            "site_link": {
                "html": {
                    "default": "<div id=\"pobo-site-link\" class=\"pobo-site-link__container\"><nav class=\"pobo-site-link__nav\"><a href=\"#nadpis\" class=\"pobo-site-link__anchor\">Nadpis</a></nav></div>"
                },
                "list": {
                    "default": [
                        {
                            "heading": "Nadpis",
                            "slug": "nadpis"
                        }
                    ]
                }
            },
            "rich_snippet": {
                "html": {
                    "default": "<script type=\"application/ld+json\">{...}</script>"
                },
                "json": {
                    "default": {
                        "@context": "https://schema.org",
                        "@type": "FAQPage",
                        "mainEntity": []
                    }
                }
            },
            "created_at": "2024-01-15T10:30:00.000000Z",
            "updated_at": "2024-01-16T14:20:00.000000Z"
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 100,
        "total": 12
    }
}

Bulk import brands

POST

https://api.pobo.space

/api/v2/rest/brands

requires authentication

Import or update multiple brands at once with multilingual content. The string id field is mapped to brand.remote_id in the database. Maximum 100 brands per request. Invalid brands are skipped and reported in errors.

Supported languages: default, cs, sk, en, de, pl, hu

Validation rules:

name.default and url.default are always required
If a language key exists anywhere in the request, name.{lang} and url.{lang} are required
Other multilang fields (description, seo_title, seo_description) can be null but keys must exist
URL must start with https://
Unsupported languages are silently ignored

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

object

string

required

External brand identifier (mapped to brand.remote_id). Maximum 255 characters.

Example:

BRAND-001

is_visible

boolean

required

Whether the brand is visible.

Example:

true

image_preview

string

nullable URL of the brand logo / preview image.

Example:

https://example.com/brands/apple-logo.png

name

object

required

Object with language keys (default, cs, sk, en, de, pl, hu).

url

object

required

Object with language keys. Must start with https://.

description

object

nullable Object with language keys. Supports HTML.

seo_title

object

nullable Object with language keys for SEO title.

seo_description

object

nullable Object with language keys for SEO description.

Auth

Bearer

Headers

Body

{ "*": { "id": "BRAND-001", "is_visible": true, "image_preview": "https:\/\/example.com\/brands\/apple-logo.png", "name": { "default": "Apple", "*": "Apple SK" }, "url": { "default": "https:\/\/example.com\/znacky\/apple", "*": "https:\/\/example.com\/sk\/znacky\/apple" }, "description": { "*": "\u003Cp\u003EBrand description\u003C\/p\u003E" }, "seo_title": { "*": "Apple | Eshop" }, "seo_description": { "*": "SEO description" } } }

Received response

Example request:

curl --request POST \
    "https://api.pobo.space/api/v2/rest/brands" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"*\": {
        \"id\": \"BRAND-001\",
        \"is_visible\": true,
        \"image_preview\": \"https:\\/\\/example.com\\/brands\\/apple-logo.png\",
        \"name\": {
            \"default\": \"Apple\",
            \"cs\": \"Apple\",
            \"sk\": \"Apple SK\",
            \"en\": \"Apple EN\",
            \"de\": \"Apple DE\",
            \"pl\": \"Apple PL\",
            \"hu\": \"Apple HU\",
            \"*\": \"Apple SK\"
        },
        \"url\": {
            \"default\": \"https:\\/\\/example.com\\/znacky\\/apple\",
            \"cs\": \"https:\\/\\/example.com\\/cs\\/znacky\\/apple\",
            \"sk\": \"https:\\/\\/example.com\\/sk\\/znacky\\/apple\",
            \"en\": \"https:\\/\\/example.com\\/en\\/brands\\/apple\",
            \"de\": \"https:\\/\\/example.com\\/de\\/marken\\/apple\",
            \"pl\": \"https:\\/\\/example.com\\/pl\\/marki\\/apple\",
            \"hu\": \"https:\\/\\/example.com\\/hu\\/markak\\/apple\",
            \"*\": \"https:\\/\\/example.com\\/sk\\/znacky\\/apple\"
        },
        \"description\": {
            \"default\": \"<p>Brand description<\\/p>\",
            \"cs\": \"<p>Popis značky<\\/p>\",
            \"sk\": \"<p>Popis značky SK<\\/p>\",
            \"en\": \"<p>Brand description EN<\\/p>\",
            \"de\": \"<p>Markenbeschreibung<\\/p>\",
            \"pl\": \"<p>Opis marki<\\/p>\",
            \"hu\": \"<p>Márkaleírás<\\/p>\",
            \"*\": \"<p>Brand description<\\/p>\"
        },
        \"seo_title\": {
            \"default\": \"Apple | Eshop\",
            \"cs\": \"Apple | E-shop\",
            \"sk\": \"Apple | Obchod\",
            \"en\": \"Apple | Shop\",
            \"de\": \"Apple | Shop\",
            \"pl\": \"Apple | Sklep\",
            \"hu\": \"Apple | Bolt\",
            \"*\": \"Apple | Eshop\"
        },
        \"seo_description\": {
            \"default\": \"SEO description\",
            \"cs\": \"SEO popis\",
            \"sk\": \"SEO popis SK\",
            \"en\": \"SEO description EN\",
            \"de\": \"SEO Beschreibung\",
            \"pl\": \"Opis SEO\",
            \"hu\": \"SEO leírás\",
            \"*\": \"SEO description\"
        }
    }
}"

const url = new URL(
    "https://api.pobo.space/api/v2/rest/brands"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "*": {
        "id": "BRAND-001",
        "is_visible": true,
        "image_preview": "https:\/\/example.com\/brands\/apple-logo.png",
        "name": {
            "default": "Apple",
            "cs": "Apple",
            "sk": "Apple SK",
            "en": "Apple EN",
            "de": "Apple DE",
            "pl": "Apple PL",
            "hu": "Apple HU",
            "*": "Apple SK"
        },
        "url": {
            "default": "https:\/\/example.com\/znacky\/apple",
            "cs": "https:\/\/example.com\/cs\/znacky\/apple",
            "sk": "https:\/\/example.com\/sk\/znacky\/apple",
            "en": "https:\/\/example.com\/en\/brands\/apple",
            "de": "https:\/\/example.com\/de\/marken\/apple",
            "pl": "https:\/\/example.com\/pl\/marki\/apple",
            "hu": "https:\/\/example.com\/hu\/markak\/apple",
            "*": "https:\/\/example.com\/sk\/znacky\/apple"
        },
        "description": {
            "default": "<p>Brand description<\/p>",
            "cs": "<p>Popis značky<\/p>",
            "sk": "<p>Popis značky SK<\/p>",
            "en": "<p>Brand description EN<\/p>",
            "de": "<p>Markenbeschreibung<\/p>",
            "pl": "<p>Opis marki<\/p>",
            "hu": "<p>Márkaleírás<\/p>",
            "*": "<p>Brand description<\/p>"
        },
        "seo_title": {
            "default": "Apple | Eshop",
            "cs": "Apple | E-shop",
            "sk": "Apple | Obchod",
            "en": "Apple | Shop",
            "de": "Apple | Shop",
            "pl": "Apple | Sklep",
            "hu": "Apple | Bolt",
            "*": "Apple | Eshop"
        },
        "seo_description": {
            "default": "SEO description",
            "cs": "SEO popis",
            "sk": "SEO popis SK",
            "en": "SEO description EN",
            "de": "SEO Beschreibung",
            "pl": "Opis SEO",
            "hu": "SEO leírás",
            "*": "SEO description"
        }
    }
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'https://api.pobo.space/api/v2/rest/brands';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            '*' => [
                'id' => 'BRAND-001',
                'is_visible' => true,
                'image_preview' => 'https://example.com/brands/apple-logo.png',
                'name' => [
                    'default' => 'Apple',
                    'cs' => 'Apple',
                    'sk' => 'Apple SK',
                    'en' => 'Apple EN',
                    'de' => 'Apple DE',
                    'pl' => 'Apple PL',
                    'hu' => 'Apple HU',
                    '*' => 'Apple SK',
                ],
                'url' => [
                    'default' => 'https://example.com/znacky/apple',
                    'cs' => 'https://example.com/cs/znacky/apple',
                    'sk' => 'https://example.com/sk/znacky/apple',
                    'en' => 'https://example.com/en/brands/apple',
                    'de' => 'https://example.com/de/marken/apple',
                    'pl' => 'https://example.com/pl/marki/apple',
                    'hu' => 'https://example.com/hu/markak/apple',
                    '*' => 'https://example.com/sk/znacky/apple',
                ],
                'description' => [
                    'default' => '<p>Brand description</p>',
                    'cs' => '<p>Popis značky</p>',
                    'sk' => '<p>Popis značky SK</p>',
                    'en' => '<p>Brand description EN</p>',
                    'de' => '<p>Markenbeschreibung</p>',
                    'pl' => '<p>Opis marki</p>',
                    'hu' => '<p>Márkaleírás</p>',
                    '*' => '<p>Brand description</p>',
                ],
                'seo_title' => [
                    'default' => 'Apple | Eshop',
                    'cs' => 'Apple | E-shop',
                    'sk' => 'Apple | Obchod',
                    'en' => 'Apple | Shop',
                    'de' => 'Apple | Shop',
                    'pl' => 'Apple | Sklep',
                    'hu' => 'Apple | Bolt',
                    '*' => 'Apple | Eshop',
                ],
                'seo_description' => [
                    'default' => 'SEO description',
                    'cs' => 'SEO popis',
                    'sk' => 'SEO popis SK',
                    'en' => 'SEO description EN',
                    'de' => 'SEO Beschreibung',
                    'pl' => 'Opis SEO',
                    'hu' => 'SEO leírás',
                    '*' => 'SEO description',
                ],
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'https://api.pobo.space/api/v2/rest/brands'
payload = {
    "*": {
        "id": "BRAND-001",
        "is_visible": true,
        "image_preview": "https:\/\/example.com\/brands\/apple-logo.png",
        "name": {
            "default": "Apple",
            "cs": "Apple",
            "sk": "Apple SK",
            "en": "Apple EN",
            "de": "Apple DE",
            "pl": "Apple PL",
            "hu": "Apple HU",
            "*": "Apple SK"
        },
        "url": {
            "default": "https:\/\/example.com\/znacky\/apple",
            "cs": "https:\/\/example.com\/cs\/znacky\/apple",
            "sk": "https:\/\/example.com\/sk\/znacky\/apple",
            "en": "https:\/\/example.com\/en\/brands\/apple",
            "de": "https:\/\/example.com\/de\/marken\/apple",
            "pl": "https:\/\/example.com\/pl\/marki\/apple",
            "hu": "https:\/\/example.com\/hu\/markak\/apple",
            "*": "https:\/\/example.com\/sk\/znacky\/apple"
        },
        "description": {
            "default": "<p>Brand description<\/p>",
            "cs": "<p>Popis značky<\/p>",
            "sk": "<p>Popis značky SK<\/p>",
            "en": "<p>Brand description EN<\/p>",
            "de": "<p>Markenbeschreibung<\/p>",
            "pl": "<p>Opis marki<\/p>",
            "hu": "<p>Márkaleírás<\/p>",
            "*": "<p>Brand description<\/p>"
        },
        "seo_title": {
            "default": "Apple | Eshop",
            "cs": "Apple | E-shop",
            "sk": "Apple | Obchod",
            "en": "Apple | Shop",
            "de": "Apple | Shop",
            "pl": "Apple | Sklep",
            "hu": "Apple | Bolt",
            "*": "Apple | Eshop"
        },
        "seo_description": {
            "default": "SEO description",
            "cs": "SEO popis",
            "sk": "SEO popis SK",
            "en": "SEO description EN",
            "de": "SEO Beschreibung",
            "pl": "Opis SEO",
            "hu": "SEO leírás",
            "*": "SEO description"
        }
    }
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response:

{
    "success": true,
    "imported": 2,
    "updated": 1,
    "skipped": 1,
    "errors": [
        {
            "index": 3,
            "id": "BRAND-004",
            "errors": [
                "The name.sk field is required when using language sk."
            ]
        }
    ]
}

Bulk delete brands

DELETE

https://api.pobo.space

/api/v2/rest/brands

requires authentication

Soft-delete multiple brands at once by setting is_delete = true. Brands are identified by external id (mapped to brand.remote_id). Maximum 100 brands per request. Brands that don't exist or are already deleted are skipped.

Note: deleting a brand does NOT clear product.brand_id on associated products — products continue pointing to the soft-deleted brand. The /brands list endpoint filters out soft-deleted brands.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

object

Auth

Bearer

Headers

Body

{ "*": { "id": "BRAND-001" } }

Received response

Example request:

curl --request DELETE \
    "https://api.pobo.space/api/v2/rest/brands" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \

Example response:

{
    "success": true,
    "deleted": 2,
    "skipped": 1,
    "errors": [
        {
            "index": 2,
            "id": "BRAND-999",
            "errors": [
                "Brand not found"
            ]
        }
    ]
}

Blogs

Blog list

GET

https://api.pobo.space

/api/v2/rest/blogs

requires authentication

Get paginated list of blogs with content in all active languages. Only returns blogs with is_delete=false (includes both visible and hidden blogs). Language variants are returned only if is_active=true.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

page

integer

The page number. Default: 1.

Example:

per_page

integer

Items per page. Maximum: 100, Default: 100.

Example:

is_edited

boolean

Filter by edited status (is_loaded). Default: true.

Example:

true

last_update_time_from

string

Filter blogs updated after this datetime. Format: Y-m-d H:i:s.

Example:

2024-01-01 14:30:00

include

string

Comma-separated list of additional content to include: nested, marketplace, site_link, rich_snippet.

Example:

marketplace,nested,site_link,rich_snippet

lang

string

Comma-separated list of languages to include: default, cs, sk, en, de, pl, hu, all. Without this parameter only "default" is returned.

Example:

default,cs,sk

Auth

Bearer

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.pobo.space/api/v2/rest/blogs?page=1&per_page=50&is_edited=1&last_update_time_from=2024-01-01+14%3A30%3A00&include=marketplace%2Cnested%2Csite_link%2Crich_snippet&lang=default%2Ccs%2Csk" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "id": "BLOG-001",
            "guid": "550e8400-e29b-41d4-a716-446655440000",
            "category": "news",
            "is_visible": true,
            "is_loaded": false,
            "name": {
                "default": "Blog Title",
                "sk": "Nazov blogu"
            },
            "description": {
                "default": "<p>Blog content</p>",
                "sk": "<p>Obsah blogu</p>"
            },
            "url": {
                "default": "https://example.com/blog-title",
                "sk": "https://example.com/sk/nazov-blogu"
            },
            "seo_title": {
                "default": "Blog Title | SEO",
                "sk": "Nazov blogu | SEO"
            },
            "seo_description": {
                "default": "SEO description",
                "sk": "SEO popis"
            },
            "content": {
                "html": {
                    "default": "<div class=\"pobo-content\">...</div>",
                    "cs": "..."
                },
                "marketplace": {
                    "default": "<div class=\"pobo-content\">...</div>",
                    "cs": "..."
                },
                "nested": [
                    [
                        {
                            "id": 2,
                            "class": "empty",
                            "tag": "div",
                            "children": []
                        }
                    ]
                ]
            },
            "site_link": {
                "html": {
                    "default": "<div id=\"pobo-site-link\" class=\"pobo-site-link__container\"><nav class=\"pobo-site-link__nav\"><a href=\"#nadpis\" class=\"pobo-site-link__anchor\">Nadpis</a></nav></div>"
                },
                "list": {
                    "default": [
                        {
                            "heading": "Nadpis",
                            "slug": "nadpis"
                        }
                    ]
                }
            },
            "rich_snippet": {
                "html": {
                    "default": "<script type=\"application/ld+json\">{...}</script>"
                },
                "json": {
                    "default": {
                        "@context": "https://schema.org",
                        "@type": "FAQPage",
                        "mainEntity": []
                    }
                }
            },
            "created_at": "2024-01-15T10:30:00.000000Z",
            "updated_at": "2024-01-16T14:20:00.000000Z"
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 100,
        "total": 25
    }
}

Bulk import blogs

POST

https://api.pobo.space

/api/v2/rest/blogs

requires authentication

Import or update multiple blogs at once with multilingual content. Maximum 100 blogs per request. Invalid blogs will be skipped and reported in the errors array.

Supported languages: default, cs, sk, en, de, pl, hu

Validation rules:

id, name.default and url.default are always required
If a language key exists anywhere in the request, name.{lang} and url.{lang} are required
Other multilang fields (description, seo_title, seo_description) can be null but keys must exist
URL must start with https://
Unsupported languages are silently ignored

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

object

string

required

The unique identifier of the blog. Maximum 255 characters.

Example:

BLOG-001

Bulk delete blogs

DELETE

https://api.pobo.space

/api/v2/rest/blogs

requires authentication

Soft-delete multiple blogs at once by setting is_delete = true. Maximum 100 blogs per request. Blogs that don't exist or are already deleted will be skipped.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

object

Auth

Bearer

Headers

Body

{ "*": { "id": "BLOG-123" } }

Received response

Example request:

curl --request DELETE \
    "https://api.pobo.space/api/v2/rest/blogs" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \

Example response:

{
    "success": true,
    "deleted": 2,
    "skipped": 1,
    "errors": [
        {
            "index": 2,
            "id": "BLOG-999",
            "errors": [
                "Blog not found"
            ]
        }
    ]
}

Bulk multi-entity import

Atomic multi-entity bulk import.

POST

https://api.pobo.space

/api/v2/rest/multi-import

requires authentication

Single endpoint for clients that need to import multiple entity types in one call with all-or-nothing semantics. Useful when entities have cross-section dependencies (e.g. products referencing brands or categories created in the same request) — those references are resolved within one DB transaction.

Sections accepted (each optional): parameters, categories, brands, products, blogs. Item structure inside each section is 1:1 with the single-entity endpoints (see api-rest-v2.md).

Behavior:

Maximum 100 items total across all sections (NOT per-section).
2-phase processing:
1. Pre-validation: every item is validated BEFORE the transaction opens. If ANY item has any error, the response is 422 and DB is untouched.
2. Transactional persist: sections are processed in fixed order parameters → categories → brands → products → blogs. Any DB-layer exception triggers a full rollback.
Cross-section references: products can reference brands/categories/parameters that are being imported in the SAME request — pre-validation considers existing IDs ∪ in-request IDs as the valid set.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

parameters

object[]

nullable Optional array of parameter import items (max 100 total across all sections). Item shape is 1:1 with POST /api/v2/rest/parameters.

Example:

[{"id":1,"name":"Color","values":[{"id":11,"value":"Red"},{"id":12,"value":"Blue"}]}]

categories

object[]

nullable Optional array of category import items. Item shape is 1:1 with POST /api/v2/rest/categories.

Example:

[{"id":"CAT-1","is_visible":true,"name":{"default":"Electronics","sk":"Elektronika"},"url":{"default":"https:\/\/example.com\/electronics","sk":"https:\/\/example.com\/sk\/elektronika"},"description":{"default":"<p>Electronics category<\/p>","sk":null},"seo_title":{"default":"Electronics | Shop","sk":null},"seo_description":{"default":"Best electronics","sk":null}}]

brands

object[]

nullable Optional array of brand import items. Item shape is 1:1 with POST /api/v2/rest/brands. The string id maps to brand.remote_id.

Example:

[{"id":"BRAND-001","is_visible":true,"image_preview":"https:\/\/example.com\/brands\/apple-logo.png","name":{"default":"Apple","sk":"Apple SK"},"url":{"default":"https:\/\/example.com\/znacky\/apple","sk":"https:\/\/example.com\/sk\/znacky\/apple"},"description":{"default":"<p>Brand description<\/p>","sk":null},"seo_title":{"default":"Apple | Eshop","sk":null},"seo_description":{"default":"SEO description","sk":null}}]

products

object[]

nullable Optional array of product import items. Item shape is 1:1 with POST /api/v2/rest/products. Products may reference brands/categories/parameters imported in the SAME request — references are resolved within one DB transaction.

Example:

[{"id":"PROD-1","is_visible":true,"brand_id":"BRAND-001","categories_ids":["CAT-1"],"parameters_ids":[11],"name":{"default":"iPhone 15","sk":"iPhone 15 SK"},"short_description":{"default":"Short desc","sk":"Kr\u00e1tky popis"},"description":{"default":"<p>Full description<\/p>","sk":null},"url":{"default":"https:\/\/example.com\/iphone-15","sk":"https:\/\/example.com\/sk\/iphone-15-sk"},"seo_title":{"default":"iPhone 15 | Eshop","sk":null},"seo_description":{"default":"SEO description","sk":null},"images":["https:\/\/example.com\/iphone.jpg"]}]

blogs

object[]

nullable Optional array of blog import items. Item shape is 1:1 with POST /api/v2/rest/blogs.

Example:

[{"id":"BLOG-1","category":"news","is_visible":true,"name":{"default":"New article","sk":"Nov\u00fd \u010dl\u00e1nok"},"url":{"default":"https:\/\/example.com\/news\/article","sk":"https:\/\/example.com\/sk\/spravy\/clanok"},"description":{"default":"<p>Article body<\/p>","sk":null},"seo_title":{"default":"Article | Blog","sk":null},"seo_description":{"default":"Article SEO description","sk":null}}]

Auth

Bearer

Headers

Body

{ "parameters": [ { "id": 1, "name": "Color", "values": [ { "id": 11, "value": "Red" }, { "id": 12, "value": "Blue" } ] } ], "categories": [ { "id": "CAT-1", "is_visible": true, "name": { "default": "Electronics", "sk": "Elektronika" }, "url": { "default": "https:\/\/example.com\/electronics", "sk": "https:\/\/example.com\/sk\/elektronika" }, "description": { "default": "\u003Cp\u003EElectronics category\u003C\/p\u003E", "sk": null }, "seo_title": { "default": "Electronics | Shop", "sk": null }, "seo_description": { "default": "Best electronics", "sk": null } } ], "brands": [ { "id": "BRAND-001", "is_visible": true, "image_preview": "https:\/\/example.com\/brands\/apple-logo.png", "name": { "default": "Apple", "sk": "Apple SK" }, "url": { "default": "https:\/\/example.com\/znacky\/apple", "sk": "https:\/\/example.com\/sk\/znacky\/apple" }, "description": { "default": "\u003Cp\u003EBrand description\u003C\/p\u003E", "sk": null }, "seo_title": { "default": "Apple | Eshop", "sk": null }, "seo_description": { "default": "SEO description", "sk": null } } ], "products": [ { "id": "PROD-1", "is_visible": true, "brand_id": "BRAND-001", "categories_ids": [ "CAT-1" ], "parameters_ids": [ 11 ], "name": { "default": "iPhone 15", "sk": "iPhone 15 SK" }, "short_description": { "default": "Short desc", "sk": "Kr\u00e1tky popis" }, "description": { "default": "\u003Cp\u003EFull description\u003C\/p\u003E", "sk": null }, "url": { "default": "https:\/\/example.com\/iphone-15", "sk": "https:\/\/example.com\/sk\/iphone-15-sk" }, "seo_title": { "default": "iPhone 15 | Eshop", "sk": null }, "seo_description": { "default": "SEO description", "sk": null }, "images": [ "https:\/\/example.com\/iphone.jpg" ] } ], "blogs": [ { "id": "BLOG-1", "category": "news", "is_visible": true, "name": { "default": "New article", "sk": "Nov\u00fd \u010dl\u00e1nok" }, "url": { "default": "https:\/\/example.com\/news\/article", "sk": "https:\/\/example.com\/sk\/spravy\/clanok" }, "description": { "default": "\u003Cp\u003EArticle body\u003C\/p\u003E", "sk": null }, "seo_title": { "default": "Article | Blog", "sk": null }, "seo_description": { "default": "Article SEO description", "sk": null } } ] }

Received response

Example request:

curl --request POST \
    "https://api.pobo.space/api/v2/rest/multi-import" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"parameters\": [
        {
            \"id\": 1,
            \"name\": \"Color\",
            \"values\": [
                {
                    \"id\": 11,
                    \"value\": \"Red\"
                },
                {
                    \"id\": 12,
                    \"value\": \"Blue\"
                }
            ]
        }
    ],
    \"categories\": [
        {
            \"id\": \"CAT-1\",
            \"is_visible\": true,
            \"name\": {
                \"default\": \"Electronics\",
                \"sk\": \"Elektronika\"
            },
            \"url\": {
                \"default\": \"https:\\/\\/example.com\\/electronics\",
                \"sk\": \"https:\\/\\/example.com\\/sk\\/elektronika\"
            },
            \"description\": {
                \"default\": \"<p>Electronics category<\\/p>\",
                \"sk\": null
            },
            \"seo_title\": {
                \"default\": \"Electronics | Shop\",
                \"sk\": null
            },
            \"seo_description\": {
                \"default\": \"Best electronics\",
                \"sk\": null
            }
        }
    ],
    \"brands\": [
        {
            \"id\": \"BRAND-001\",
            \"is_visible\": true,
            \"image_preview\": \"https:\\/\\/example.com\\/brands\\/apple-logo.png\",
            \"name\": {
                \"default\": \"Apple\",
                \"sk\": \"Apple SK\"
            },
            \"url\": {
                \"default\": \"https:\\/\\/example.com\\/znacky\\/apple\",
                \"sk\": \"https:\\/\\/example.com\\/sk\\/znacky\\/apple\"
            },
            \"description\": {
                \"default\": \"<p>Brand description<\\/p>\",
                \"sk\": null
            },
            \"seo_title\": {
                \"default\": \"Apple | Eshop\",
                \"sk\": null
            },
            \"seo_description\": {
                \"default\": \"SEO description\",
                \"sk\": null
            }
        }
    ],
    \"products\": [
        {
            \"id\": \"PROD-1\",
            \"is_visible\": true,
            \"brand_id\": \"BRAND-001\",
            \"categories_ids\": [
                \"CAT-1\"
            ],
            \"parameters_ids\": [
                11
            ],
            \"name\": {
                \"default\": \"iPhone 15\",
                \"sk\": \"iPhone 15 SK\"
            },
            \"short_description\": {
                \"default\": \"Short desc\",
                \"sk\": \"Krátky popis\"
            },
            \"description\": {
                \"default\": \"<p>Full description<\\/p>\",
                \"sk\": null
            },
            \"url\": {
                \"default\": \"https:\\/\\/example.com\\/iphone-15\",
                \"sk\": \"https:\\/\\/example.com\\/sk\\/iphone-15-sk\"
            },
            \"seo_title\": {
                \"default\": \"iPhone 15 | Eshop\",
                \"sk\": null
            },
            \"seo_description\": {
                \"default\": \"SEO description\",
                \"sk\": null
            },
            \"images\": [
                \"https:\\/\\/example.com\\/iphone.jpg\"
            ]
        }
    ],
    \"blogs\": [
        {
            \"id\": \"BLOG-1\",
            \"category\": \"news\",
            \"is_visible\": true,
            \"name\": {
                \"default\": \"New article\",
                \"sk\": \"Nový článok\"
            },
            \"url\": {
                \"default\": \"https:\\/\\/example.com\\/news\\/article\",
                \"sk\": \"https:\\/\\/example.com\\/sk\\/spravy\\/clanok\"
            },
            \"description\": {
                \"default\": \"<p>Article body<\\/p>\",
                \"sk\": null
            },
            \"seo_title\": {
                \"default\": \"Article | Blog\",
                \"sk\": null
            },
            \"seo_description\": {
                \"default\": \"Article SEO description\",
                \"sk\": null
            }
        }
    ]
}"

const url = new URL(
    "https://api.pobo.space/api/v2/rest/multi-import"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "parameters": [
        {
            "id": 1,
            "name": "Color",
            "values": [
                {
                    "id": 11,
                    "value": "Red"
                },
                {
                    "id": 12,
                    "value": "Blue"
                }
            ]
        }
    ],
    "categories": [
        {
            "id": "CAT-1",
            "is_visible": true,
            "name": {
                "default": "Electronics",
                "sk": "Elektronika"
            },
            "url": {
                "default": "https:\/\/example.com\/electronics",
                "sk": "https:\/\/example.com\/sk\/elektronika"
            },
            "description": {
                "default": "<p>Electronics category<\/p>",
                "sk": null
            },
            "seo_title": {
                "default": "Electronics | Shop",
                "sk": null
            },
            "seo_description": {
                "default": "Best electronics",
                "sk": null
            }
        }
    ],
    "brands": [
        {
            "id": "BRAND-001",
            "is_visible": true,
            "image_preview": "https:\/\/example.com\/brands\/apple-logo.png",
            "name": {
                "default": "Apple",
                "sk": "Apple SK"
            },
            "url": {
                "default": "https:\/\/example.com\/znacky\/apple",
                "sk": "https:\/\/example.com\/sk\/znacky\/apple"
            },
            "description": {
                "default": "<p>Brand description<\/p>",
                "sk": null
            },
            "seo_title": {
                "default": "Apple | Eshop",
                "sk": null
            },
            "seo_description": {
                "default": "SEO description",
                "sk": null
            }
        }
    ],
    "products": [
        {
            "id": "PROD-1",
            "is_visible": true,
            "brand_id": "BRAND-001",
            "categories_ids": [
                "CAT-1"
            ],
            "parameters_ids": [
                11
            ],
            "name": {
                "default": "iPhone 15",
                "sk": "iPhone 15 SK"
            },
            "short_description": {
                "default": "Short desc",
                "sk": "Krátky popis"
            },
            "description": {
                "default": "<p>Full description<\/p>",
                "sk": null
            },
            "url": {
                "default": "https:\/\/example.com\/iphone-15",
                "sk": "https:\/\/example.com\/sk\/iphone-15-sk"
            },
            "seo_title": {
                "default": "iPhone 15 | Eshop",
                "sk": null
            },
            "seo_description": {
                "default": "SEO description",
                "sk": null
            },
            "images": [
                "https:\/\/example.com\/iphone.jpg"
            ]
        }
    ],
    "blogs": [
        {
            "id": "BLOG-1",
            "category": "news",
            "is_visible": true,
            "name": {
                "default": "New article",
                "sk": "Nový článok"
            },
            "url": {
                "default": "https:\/\/example.com\/news\/article",
                "sk": "https:\/\/example.com\/sk\/spravy\/clanok"
            },
            "description": {
                "default": "<p>Article body<\/p>",
                "sk": null
            },
            "seo_title": {
                "default": "Article | Blog",
                "sk": null
            },
            "seo_description": {
                "default": "Article SEO description",
                "sk": null
            }
        }
    ]
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

$client = new \GuzzleHttp\Client();
$url = 'https://api.pobo.space/api/v2/rest/multi-import';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => \Symfony\Component\VarExporter\Internal\Hydrator::hydrate(
            $o = [
                clone (($p = &\Symfony\Component\VarExporter\Internal\Registry::$prototypes)['stdClass'] ?? \Symfony\Component\VarExporter\Internal\Registry::p('stdClass')),
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
                clone $p['stdClass'],
            ],
            null,
            [
                'stdClass' => [
                    'id' => [
                        1,
                        11,
                        12,
                        'CAT-1',
                        9 => 'BRAND-001',
                        15 => 'PROD-1',
                        22 => 'BLOG-1',
                    ],
                    'name' => [
                        'Color',
                        3 => $o[4],
                        9 => $o[10],
                        15 => $o[16],
                        22 => $o[23],
                    ],
                    'values' => [
                        [
                            $o[1],
                            $o[2],
                        ],
                    ],
                    'value' => [
                        1 => 'Red',
                        'Blue',
                    ],
                    'is_visible' => [
                        3 => true,
                        9 => true,
                        15 => true,
                        22 => true,
                    ],
                    'url' => [
                        3 => $o[5],
                        9 => $o[11],
                        15 => $o[19],
                        22 => $o[24],
                    ],
                    'description' => [
                        3 => $o[6],
                        9 => $o[12],
                        15 => $o[18],
                        22 => $o[25],
                    ],
                    'seo_title' => [
                        3 => $o[7],
                        9 => $o[13],
                        15 => $o[20],
                        22 => $o[26],
                    ],
                    'seo_description' => [
                        3 => $o[8],
                        9 => $o[14],
                        15 => $o[21],
                        22 => $o[27],
                    ],
                    'default' => [
                        4 => 'Electronics',
                        'https://example.com/electronics',
                        '<p>Electronics category</p>',
                        'Electronics | Shop',
                        'Best electronics',
                        10 => 'Apple',
                        'https://example.com/znacky/apple',
                        '<p>Brand description</p>',
                        'Apple | Eshop',
                        'SEO description',
                        16 => 'iPhone 15',
                        'Short desc',
                        '<p>Full description</p>',
                        'https://example.com/iphone-15',
                        'iPhone 15 | Eshop',
                        'SEO description',
                        23 => 'New article',
                        'https://example.com/news/article',
                        '<p>Article body</p>',
                        'Article | Blog',
                        'Article SEO description',
                    ],
                    'sk' => [
                        4 => 'Elektronika',
                        'https://example.com/sk/elektronika',
                        null,
                        null,
                        null,
                        10 => 'Apple SK',
                        'https://example.com/sk/znacky/apple',
                        null,
                        null,
                        null,
                        16 => 'iPhone 15 SK',
                        'Krátky popis',
                        null,
                        'https://example.com/sk/iphone-15-sk',
                        null,
                        null,
                        23 => 'Nový článok',
                        'https://example.com/sk/spravy/clanok',
                        null,
                        null,
                        null,
                    ],
                    'image_preview' => [
                        9 => 'https://example.com/brands/apple-logo.png',
                    ],
                    'brand_id' => [
                        15 => 'BRAND-001',
                    ],
                    'categories_ids' => [
                        15 => [
                            'CAT-1',
                        ],
                    ],
                    'parameters_ids' => [
                        15 => [
                            11,
                        ],
                    ],
                    'short_description' => [
                        15 => $o[17],
                    ],
                    'images' => [
                        15 => [
                            'https://example.com/iphone.jpg',
                        ],
                    ],
                    'category' => [
                        22 => 'news',
                    ],
                ],
            ],
            [
                'parameters' => [
                    $o[0],
                ],
                'categories' => [
                    $o[3],
                ],
                'brands' => [
                    $o[9],
                ],
                'products' => [
                    $o[15],
                ],
                'blogs' => [
                    $o[22],
                ],
            ],
            []
        ),
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

import requests
import json

url = 'https://api.pobo.space/api/v2/rest/multi-import'
payload = {
    "parameters": [
        {
            "id": 1,
            "name": "Color",
            "values": [
                {
                    "id": 11,
                    "value": "Red"
                },
                {
                    "id": 12,
                    "value": "Blue"
                }
            ]
        }
    ],
    "categories": [
        {
            "id": "CAT-1",
            "is_visible": true,
            "name": {
                "default": "Electronics",
                "sk": "Elektronika"
            },
            "url": {
                "default": "https:\/\/example.com\/electronics",
                "sk": "https:\/\/example.com\/sk\/elektronika"
            },
            "description": {
                "default": "<p>Electronics category<\/p>",
                "sk": null
            },
            "seo_title": {
                "default": "Electronics | Shop",
                "sk": null
            },
            "seo_description": {
                "default": "Best electronics",
                "sk": null
            }
        }
    ],
    "brands": [
        {
            "id": "BRAND-001",
            "is_visible": true,
            "image_preview": "https:\/\/example.com\/brands\/apple-logo.png",
            "name": {
                "default": "Apple",
                "sk": "Apple SK"
            },
            "url": {
                "default": "https:\/\/example.com\/znacky\/apple",
                "sk": "https:\/\/example.com\/sk\/znacky\/apple"
            },
            "description": {
                "default": "<p>Brand description<\/p>",
                "sk": null
            },
            "seo_title": {
                "default": "Apple | Eshop",
                "sk": null
            },
            "seo_description": {
                "default": "SEO description",
                "sk": null
            }
        }
    ],
    "products": [
        {
            "id": "PROD-1",
            "is_visible": true,
            "brand_id": "BRAND-001",
            "categories_ids": [
                "CAT-1"
            ],
            "parameters_ids": [
                11
            ],
            "name": {
                "default": "iPhone 15",
                "sk": "iPhone 15 SK"
            },
            "short_description": {
                "default": "Short desc",
                "sk": "Krátky popis"
            },
            "description": {
                "default": "<p>Full description<\/p>",
                "sk": null
            },
            "url": {
                "default": "https:\/\/example.com\/iphone-15",
                "sk": "https:\/\/example.com\/sk\/iphone-15-sk"
            },
            "seo_title": {
                "default": "iPhone 15 | Eshop",
                "sk": null
            },
            "seo_description": {
                "default": "SEO description",
                "sk": null
            },
            "images": [
                "https:\/\/example.com\/iphone.jpg"
            ]
        }
    ],
    "blogs": [
        {
            "id": "BLOG-1",
            "category": "news",
            "is_visible": true,
            "name": {
                "default": "New article",
                "sk": "Nový článok"
            },
            "url": {
                "default": "https:\/\/example.com\/news\/article",
                "sk": "https:\/\/example.com\/sk\/spravy\/clanok"
            },
            "description": {
                "default": "<p>Article body<\/p>",
                "sk": null
            },
            "seo_title": {
                "default": "Article | Blog",
                "sk": null
            },
            "seo_description": {
                "default": "Article SEO description",
                "sk": null
            }
        }
    ]
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response:

{
    "success": true,
    "results": {
        "parameters": {
            "imported": 2,
            "updated": 0,
            "skipped": 0,
            "errors": []
        },
        "categories": {
            "imported": 5,
            "updated": 0,
            "skipped": 0,
            "errors": []
        },
        "brands": {
            "imported": 1,
            "updated": 0,
            "skipped": 0,
            "errors": []
        },
        "products": {
            "imported": 0,
            "updated": 10,
            "skipped": 0,
            "errors": []
        },
        "blogs": {
            "imported": 3,
            "updated": 0,
            "skipped": 0,
            "errors": []
        }
    }
}

API V1 (Legacy)

Products

Bulk import products

POST

https://api.pobo.space

/api/v1/products/bulk-import

requires authentication

Import or update multiple products at once. Maximum 100 products per request. Invalid products will be skipped and reported in the errors array.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

object

string

required

The unique identifier of the product. Can be numeric or alphanumeric string. Maximum 255 characters.

Example:

PROD-123-ABC

name

string

required

The name of the product. Maximum 250 characters.

Example:

Wireless Bluetooth Headphones

short_description

string

nullable Short description of the product. Maximum 500000 characters.

Example:

Premium quality wireless headphones with noise cancellation.

description

string

nullable Long description of the product. Supports HTML. Maximum 500000 characters.

Example:

<h1>Wireless Bluetooth Headphones</h1><p>Experience superior sound quality with our premium wireless headphones featuring active noise cancellation and 30-hour battery life.</p>

url

string

required

Product URL. Maximum 255 characters.

Example:

https://example.com/product/wireless-headphones

is_visible

boolean

required

Whether the product is visible.

Example:

true

images

string[]

nullable Array of image URLs. Each URL maximum 650 characters. The first image will be set as image_preview.

categories_ids

string[]

nullable Array of category IDs to assign to this product. Can be numeric or alphanumeric strings.

parameters_ids

string[]

nullable Array of parameter value IDs to assign to this product.

Auth

Bearer

Headers

Body

{ "*": { "id": "PROD-123-ABC", "name": "Wireless Bluetooth Headphones", "short_description": "Premium quality wireless headphones with noise cancellation.", "description": "\u003Ch1\u003EWireless Bluetooth Headphones\u003C\/h1\u003E\u003Cp\u003EExperience superior sound quality with our premium wireless headphones featuring active noise cancellation and 30-hour battery life.\u003C\/p\u003E", "url": "https:\/\/example.com\/product\/wireless-headphones", "is_visible": true, "images": { "*": "https:\/\/picsum.photos\/id\/310\/1200\/700" }, "categories_ids": { "*": "A01.01.07" }, "parameters_ids": { "*": 1 } } }

Received response

Example request:

curl --request POST \
    "https://api.pobo.space/api/v1/products/bulk-import" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \

Example response:

{
    "success": true,
    "imported": 2,
    "updated": 0,
    "skipped": 1,
    "errors": [
        {
            "index": 0,
            "id": "PROD-123",
            "errors": [
                "The name field is required."
            ]
        }
    ]
}

Product list

GET

https://api.pobo.space

/api/v1/products/list

requires authentication

Get paginated list of products with content in all supported languages.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

page

integer

The page number. Default: 1.

Example:

per_page

integer

Items per page (max 100). Default: 100.

Example:

is_edited

boolean

Filter by edited status. If true, returns only edited products. If false, returns only unedited products. If omitted, returns all products.

Example:

true

last_update_time_from

string

Filter products updated after this datetime. Format: Y-m-d H:i:s (e.g., 2024-01-01 14:30:00).

Example:

2024-01-01 14:30:00

Auth

Bearer

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.pobo.space/api/v1/products/list?page=1&per_page=10&is_edited=1&last_update_time_from=2024-01-01+14%3A30%3A00" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "products": [
        {
            "id": "PROD-123",
            "name": "Sample Product",
            "short_description": "This is a sample product.",
            "url": "https://example.com/product/123",
            "content": {
                "html": {
                    "default": "<h1>Sample Product Description</h1><p>This product is used for demonstration purposes.</p>",
                    "cs": "<h1>Popis vzorového produktu</h1><p>Tento produkt slouží pro demonstrační účely.</p>",
                    "en": "<h1>Sample Product Description</h1><p>This product is used for demonstration purposes.</p>",
                    "de": "<h1>Beispiel Produktbeschreibung</h1><p>Dieses Produkt wird zu Demonstrationszwecken verwendet.</p>",
                    "sk": "<h1>Popis vzorového produktu</h1><p>Tento produkt slúži na demonštračné účely.</p>"
                },
                "marketplace": {
                    "default": "<h1>Sample Product Description</h1><p>This product is used for demonstration purposes.</p>",
                    "cs": "<h1>Popis vzorového produktu</h1><p>Tento produkt slouží pro demonstrační účely.</p>",
                    "en": "<h1>Sample Product Description</h1><p>This product is used for demonstration purposes.</p>",
                    "de": "<h1>Beispiel Produktbeschreibung</h1><p>Dieses Produkt wird zu Demonstrationszwecken verwendet.</p>",
                    "sk": "<h1>Popis vzorového produktu</h1><p>Tento produkt slúži na demonštračné účely.</p>"
                }
            }
        }
    ],
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "per_page": 10,
        "to": 2,
        "total": 2
    }
}

Bulk import categories

POST

https://api.pobo.space

/api/v1/categories/bulk-import

requires authentication

Import or update multiple categories at once. Maximum 100 categories per request. Invalid categories will be skipped and reported in the errors array.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

object

string

required

The unique identifier of the category. Can be numeric or alphanumeric string (e.g., hierarchical codes like "A01.01.07"). Maximum 255 characters.

Example:

A01.01.07

name

string

required

The name of the category. Maximum 250 characters.

Example:

Electronics

description

string

nullable Description of the category. Supports HTML. Maximum 500000 characters.

Example:

<h1>Electronics Category</h1><p>Latest electronic devices and accessories.</p>

url

string

required

Category URL. Maximum 255 characters.

Example:

https://example.com/category/electronics

is_visible

boolean

required

Whether the category is visible.

Example:

true

images

string[]

nullable Array of image URLs. Each URL maximum 650 characters. The first image will be set as image_preview.

Auth

Bearer

Headers

Body

{ "*": { "id": "A01.01.07", "name": "Electronics", "description": "\u003Ch1\u003EElectronics Category\u003C\/h1\u003E\u003Cp\u003ELatest electronic devices and accessories.\u003C\/p\u003E", "url": "https:\/\/example.com\/category\/electronics", "is_visible": true, "images": { "*": "https:\/\/picsum.photos\/id\/305\/1200\/700" } } }

Received response

Example request:

curl --request POST \
    "https://api.pobo.space/api/v1/categories/bulk-import" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \

Example response:

{
    "success": true,
    "imported": 2,
    "updated": 0,
    "skipped": 1,
    "errors": [
        {
            "index": 0,
            "id": "A01.01.07",
            "errors": [
                "The name field is required."
            ]
        }
    ]
}

GET

https://api.pobo.space

/api/v1/categories/list

requires authentication

Get paginated list of categories with content in all supported languages.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

page

integer

The page number. Default: 1.

Example:

per_page

integer

Items per page (max 100). Default: 100.

Example:

is_edited

boolean

Filter by edited status. If true, returns only edited categories. If false, returns only unedited categories. If omitted, returns all categories.

Example:

true

last_update_time_from

string

Filter categories updated after this datetime. Format: Y-m-d H:i:s (e.g., 2024-01-01 14:30:00).

Example:

2024-01-01 14:30:00

Auth

Bearer

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.pobo.space/api/v1/categories/list?page=1&per_page=10&is_edited=1&last_update_time_from=2024-01-01+14%3A30%3A00" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "categories": [
        {
            "id": "A01.01.07",
            "name": "Sample Category",
            "url": "https://example.com/category/123",
            "content": {
                "html": {
                    "default": "<h1>Sample Category Description</h1><p>This category is used for demonstration purposes.</p>",
                    "cs": "<h1>Popis vzorové kategorie</h1><p>Tato kategorie slouží pro demonstrační účely.</p>",
                    "en": "<h1>Sample Category Description</h1><p>This category is used for demonstration purposes.</p>",
                    "de": "<h1>Beispiel Kategoriebeschreibung</h1><p>Diese Kategorie wird zu Demonstrationszwecken verwendet.</p>",
                    "sk": "<h1>Popis vzorovej kategórie</h1><p>Táto kategória slúži na demonštračné účely.</p>"
                },
                "marketplace": {
                    "default": "<h1>Sample Category Description</h1><p>This category is used for demonstration purposes.</p>",
                    "cs": "<h1>Popis vzorové kategorie</h1><p>Tato kategorie slouží pro demonstrační účely.</p>",
                    "en": "<h1>Sample Category Description</h1><p>This category is used for demonstration purposes.</p>",
                    "de": "<h1>Beispiel Kategoriebeschreibung</h1><p>Diese Kategorie wird zu Demonstrationszwecken verwendet.</p>",
                    "sk": "<h1>Popis vzorovej kategórie</h1><p>Táto kategória slúži na demonštračné účely.</p>"
                }
            }
        }
    ],
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "per_page": 10,
        "to": 2,
        "total": 2
    }
}

Parameters

Bulk import parameters

POST

https://api.pobo.space

/api/v1/parameters/bulk-import

requires authentication

Import or update multiple parameters with their values at once. Maximum 100 parameters per request. Invalid parameters will be skipped and reported in the errors array.

Headers

Authorization

Example:

Bearer {YOUR_AUTH_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

object

integer

required

The unique identifier of the parameter. Maximum 255 characters when converted to string.

Example:

name

string

required

The name of the parameter. Maximum 255 characters.

Example:

Color

values

string[]

required

Array of parameter values. At least one value is required.

Auth

Bearer

Headers

Body

{ "*": { "id": 1, "name": "Color", "values": { "*": { "id": 1, "value": "Red" } } } }

Received response

Example request:

curl --request POST \
    "https://api.pobo.space/api/v1/parameters/bulk-import" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \

Example response:

{
    "success": true,
    "imported": 2,
    "updated": 0,
    "skipped": 1,
    "values_imported": 4,
    "values_updated": 0,
    "errors": [
        {
            "index": 0,
            "id": 1,
            "errors": [
                "The name field is required."
            ]
        }
    ]
}