Developers
VAYL Open API

VAYL의 데이터와 반응을
API 하나로 연결하세요

플레이스와 영화·드라마 데이터 조회부터 체크인, 좋아요, 리뷰 기록까지 REST API로 제공합니다. 여러 서비스에서 남긴 반응이 한 곳에 모이고, 모든 서비스에 함께 보입니다.

시작하기API 레퍼런스
REST · JSONOpenAPI 3.1llms.txt현재 무료
curl "https://api.vayl.studio/v1/places?area=종로" \
  -H "Authorization: Bearer vk_pub_…"
# 200 OK
{
  "items": [{
    "slug": "…",
    "title": "업소 이름",
    "area": "종로",
    "coordinates": { "lat": …, "lng": … },
    "reactions": { "checkins": …, "likes": …, "reviews": … },
    "url": "https://vayl.studio/places/…"
  }],
  "nextCursor": "…"
}

API

필요한 API를 선택해 연결하세요. 키 하나로 모든 API를 사용할 수 있습니다.

플레이스 API

업소 목록·상세, 지역·업종 검색, 근처 업소 조회. 영업시간, 메뉴, 연락처, 사진과 출처를 제공합니다.

GET /v1/places

영화·드라마 API

작품 목록·상세, 국내 시청 가능 서비스, 공식 소개, 출연진, 포스터, 회원 응답 분포를 제공합니다.

GET /v1/works

반응 API

체크인, 좋아요, 리뷰 작성·수정·삭제·신고, 회원 응답. 사용자 이름 또는 익명으로 기록합니다.

POST /v1/…/reviews

위젯

코드 두 줄로 체크인·좋아요·리뷰 영역을 삽입합니다. 서버가 없는 서비스에서도 사용할 수 있습니다.

<vayl-reactions>

3단계로 시작하기

VAYL 계정이 있으면 별도 심사 없이 바로 키가 발급됩니다.

  1. 1

    애플리케이션 등록

    이메일 인증을 마친 VAYL 계정으로 로그인한 뒤, 서비스 이름, 주소, 소개, 아이콘, 허용 도메인을 입력합니다.

  2. 2

    키 발급

    공개 키와 비밀 키가 바로 발급됩니다. 비밀 키는 발급할 때 한 번만 표시됩니다.

    vk_pub_••••••••••••
vk_sec_••••••••••••
  3. 3

    첫 호출

    공개 키로 데이터를 조회하고, 서버에서 비밀 키로 반응을 기록합니다.

    GET /v1/works?kind=series
AI 코딩 도구

안내 문서 하나로
연결 코드를 완성하세요

Cursor, Claude, Lovable, Bolt 등에 아래 주소를 붙여넣으면 키 설정, 조회, 반응 기록, 위젯 삽입 코드를 작성합니다.

https://vayl.studio/developers/llms.txt

OpenAPI 명세: api.vayl.studio/v1/openapi.json

인증

키용도사용 위치
vk_pub_조회브라우저, 앱, 서버. 등록한 도메인에서만 호출됩니다
vk_sec_조회, 반응 기록서버, 서버리스 함수. 브라우저에서 호출하면 거부됩니다

이용 한도

구분기본등록 후 7일
조회분당 120 · 하루 20,000같음
반응 기록하루 2,000하루 200
새 사용자하루 500하루 50

문서

이용 조건

  • VAYL 데이터를 표시할 때는 「VAYL」 표시와 해당 페이지 링크를 함께 넣어 주시기 바랍니다. 사진은 출처와 함께 표시해 주시기 바랍니다.
  • 체크인과 리뷰는 VAYL에 공개로 기록됩니다. 기록하기 전에 사용자에게 알리고, 이름 또는 익명 중 선택하게 해 주시기 바랍니다.
  • 사용자 식별값으로 이메일이나 전화번호는 사용할 수 없습니다.
  • 받은 데이터는 24시간까지 저장할 수 있으며, 다른 서비스에 다시 제공하거나 판매할 수 없습니다.

지금 애플리케이션을 등록하세요

현재 상업 서비스를 포함해 모두 무료입니다.

문서 보기