# Chainshift

- [Chainshift Platform API](https://docs.trychainshift.ai/index.md): AEO/GEO를 위한 수집 서비스
- [AEO/GEO 이해하기](https://docs.trychainshift.ai/what-is-aeo.md): AI 답변엔진 시대의 검색 최적화
- [빠른 시작](https://docs.trychainshift.ai/quickstart.md): API 키 발급부터 첫 Platform API 호출까지 3단계
- [핵심 개념](https://docs.trychainshift.ai/concepts.md): Platform API의 리소스 구조와 관계 — 브랜드·프롬프트 세트·프롬프트·실행·답변
- [지원 모델](https://docs.trychainshift.ai/models.md): Chainshift가 지원하는 AI 모델과 모델별 지원 지역, 팬아웃 (fan-out) 데이터 제공 여부
- [개요](https://docs.trychainshift.ai/authentication/overview.md): Chainshift 플랫폼 API 인증 방식 — 조직 API 키와 OAuth 2.1
- [API 키](https://docs.trychainshift.ai/authentication/api-key.md): 조직 API 키로 Chainshift 플랫폼 API 인증하기
- [OAuth 2.1](https://docs.trychainshift.ai/authentication/oauth2.md): Claude.ai·ChatGPT 같은 브라우저 MCP 커넥터를 위한 OAuth 2.1 인증
- [프롬프트 실행하기](https://docs.trychainshift.ai/guides/submitting-runs.md): 프롬프트 등록부터 실행 요청, 완료 폴링까지 — 비동기 수집 파이프라인
- [답변 조회하기](https://docs.trychainshift.ai/guides/collecting-answers.md): 필터와 cursor 페이지네이션으로 답변을 조회하고, 응답 구조 이해하기
- [통계로 분석하기](https://docs.trychainshift.ai/guides/analytics.md): 인용 출처 도메인·URL 랭킹, fan-out 쿼리 집계
- [키워드 데이터](https://docs.trychainshift.ai/guides/keywords.md): 구글·네이버 검색량, 연관 키워드, 자동완성과 사이트 키워드 분석
- [오류 처리](https://docs.trychainshift.ai/guides/error-handling.md): 오류 응답 형식, 주요 오류 코드, 재시도 전략
- [Rate Limit](https://docs.trychainshift.ai/guides/rate-limit.md): 조직 단위 요청 한도와 초과 시 처리 방법
- [크레딧](https://docs.trychainshift.ai/guides/credits.md): 프롬프트 실행 과금 모델과 잔액 확인 방법
- [버전과 호환성](https://docs.trychainshift.ai/guides/versioning.md): v1과 v1beta의 차이, 하위 호환성 정책, 변경에 강한 클라이언트 작성법
- [개요](https://docs.trychainshift.ai/mcp/overview.md): MCP 호환 AI 에이전트에서 Chainshift 플랫폼 API 사용하기
- [연결](https://docs.trychainshift.ai/mcp/connect.md): MCP 클라이언트별 연결 설정 예시
- [활용 가이드](https://docs.trychainshift.ai/mcp/guide.md): 프롬프트 4개로 끝내는 브랜드 AI 가시성 진단, 콘텐츠 갭 분석, 경쟁사 비교, 추이 추적
- [웹 커넥터](https://docs.trychainshift.ai/mcp/web-connectors.md): Claude.ai·ChatGPT 웹에서 OAuth로 Chainshift MCP 연결하기
- [개요](https://docs.trychainshift.ai/api-reference/overview.md): Platform REST API의 베이스 URL, 인증, 리소스 구조와 공통 규칙
- [지원 모델 목록](https://docs.trychainshift.ai/api-reference/discovery/list-models.md): 프롬프트 실행에 사용할 수 있는 지원 모델 목록을 조회합니다. 반환되는 모델 코드는 프롬프트 실행 요청(submitRun)의 models 값과 통계 API의 model 필터 값으로 사용합니다.
- [지원 지역 목록](https://docs.trychainshift.ai/api-reference/discovery/list-regions.md): 프롬프트 실행 요청(submitRun)의 region 값으로 사용할 수 있는 지원 리전 목록을 조회합니다. model 을 지정하면 해당 모델이 지원하는 리전만, 생략하면 전체 리전을 반환합니다.
- [크레딧 잔액 조회](https://docs.trychainshift.ai/api-reference/organization/get-credit-balance.md): 조직의 현재 크레딧 잔액(유료+플랜 합계)을 조회합니다. 사용 이력이 없는 조직은 잔액 0으로 응답합니다.
- [프롬프트와 세트](https://docs.trychainshift.ai/api-reference/prompts/prompts-overview.md): 프롬프트·프롬프트 세트의 관계와 생성·수정·조회 규칙
- [프롬프트 세트 생성](https://docs.trychainshift.ai/api-reference/prompt-sets/create-prompt-set.md): 조직에 프롬프트 세트를 생성합니다. 프롬프트 세트는 프롬프트를 묶어 관리하는 단위로, 프롬프트 실행 요청 시 promptSetID로 세트 전체를 한 번에 실행할 수 있습니다.
- [프롬프트 세트 목록](https://docs.trychainshift.ai/api-reference/prompt-sets/list-prompt-sets.md): 조직의 프롬프트 세트 목록을 조회합니다.
- [프롬프트 세트 조회](https://docs.trychainshift.ai/api-reference/prompt-sets/get-prompt-set.md): 프롬프트 세트 단건을 조회합니다.
- [프롬프트 세트 수정](https://docs.trychainshift.ai/api-reference/prompt-sets/update-prompt-set.md): 프롬프트 세트를 부분 수정합니다. 제공한 필드만 변경되고 나머지는 유지됩니다.
- [프롬프트 세트 삭제](https://docs.trychainshift.ai/api-reference/prompt-sets/delete-prompt-set.md): 프롬프트 세트를 삭제합니다.
- [프롬프트 생성](https://docs.trychainshift.ai/api-reference/prompts/create-prompt.md): 프롬프트 세트에 프롬프트를 생성합니다. promptSetID는 필수입니다. 세트당 프롬프트는 최대 1,000개까지 생성할 수 있습니다.
- [프롬프트 벌크 생성](https://docs.trychainshift.ai/api-reference/prompts/bulk-create-prompts.md): 프롬프트를 한 번에 최대 100개까지 생성합니다. 하나라도 검증에 실패하면 전체가 생성되지 않습니다(all-or-nothing). 세트당 프롬프트는 최대 1,000개까지이며, 한 세트라도 한도를 넘기면 전체가 생성되지 않습니다.
- [프롬프트 목록](https://docs.trychainshift.ai/api-reference/prompts/list-prompts.md): 조직의 프롬프트 목록을 조회합니다. promptSetID 지정 시 해당 세트만, 미지정 시 전체를 조회합니다.
- [프롬프트 조회](https://docs.trychainshift.ai/api-reference/prompts/get-prompt.md): 프롬프트 단건을 조회합니다.
- [프롬프트 수정](https://docs.trychainshift.ai/api-reference/prompts/update-prompt.md): 프롬프트를 부분 수정합니다. 제공한 필드만 변경되고 나머지는 유지됩니다. promptSetID 제공 시 해당 세트로 이동합니다. 이동 대상 세트가 한도(1,000개)에 도달했으면 이동할 수 없습니다.
- [프롬프트 삭제](https://docs.trychainshift.ai/api-reference/prompts/delete-prompt.md): 프롬프트를 삭제합니다.
- [프롬프트 실행 개요](https://docs.trychainshift.ai/api-reference/runs/run-overview.md): 프롬프트 실행의 비동기 동작 규칙, 제출 파라미터, 상태와 과금
- [실행 요청](https://docs.trychainshift.ai/api-reference/runs/submit-run.md): 조직의 프롬프트를 지정한 모델로 실행합니다. 정기 모니터링이 아니라 요청한 시점에 한 번 수행됩니다. 요청이 성공하면 프롬프트 실행(Run)이 생성됩니다. 실행 대상은 promptIDs(개별 프롬프트) 또는 promptSetID(프롬프트 세트 전체) 중 하나만 지정할 수 있으며, 둘을 동시에 사용할 수 없습니다. 진행 상태는 응답으로 받은 id를 사용해 프롬프트 실행 상태 조회에서 확인합니다.
- [실행 상태 조회](https://docs.trychainshift.ai/api-reference/runs/get-run-status.md): 요청한 프롬프트 실행(runID)의 진행 상태와 전체/완료/성공/실패/진행중 건수, 항목별 세부 상태를 조회합니다.
- [실행 목록](https://docs.trychainshift.ai/api-reference/runs/list-runs.md): 조직이 요청한 프롬프트 실행 목록을 상태·건수와 함께 조회합니다.
- [답변 객체](https://docs.trychainshift.ai/api-reference/answers/answer-object.md): Answer 응답의 필드 구성, 빈 값 규칙, 모델별 제공 범위
- [답변 목록](https://docs.trychainshift.ai/api-reference/answers/list-answers.md): 프롬프트를 실행해서 얻은 답변 목록을 조회합니다. 각 답변은 본문과 함께 인용(sources)·팬아웃(fanouts)·원본 마크다운(markdownURL)을 포함하며, PENDING/FAILED 실행도 상태와 함께 반환됩니다.
- [답변 조회](https://docs.trychainshift.ai/api-reference/answers/get-answer.md): 답변 단건을 조회합니다. 응답 구조는 목록 항목과 동일하게 인용(sources)·검색 쿼리(fanouts)·원본 마크다운(markdownURL)을 포함합니다.
- [통계 공통 규칙](https://docs.trychainshift.ai/api-reference/statistics/statistics-overview.md): 통계 API 전체에 적용되는 스코프·랭킹·옵트인·명명 규칙의 정본
- [인용 도메인 통계](https://docs.trychainshift.ai/api-reference/statistics/source-domains.md): > **[BETA]** 베타 API 입니다. 응답 스펙이 예고 없이 변경될 수 있습니다.
- [인용 URL 통계](https://docs.trychainshift.ai/api-reference/statistics/source-urls.md): > **[BETA]** 베타 API 입니다. 응답 스펙이 예고 없이 변경될 수 있습니다.
- [Fan-out 쿼리 통계](https://docs.trychainshift.ai/api-reference/statistics/fanouts.md): > **[BETA]** 베타 API 입니다. 응답 스펙이 예고 없이 변경될 수 있습니다.
- [키워드 개요](https://docs.trychainshift.ai/api-reference/keywords/keywords-overview.md): 검색 키워드 지표 API의 정의·데이터 출처와 구글·네이버 차이
- [구글 키워드 지표](https://docs.trychainshift.ai/api-reference/keywords/google-metrics.md): > **[BETA]** 베타 API 입니다. 응답 스펙이 예고 없이 변경될 수 있습니다.
- [구글 연관 키워드](https://docs.trychainshift.ai/api-reference/keywords/google-related.md): > **[BETA]** 베타 API 입니다. 응답 스펙이 예고 없이 변경될 수 있습니다.
- [구글 자동완성](https://docs.trychainshift.ai/api-reference/keywords/google-suggestions.md): > **[BETA]** 베타 API 입니다. 응답 스펙이 예고 없이 변경될 수 있습니다.
- [네이버 키워드 지표](https://docs.trychainshift.ai/api-reference/keywords/naver-metrics.md): > **[BETA]** 베타 API 입니다. 응답 스펙이 예고 없이 변경될 수 있습니다.
- [네이버 연관 키워드](https://docs.trychainshift.ai/api-reference/keywords/naver-related.md): > **[BETA]** 베타 API 입니다. 응답 스펙이 예고 없이 변경될 수 있습니다.
- [네이버 자동완성](https://docs.trychainshift.ai/api-reference/keywords/naver-suggestions.md): > **[BETA]** 베타 API 입니다. 응답 스펙이 예고 없이 변경될 수 있습니다.
- [네이버 검색량 추이](https://docs.trychainshift.ai/api-reference/keywords/naver-trend.md): > **[BETA]** 베타 API 입니다. 응답 스펙이 예고 없이 변경될 수 있습니다.
- [사이트 키워드 분석 제출](https://docs.trychainshift.ai/api-reference/site-analysis/submit-site-keyword-analysis.md): > **[BETA]** 베타 API 입니다. 응답 스펙이 예고 없이 변경될 수 있습니다.
- [사이트 키워드 분석 상태](https://docs.trychainshift.ai/api-reference/site-analysis/get-site-keyword-analysis.md): > **[BETA]** 베타 API 입니다. 응답 스펙이 예고 없이 변경될 수 있습니다.
- [Changelog](https://docs.trychainshift.ai/changelog.md): Platform API와 문서의 변경 이력

## OpenAPI Specs

- [openapi](/openapi.json)

## Optional

- [Platform](https://platform.trychainshift.ai)
- [Dashboard](https://platform.trychainshift.ai/dashboard)