개발자 · 오픈 API

최종 갱신: 2026년 7월 5일 · Beta

Trepo의 공개 여행 코스는 읽기 전용 공개 API와 임베드 위젯으로 누구나 활용할 수 있습니다. 블로그·연구·AI 에이전트 등 자유롭게 사용하되, 아래 이용 조건을 지켜 주세요.

1. 기본 정보

Base URL: https://api.trepo-trip.com
인증: 공개(비공개 아님) 데이터의 GET 요청에는 인증이 필요 없습니다. 쓰기/개인 데이터 API는 제공하지 않습니다.
포맷: JSON (UTF-8). 목록 응답은 Spring 페이지 규격(content, totalElements, totalPages 등)이며 ?page=0&size=20으로 페이징합니다.
언어: Accept-Language 헤더(en/ko/ja/es/zh/zh-TW)를 참고해 일부 응답 메시지가 지역화될 수 있습니다.

2. 공개 엔드포인트

엔드포인트	설명
`GET /api/courses/public`	공개 코스 목록 (페이징)
`GET /api/courses/popular`	인기 코스
`GET /api/courses/recent`	최신 코스
`GET /api/courses/search?keyword=&tags=`	키워드·태그 검색
`GET /api/courses/recommendations`	추천 코스 (익명은 인기 기반)
`GET /api/courses/{id}`	코스 상세 — 제목·설명·일차별 장소·경로·태그·비용 정보
`GET /api/courses/{id}/similar`	유사 코스 (태그 기반)
`GET /api/posts/recent · /popular · /{id}`	커뮤니티 게시글
`GET /api/users/{id}`	공개 프로필 (작성자 정보)

예시

curl "https://api.trepo-trip.com/api/courses/public?size=5"
curl "https://api.trepo-trip.com/api/courses/241"

3. 코스 임베드 (iframe / oEmbed)

공개 코스를 블로그·노션·개인 사이트에 카드로 삽입할 수 있습니다.

<iframe src="https://trepo-trip.com/embed/course/{id}"
  width="600" height="420" style="border:0;max-width:100%;"
  loading="lazy" title="Trepo course"></iframe>

?lang=en|ko로 카드 언어를 지정할 수 있습니다 (기본 en).
oEmbed: https://trepo-trip.com/oembed?url={코스 URL}&format=json — 공유 링크(/c/{id})에는 discovery 태그가 포함되어 있어 oEmbed 지원 편집기에 URL만 붙여도 자동 임베드됩니다.

4. AI 에이전트 연동 (ChatGPT Actions 등)

공개 API의 OpenAPI 3.1 스펙을 제공합니다: https://trepo-trip.com/openapi.yaml

ChatGPT(GPT Actions): GPT 편집기 → Actions → "Import from URL"에 위 스펙 URL을 입력하면 코스 검색·상세 조회 액션이 자동 생성됩니다. 인증은 None(공개 read-only)으로 두면 됩니다.
기타 AI 에이전트(Claude, LangChain 등): 같은 스펙을 tool 정의로 가져다 쓰면 됩니다. 응답의 코스는 https://trepo-trip.com/c/{id} 링크로 안내해 주세요.
아래 Fair Use(출처 표기·429 존중)가 동일하게 적용됩니다.

5. 이용 조건 (Fair Use)

출처 표기: 데이터를 외부에 표시할 때 Trepo와 원본 코스 링크(https://trepo-trip.com/c/{id})를 함께 표기해 주세요.
합리적 트래픽: 현재 API 키 없이 제공되는 베타입니다. 과도한 요청(집중 크롤링 등)은 사전 고지 없이 제한(429)·차단될 수 있으며, 대량 사용이 필요하면 먼저 문의해 주세요.
재배포 제한: 응답에 포함될 수 있는 서드파티 콘텐츠(예: Google 지도 관련 데이터)는 해당 서비스 약관을 따르며, 별도 저장·재배포할 수 없습니다.
본 API는 베타로, 스펙이 예고 후 변경될 수 있습니다. 이용약관이 함께 적용됩니다.

문의: rnjscksdud17@gmail.com — 대량 사용, 파트너십, 스펙 문의를 환영합니다.

Developers · Open API

Last updated: July 5, 2026 · Beta

Trepo's public travel courses are available through a read-only public API and an embeddable widget. Use them freely for blogs, research, or AI agents — just follow the fair-use terms below.

1. Basics

Base URL: https://api.trepo-trip.com
Auth: No authentication is required for GET requests on public data. Write and private-data APIs are not offered.
Format: JSON (UTF-8). List responses follow the Spring page shape (content, totalElements, totalPages, …) with ?page=0&size=20 pagination.
Language: some response messages honor the Accept-Language header (en/ko/ja/es/zh/zh-TW).

2. Public endpoints

Endpoint	Description
`GET /api/courses/public`	Public course list (paged)
`GET /api/courses/popular`	Popular courses
`GET /api/courses/recent`	Recent courses
`GET /api/courses/search?keyword=&tags=`	Keyword / tag search
`GET /api/courses/recommendations`	Recommendations (popularity-based for anonymous)
`GET /api/courses/{id}`	Course detail — title, description, day-by-day places, routes, tags, cost info
`GET /api/courses/{id}/similar`	Similar courses (tag overlap)
`GET /api/posts/recent · /popular · /{id}`	Community posts
`GET /api/users/{id}`	Public profile (author info)

Examples

curl "https://api.trepo-trip.com/api/courses/public?size=5"
curl "https://api.trepo-trip.com/api/courses/241"

3. Course embed (iframe / oEmbed)

Embed any public course as a card in blogs, Notion, or your own site.

<iframe src="https://trepo-trip.com/embed/course/{id}"
  width="600" height="420" style="border:0;max-width:100%;"
  loading="lazy" title="Trepo course"></iframe>

Set the card language with ?lang=en|ko (default: en).
oEmbed: https://trepo-trip.com/oembed?url={course URL}&format=json — share links (/c/{id}) carry a discovery tag, so oEmbed-aware editors embed automatically when you paste the URL.

4. AI agents (ChatGPT Actions, etc.)

An OpenAPI 3.1 spec for the public API is available at https://trepo-trip.com/openapi.yaml.

ChatGPT (GPT Actions): in the GPT editor, go to Actions → "Import from URL" and paste the spec URL. Course search & detail actions are generated automatically; set authentication to None (public read-only).
Other AI agents (Claude, LangChain, …): consume the same spec as tool definitions. Please surface courses via their share links (https://trepo-trip.com/c/{id}).
The fair-use terms below (attribution, respecting 429s) apply equally.

5. Fair use

Attribution: when displaying the data elsewhere, credit Trepo and link the original course (https://trepo-trip.com/c/{id}).
Reasonable traffic: this is a keyless beta. Abusive traffic (aggressive crawling, etc.) may be throttled (429) or blocked without notice; contact us first for high-volume use.
No redistribution of third-party content: any third-party content in responses (e.g., Google Maps–related data) remains governed by its own terms and must not be stored or redistributed.
The API is in beta and may change with notice. The Terms of Service also apply.

Contact: rnjscksdud17@gmail.com — high-volume use, partnerships, and spec questions are welcome.