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.

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).

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

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" \
    --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": {
                    "cs": "<div class=\"pobo-content\">...</div>",
                    "sk": "<div class=\"pobo-content\">...</div>",
                    "en": "<div class=\"pobo-content\">...</div>"
                },
                "marketplace": {
                    "cs": "<div class=\"pobo-content\">...</div>",
                    "sk": "<div class=\"pobo-content\">...</div>",
                    "en": "<div class=\"pobo-content\">...</div>"
                }
            },
            "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"]

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" ], "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": { "*": "consectetur" }, "seo_title": { "*": "est" }, "seo_description": { "*": "exercitationem" } } }

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\"
        ],
        \"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>\",
            \"*\": \"consectetur\"
        },
        \"seo_title\": {
            \"default\": \"SEO Title\",
            \"sk\": \"SEO Názov\",
            \"*\": \"est\"
        },
        \"seo_description\": {
            \"default\": \"SEO Description\",
            \"sk\": \"SEO Popis\",
            \"*\": \"exercitationem\"
        }
    }
}"

$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',
                ],
                '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>',
                    '*' => 'consectetur',
                ],
                'seo_title' => [
                    'default' => 'SEO Title',
                    'sk' => 'SEO Názov',
                    '*' => 'est',
                ],
                'seo_description' => [
                    'default' => 'SEO Description',
                    'sk' => 'SEO Popis',
                    '*' => 'exercitationem',
                ],
            ],
        ],
    ]
);
$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.

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).

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

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" \
    --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>Kategória 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": "Najlepšia elektronika"
            },
            "content": {
                "html": {
                    "cs": "<div class=\"pobo-content\">...</div>",
                    "sk": "<div class=\"pobo-content\">...</div>",
                    "en": "<div class=\"pobo-content\">...</div>"
                },
                "marketplace": {
                    "cs": "<div class=\"pobo-content\">...</div>",
                    "sk": "<div class=\"pobo-content\">...</div>",
                    "en": "<div class=\"pobo-content\">...</div>"
                }
            },
            "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": { "*": "eos" }, "seo_title": { "*": "alias" }, "seo_description": { "*": "ea" } } }

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>\",
            \"*\": \"eos\"
        },
        \"seo_title\": {
            \"default\": \"SEO Title\",
            \"sk\": \"SEO Názov\",
            \"*\": \"alias\"
        },
        \"seo_description\": {
            \"default\": \"SEO Description\",
            \"sk\": \"SEO Popis\",
            \"*\": \"ea\"
        }
    }
}"

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": []
}

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).

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

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" \
    --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": "Názov 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": "Názov blogu | SEO"
            },
            "seo_description": {
                "default": "SEO description",
                "sk": "SEO popis"
            },
            "content": {
                "html": {
                    "cs": "<div class=\"pobo-content\">...</div>",
                    "sk": "<div class=\"pobo-content\">...</div>",
                    "en": "<div class=\"pobo-content\">...</div>"
                },
                "marketplace": {
                    "cs": "<div class=\"pobo-content\">...</div>",
                    "sk": "<div class=\"pobo-content\">...</div>",
                    "en": "<div class=\"pobo-content\">...</div>"
                }
            },
            "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"
            ]
        }
    ]
}

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 65000 characters.

Example:

Premium quality wireless headphones with noise cancellation.

description

string

nullable Long description of the product. Supports HTML. Maximum 65000 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": "

Wireless Bluetooth Headphones<\/h1>
Experience superior sound quality with our premium wireless headphones featuring active noise cancellation and 30-hour battery life.<\/p>", "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 65000 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": "

Electronics Category<\/h1>
Latest electronic devices and accessories.<\/p>", "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."
            ]
        }
    ]
}

REST API Documentation

REST API Documentation

Introduction

Authenticating requests

API V2 (Multilang)

Products

Product list

Headers

Query Parameters

Bulk import products

Headers

Body Parameters

Bulk delete products

Headers

Body Parameters

Categories

Category list

Headers

Query Parameters

Bulk import categories

Headers

Body Parameters

Bulk delete categories

Headers

Body Parameters

Parameters

Bulk import parameters

Headers

Body Parameters

Blogs

Blog list

Headers

Query Parameters

Bulk import blogs

Headers

Body Parameters

Bulk delete blogs

Headers

Body Parameters

API V1 (Legacy)

Products

Bulk import products

Headers

Body Parameters

Product list

Headers

Query Parameters

Categories

Bulk import categories

Headers

Body Parameters

Electronics Category<\/h1>Latest electronic devices and accessories.<\/p>", "url": "https:\/\/example.com\/category\/electronics", "is_visible": true, "images": { "*": "https:\/\/picsum.photos\/id\/305\/1200\/700" } } }

Category list

Headers

Query Parameters

Parameters

Bulk import parameters

Headers

Body Parameters

Electronics Category<\/h1>
Latest electronic devices and accessories.<\/p>", "url": "https:\/\/example.com\/category\/electronics", "is_visible": true, "images": { "*": "https:\/\/picsum.photos\/id\/305\/1200\/700" } } }