Open Place Embed

업체창고의 업체 데이터를 누구나 자신의 웹사이트, 블로그, 커뮤니티에 쉽게 삽입할 수 있습니다.

왜 Open Embed을 제공하나요?

인터넷은 점점 텍스트 복사, 단순 리뷰, SEO 페이지의 가치가 낮아지고 있습니다. 대신 실제 장소 데이터, 사람들의 반응, 지역 기반 정보, 실시간 맥락이 중요해지고 있습니다.

업체창고는 현실 공간 데이터를 더 넓게 연결하기 위해 Open Embed API를 제공합니다.

URL만 붙여도 자동 미리보기

업체 URL을 붙이면 Open Graph 기반 카드가 자동 생성됩니다.

https://place.udanax.org/p/3810142/만나찬

지원 플랫폼:

카카오톡
디스코드
슬랙
텔레그램
X (Twitter)
블로그 플랫폼
AI 검색/에이전트

Embed Script (iframe 카드)

아래 코드만 삽입하면 업체 카드가 자동 렌더링됩니다. CSS/JS 충돌을 방지하기 위해 iframe 방식을 사용합니다.

Step 1. 스크립트 삽입 (head 또는 body 하단)

<script src="https://cdn.udanax.org/js/embed.min.js"></script>

Step 2. 카드 위치 지정

<div class="udanax-place" data-place-id="3810142"></div>

Step 3. 전체 코드 (한 번에 복사)

<script src="https://cdn.udanax.org/js/embed.min.js"></script>
<div class="udanax-place" data-place-id="3810142"></div>

라이브 미리보기

PREVIEW

Auto-Enhance (자동 링크 변환)

embed.js는 페이지 내 place.udanax.org/p/ 링크를 자동 감지하여 카드로 변환합니다. 별도 설정 없이 스크립트만 추가하면 됩니다.

자동 변환을 비활성화하려면:

<script>window.UDANAX_EMBED_AUTO_ENHANCE = false;</script>
<script src="https://cdn.udanax.org/js/embed.min.js"></script>

JSON API

서버/앱에서 직접 사용할 수 있는 공개 JSON API입니다. CORS 허용, Rate Limit 적용 (분당 30회).

엔드포인트

GET https://www.udanax.org/rest/api/place/embed/3810142

응답 예시

{ "version": 1, "place_id": 3810142, "name": "만나찬", "category": "도시락", "locality": "경기도 용인시 처인구", "lat": 37.2456, "lng": 127.1789, "top_personas": ["다시 생각나는 감칠맛"], "reaction_summary": { "total": 263, "positive_reaction_ratio": 0.78, "regular_ratio": 0.17 }, "bookmark_count": 127, "comment_count": 45, "source_url": "https://place.udanax.org/p/3810142/만나찬", "embed_url": "https://place.udanax.org/embed/3810142" }

fetch 예시

fetch('https://www.udanax.org/rest/api/place/embed/3810142')
  .then(r => r.json())
  .then(data => {
    console.log(data.name); // "만나찬"
    console.log(data.top_personas); // ["다시 생각나는 감칠맛"]
  });

Backlink & Attribution

Embed 사용 시 다음이 자동 유지됩니다:

업체창고 원본 링크 자동 연결 (canonical)
OG 메타 자동 연결
카드 하단 "via 업체창고" 어트리뷰션

사이트 운영자는 풍부한 로컬 데이터를 얻고, 업체창고는 원본 데이터 네트워크를 확장합니다.

FAQ

회원가입이나 API 키가 필요한가요?

필요 없습니다. 스크립트만 추가하면 바로 사용할 수 있습니다.

일일 사용 한도가 있나요?

JSON API는 IP 기준 분당 30회 rate limit이 적용됩니다. Embed Script는 제한이 없습니다.

카드 디자인을 커스터마이징할 수 있나요?

iframe 내부 스타일은 통일되어 있습니다. JSON API를 직접 호출하여 커스텀 UI를 만들 수 있습니다.

어떤 데이터가 포함되나요?

업체명, 카테고리, 지역, 위경도, 톱 페르소나, 반응 요약, 단골 수, 후기 수 등입니다.

데이터는 얼마나 자주 업데이트되나요?

Embed 카드는 실시간으로 렌더링됩니다. JSON API는 CDN 캐시 1시간 적용됩니다.

핵심 철학

업체창고는 단순 업체 목록을 만드는 것이 아니라, 현실 공간을 웹에서 읽을 수 있는 객체(entity)로 변환합니다.

우리는 페이지를 만드는 것이 아니라, 현실 장소를 URL로 발행합니다.

→ 업체창고 홈으로

📍 업체창고