# 게시, 전달, 검색 및 측정

> The edge-cached Content Delivery API, site search, SEO and AI files, edge redirects, first-party analytics and custom domains.

> Markdown version of https://kanorio.com/ko/developers/products/delivery. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp
>
> Translated from the English original: https://kanorio.com/en/developers/products/delivery.md

Status: **Partial**

전달(Delivery)은 Kanorio가 사이트를 호스팅하든 사용자가 직접 프론트엔드를 구축하든 관계없이, 게시된 콘텐츠가 방문자, 검색 엔진 및 AI 어시스턴트에게 도달하는 방식을 의미합니다.

## 주요 기능

- **Content Delivery API.** 버전 키와 캐시 태그를 사용하는 익명화된 에지 캐시 읽기 기능입니다. 게시를 수행하면 몇 초 이내에 사이트가 새 버전으로 전환됩니다.
- **검색.** 페이지, 게시물 및 제품 전체에 대한 전체 텍스트 검색을 지원합니다.
- **SEO 및 AI 파일.** 사용자 도메인을 가리키는 링크가 포함된 사이트맵, robots.txt, llms.txt, 피드 및 JSON-LD를 제공합니다.
- **에지 규칙.** 미들웨어의 `@kanorio/sdk/edge`를 통해 적용되는 리디렉션, AI 크롤러 차단 및 IndexNow 키 파일 설정입니다.
- **분석.** `<kanorio-analytics>`를 통해 보고되는 퍼스트 파티 페이지 뷰 및 AI 어시스턴트 유입 경로를 측정합니다.
- **도메인.** 사용자 지정 도메인 및 해당 DNS 상태를 관리합니다.

## API 활용 방법

- Management API를 사용하여 사이트 게시 및 게시 취소, 개발자 설정 변경, 미리보기 토큰 생성, 도메인 바인딩 및 분석 쿼리를 수행할 수 있습니다.
- 이 페이지에 설명된 나머지 모든 기능은 Content Delivery API 및 SDK를 통해 제공됩니다.
- Webhooks는 분석 마일스톤 및 외부 프론트엔드와 관련된 문제를 보고합니다.

## What the APIs expose

| Capability | Status | API | Elements | Hosted site | Webhooks |
| --- | --- | --- | --- | --- | --- |
| Full-text site search | Available | Delivery `GET /search`; Management API `site.search` | — | Hosted site search box | — |
| Site speed & Core Web Vitals monitor (`/seo/speed`) | Available | — | — | `/seo/speed` (CrUX field data & PageSpeed Insights lab data) | — |
| On-site promotional widgets (`/marketing/on-site/topbar`, modal, floating buttons) | Hosted only | — | — | `/marketing/on-site/topbar`, `/marketing/on-site/modal`, `/marketing/on-site/floating` (injected into Kanorio-hosted DOM; hidden in backoffice when `frontendMode` is `HEADLESS`) | — |
| Brand identity: logo, site icon, brand colors, color scheme, fonts & corner radius (`/settings/brand`) | Available | Management `site.get_settings` / `site.update_settings` (`settings.brand`); Delivery `GET /site` (`brand`: colors resolved per color scheme with readable foreground, the owner's `colorScheme`, logo per backdrop, font families with stylesheet URLs, corner radius scale); CLI `settings update --brand-color --corner-radius --color-scheme` | `KanorioProvider` and every element read `brand` from `GET /site` once and apply it to `.kanorio-elements` as `--brand-color`, `--brand-foreground`, `--site-radius-*` and the brand font (`brand={false}` to opt out) | `/settings/brand` (both frontend modes; takes effect immediately, no publish) | — |
| Section layout & theme: text sizes & section density (`/editor` design surface) | Hosted only | — | — | `/editor` visual site builder (hidden in backoffice when `frontendMode` is `HEADLESS`) | — |
| Automatic OG image generation, `sitemap.xml`, `robots.txt` & JSON-LD output | Available | Delivery `GET /seo/sitemap.xml`, `GET /seo/robots.txt`, `GET /seo/indexnow-key.txt`, `GET /seo/jsonld?path=`, plus `seo` object on `/pages/:slug` and `/collections/blog/items/:slug` (`ogImage` includes `autoOgImage`); SDK `seo.rewrites({ framework })`, `seo.jsonLd(path)`, `createKanorioMiddleware()` (serves the IndexNow key file) | — | Automatically served on Kanorio-hosted pages | — |
| `llms.txt`, `llms-full.txt` & AI crawler management | Available | Delivery `GET /seo/llms.txt`, `GET /seo/llms-full.txt`, `GET /seo/robots.txt`, `GET /site` (`crawlerRules`), `POST /analytics/bot-hit`; SDK `@kanorio/sdk/edge` (`createKanorioMiddleware`) | — | Hosted `/llms.txt`, `/llms-full.txt` and edge bot tracker | — |
| First-party visitor & AI crawler traffic analytics (`/analytics`) | Partial | Delivery `POST /analytics/pageview` (anonymous, per-IP rate-limited, records `path` / `referrer` / UA category); Management API `analytics.*` | `<KanorioAnalytics />` | `/analytics` | — |

## API reference

- Management API: [Site](https://kanorio.com/en/developers/management-api/site) (13 operations)
- Management API: [Domains](https://kanorio.com/en/developers/management-api/domains) (3 operations)
- Management API: [Analytics](https://kanorio.com/en/developers/management-api/analytics) (4 operations)
- Management API: [Seo](https://kanorio.com/en/developers/management-api/seo) (2 operations)
- Content Delivery API: [Openapi](https://kanorio.com/en/developers/delivery-api/openapi) (1 operations)
- Content Delivery API: [Site](https://kanorio.com/en/developers/delivery-api/site) (1 operations)
- Content Delivery API: [Seo](https://kanorio.com/en/developers/delivery-api/seo) (6 operations)
- Content Delivery API: [Analytics](https://kanorio.com/en/developers/delivery-api/analytics) (2 operations)
- Content Delivery API: [Search](https://kanorio.com/en/developers/delivery-api/search) (1 operations)

## Webhook events

- `site.analytics.milestone`: Fired when cumulative site pageviews reach a milestone.
- `site.externalFrontend.degraded`: Fired when the daily external frontend health check detects failing core endpoints (unreachable storefront or broken SEO rewrites).

Payloads: https://kanorio.com/en/developers/webhooks/events

## Elements

- `<kanorio-analytics>`: Privacy-first pageview and SPA route-change tracking sent with a non-blocking beacon.

## Recent changes

- 2026-11-04: Localization: each locale can have its own URL slug
- 2026-11-03: SDK: locale routing, hreflang alternates and wildcard redirects at the edge
- 2026-11-03: Cache tags: per-record and per-locale invalidation, new localization events
- 2026-11-03: Delivery API: locale on every read
- 2026-11-03: Developer settings: headlessEnabled removed

Full changelog: https://kanorio.com/en/developers/changelog

## For site owners

Dashboard help: https://kanorio.com/ko/help/seo