REST API V2

Connect Pobo to your system via REST API

Import products and categories in bulk and download finished product descriptions in all languages. For developers who connect Pobo to their own e-shop or information system.

Open documentation ↗ Arrange a connection
curl "https://api.pobo.space/api/v2/rest/products?is_edited=true&lang=default,sk" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

How It Works

  1. 1

    Generate an API token

    In the Pobo administration click Generate API token and send it in the Authorization header.

  2. 2

    Send your catalogue

    Import products, categories, brands and parameters in batches of up to 100 items.

  3. 3

    Create the content in Pobo

    Your team builds the descriptions in the editor or lets AI generate them.

  4. 4

    Download the finished content

    Get the finished HTML in all languages and publish it in your e-shop.

Import your catalogue in one request

Send up to 100 products at once. Required are only id, is_visible, the default name and URL. Pobo pairs products by your id, so the same request also updates them.

Request

POST /api/v2/rest/products
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

[
  {
    "id": "PROD-123",
    "is_visible": true,
    "name": { "default": "Trekking backpack 40 l", "sk": "Trekingový batoh 40 l" },
    "url": { "default": "https://example.com/backpack-40" },
    "images": ["https://example.com/backpack-40.jpg"],
    "categories_ids": ["CAT-OUTDOOR"]
  }
]

Response

{
  "success": true,
  "imported": 1,
  "updated": 0,
  "skipped": 0,
  "errors": []
}

The API at a glance

Base URL is https://api.pobo.space. Details of every endpoint are in the documentation.

Products/api/v2/rest/productsGETPOSTDELETE
Categories/api/v2/rest/categoriesGETPOSTDELETE
Brands/api/v2/rest/brandsGETPOSTDELETE
Blogs/api/v2/rest/blogsGETPOSTDELETE
Parameters/api/v2/rest/parametersPOST
Atomic import of several entities/api/v2/rest/multi-importPOST

What you get back

content.html

Finished HTML

The content.html field contains the rendered description, ready to insert into the product page.

include=marketplace

Marketplace HTML

Simplified HTML for marketplaces that allow only limited markup.

include=nested

Structured JSON

Widgets as nested JSON, if you want to render the content yourself.

include=rich_snippet

Rich snippets

Structured data for search engines, ready to insert into the page.

lang=all

Seven language variants

default, cs, sk, en, de, pl and hu. Without the lang parameter you get only default.

last_update_time_from

Only what changed

Filter items edited in Pobo and changes since your last synchronisation.

Rules worth knowing

  • The token goes in the header Authorization: Bearer YOUR_API_TOKEN
  • Up to 100 items in one import or delete request
  • Lists are paginated with page and per_page, at most 100 items per page
  • Deleting is soft, the content stays in Pobo
  • The id field is your own identifier, Pobo pairs items by it on the next import
  • Use API V2. V1 remains only for existing integrations and works with the default language only

Frequently asked questions

Is there a test environment?

We'll create a test account for you, so you can try the connection on your own products before going live.

What is the difference between API V1 and V2?

V2 works with all language versions of your content. V1 works only with the default language and remains for existing integrations.

How long does the connection usually take?

Usually 2 weeks from signing to going live. You'll get an exact estimate after our meeting, where we'll go through the scope and your requirements.

Does Pobo notify my system about changes?

Not automatically yet. Download the content regularly and use the last_update_time_from filter, so you only get what changed since the last synchronisation.

How much does the API connection cost?

The API connection starts at 5,000 Kč a month. The exact price depends on the number of products and selected features.

Ready to connect?

Browse the documentation, or let's go through your integration together. We'll get back to you within 24 hours.

Arrange a connection → Open documentation ↗
Lenka