List Site Blocks

Returns the named CMS blocks (texts, images, videos, links and menus) the owner edits from the Panda AI Builder preview. This public, read-only endpoint can return every text in one language.

GET/v1/site-blocks

Authentication

Public key?key=pk_…

Public key in the `key` query parameter. No OAuth, no secret.

Edge cache: no-store (private, no-store)

Query Parameters

keystring

required

The site's public key (pk_…). It selects the account. Safe to ship to the browser.

localestring

optional

Language code. Each text then carries only that language: the owner's own translation first, then an automatic one. An unknown code returns the blocks in their source language.

enesbrptitrufrsrdecnzhplrotrar

Responses

200Success

application/json

blocksobject

Errors

401Missing or invalid public key

403TENANT_INACTIVE: the account has no active subscription (body also carries `code`)

Notes

Only blocks the owner has saved are listed: a block never edited is missing from `blocks`, so keep a default in your code.
`kind` is `text`, `image` or `navigation`. An image block may hold a video (`image.type: "video"`) or a downloadable document (`image.type: "document"`).
The first read in a new language can take up to about 2 s because missing texts are translated on the fly. Later reads are fast.
This content is meant for sites built in the Panda AI Builder, which read it through their managed helper. Custom sites outside the Builder usually have no blocks and get `{ "blocks": {} }`.

Request

curl --request GET \
  --url "https://api.pandaidx.com/v1/site-blocks?key={{public_key}}"

Response200 OK

{
  "blocks": {
    "home-hero-title": {
      "kind": "text",
      "label": "Home · Hero · Title",
      "text": {
        "locale": "en",
        "value": "Find your place in Miami"
      },
      "updatedAt": "2026-09-12T14:03:22.000Z"
    },
    "home-hero-cta": {
      "kind": "text",
      "label": "Home · Hero · Button",
      "text": {
        "locale": "en",
        "value": "Book a tour"
      },
      "link": {
        "href": "/contact",
        "newTab": false
      },
      "updatedAt": "2026-09-12T14:05:41.000Z"
    },
    "home-hero-image": {
      "kind": "image",
      "label": "Home · Hero · Image",
      "image": {
        "url": "https://media.example.com/alex-morgan/hero.jpg",
        "alt": "Miami skyline at sunset"
      },
      "updatedAt": "2026-09-10T09:12:00.000Z"
    },
    "main-menu": {
      "kind": "navigation",
      "label": "Header · Menu",
      "text": "Buy\nSell",
      "navigation": {
        "items": [
          {
            "title": "Buy",
            "href": "/search",
            "newTab": false
          },
          {
            "title": "Sell",
            "href": "/sell",
            "newTab": false
          }
        ]
      },
      "updatedAt": "2026-09-11T17:30:00.000Z"
    }
  }
}