# Chainshift

## Docs

- [답변 객체](https://dev-docs.trychainshift.ai/api-reference/answers/answer-object.md): Answer 응답의 필드 구성, 빈 값 규칙, 모델별 제공 범위
- [답변 조회](https://dev-docs.trychainshift.ai/api-reference/answers/get-answer.md): 답변 단건을 조회합니다. 응답 구조는 목록 항목과 동일하게 인용 출처(sources)·검색 쿼리(fanouts)·원본 마크다운 URL(markdownURL)을 포함합니다.
- [답변 목록](https://dev-docs.trychainshift.ai/api-reference/answers/list-answers.md): 조직의 답변(실행) 목록을 최신순 cursor 페이지네이션으로 조회합니다. 각 답변은 본문과 함께 인용 출처(sources)·검색 쿼리(fanouts)·원본 마크다운 URL(markdownURL)을 포함하며, PENDING/FAILED 실행도 상태와 함께 반환됩니다.
- [지원 모델 목록](https://dev-docs.trychainshift.ai/api-reference/discovery/list-models.md): Run 제출에 사용할 수 있는 지원 모델 목록을 조회합니다. 반환되는 모델 코드는 Run 제출(submitRun)의 models 값과 통계 API의 model 필터 값으로 사용합니다.
- [지원 지역 목록](https://dev-docs.trychainshift.ai/api-reference/discovery/list-regions.md): Run 제출(submitRun)의 region 값으로 사용할 수 있는 지원 리전 목록을 조회합니다. model 을 지정하면 해당 모델이 지원하는 리전만, 생략하면 전체 리전을 반환합니다.
- [구글 키워드 지표](https://dev-docs.trychainshift.ai/api-reference/keywords/google-metrics.md): 키워드 목록(최대 100개)의 구글 검색 지표(월평균 검색량·SEO 난이도·CPC·검색 의도·검색량 추이)를 조회합니다. 데이터가 없는 키워드는 metrics가 null이며, metrics는 있으나 searchVolume이 null이면 검색량이 비공개된 키워드입니다.
- [구글 연관 키워드](https://dev-docs.trychainshift.ai/api-reference/keywords/google-related.md): 기준 키워드와 연관된 구글 키워드를 검색량 내림차순으로 조회합니다. 기준 키워드는 목록에서 제외되며, 그 지표는 응답의 metrics 필드로 제공됩니다.
- [구글 자동완성](https://dev-docs.trychainshift.ai/api-reference/keywords/google-suggestions.md): 기준 키워드를 포함하는 세부(롱테일) 구글 키워드를 검색량 내림차순으로 조회합니다. 기준 키워드는 목록에서 제외되며, 그 지표는 응답의 metrics 필드로 제공됩니다. 기준 키워드에 검색 데이터가 없으면 metrics가 null입니다.
- [키워드 개요](https://dev-docs.trychainshift.ai/api-reference/keywords/keywords-overview.md): 구글·네이버 키워드 API의 차이와 공통 null 규칙
- [네이버 키워드 지표](https://dev-docs.trychainshift.ai/api-reference/keywords/naver-metrics.md): 키워드 목록(최대 15개)의 네이버 검색 지표(PC·모바일 검색량·클릭수·클릭률·경쟁 정도·평균 노출 광고 수)를 조회합니다. 한국 시장 전용이라 언어·국가 코드 파라미터가 없습니다. 데이터가 없거나 검색 수요가 거의 없는 키워드는 metrics가 null입니다.
- [네이버 연관 키워드](https://dev-docs.trychainshift.ai/api-reference/keywords/naver-related.md): 기준 키워드와 연관된 네이버 키워드를 검색량 내림차순으로 조회합니다. 기준 키워드는 목록에서 제외되며, 그 지표는 응답의 metrics 필드로 제공됩니다.
- [네이버 자동완성](https://dev-docs.trychainshift.ai/api-reference/keywords/naver-suggestions.md): 기준 키워드를 포함하는 세부(롱테일) 네이버 키워드를 검색량 내림차순으로 조회합니다. 기준 키워드는 목록에서 제외되며, 그 지표는 응답의 metrics 필드로 제공됩니다.
- [네이버 검색량 추이](https://dev-docs.trychainshift.ai/api-reference/keywords/naver-trend.md): 키워드 목록(최대 15개)의 네이버 최근 12개월 검색 트렌드를 조회합니다. 값은 절대 검색량이 아니라 기간 내 최댓값을 100으로 한 상대 비율(0~100)이며, 절대 환산이 필요하면 응답의 anchor 값으로 스케일링할 수 있습니다. 데이터가 없는 키워드는 trend가 null입니다.
- [크레딧 잔액 조회](https://dev-docs.trychainshift.ai/api-reference/organization/get-credit-balance.md): 조직의 현재 크레딧 잔액(유료+플랜 합계)을 조회합니다. 사용 이력이 없는 조직은 잔액 0으로 응답합니다.
- [개요](https://dev-docs.trychainshift.ai/api-reference/overview.md): Platform REST API의 베이스 URL, 인증, 리소스 구조와 공통 규칙
- [프롬프트 세트 생성](https://dev-docs.trychainshift.ai/api-reference/prompt-sets/create-prompt-set.md): 조직에 프롬프트 세트를 생성합니다. 프롬프트 세트는 프롬프트를 묶어 관리하는 단위로, Run 제출 시 promptSetID로 세트 전체를 한 번에 실행할 수 있습니다.
- [프롬프트 세트 삭제](https://dev-docs.trychainshift.ai/api-reference/prompt-sets/delete-prompt-set.md): 프롬프트 세트를 삭제합니다.
- [프롬프트 세트 조회](https://dev-docs.trychainshift.ai/api-reference/prompt-sets/get-prompt-set.md): 프롬프트 세트 단건을 조회합니다.
- [프롬프트 세트 목록](https://dev-docs.trychainshift.ai/api-reference/prompt-sets/list-prompt-sets.md): 조직의 프롬프트 세트 목록을 cursor 페이지네이션으로 조회합니다. 기본 정렬은 asc이며 order로 desc를 선택할 수 있습니다.
- [프롬프트 세트 수정](https://dev-docs.trychainshift.ai/api-reference/prompt-sets/update-prompt-set.md): 프롬프트 세트를 부분 수정합니다. 제공한 필드만 변경되고 나머지는 유지됩니다.
- [프롬프트 벌크 생성](https://dev-docs.trychainshift.ai/api-reference/prompts/bulk-create-prompts.md): 프롬프트를 한 번에 최대 100개까지 생성합니다. 하나라도 검증에 실패하면 전체가 생성되지 않습니다(all-or-nothing). 세트당 프롬프트는 최대 1,000개까지이며, 한 세트라도 한도를 넘기면 전체가 생성되지 않습니다.
- [프롬프트 생성](https://dev-docs.trychainshift.ai/api-reference/prompts/create-prompt.md): 프롬프트 세트에 프롬프트를 생성합니다. promptSetID는 필수입니다. 세트당 프롬프트는 최대 1,000개까지 생성할 수 있습니다.
- [프롬프트 삭제](https://dev-docs.trychainshift.ai/api-reference/prompts/delete-prompt.md): 프롬프트를 삭제합니다.
- [프롬프트 조회](https://dev-docs.trychainshift.ai/api-reference/prompts/get-prompt.md): 프롬프트 단건을 조회합니다.
- [프롬프트 목록](https://dev-docs.trychainshift.ai/api-reference/prompts/list-prompts.md): 조직의 프롬프트 목록을 최신순 cursor 페이지네이션으로 조회합니다. promptSetID 지정 시 해당 세트만, 미지정 시 전체를 조회합니다.
- [프롬프트와 세트](https://dev-docs.trychainshift.ai/api-reference/prompts/prompts-overview.md): 프롬프트·프롬프트 세트의 관계와 생성·수정·조회 규칙
- [프롬프트 수정](https://dev-docs.trychainshift.ai/api-reference/prompts/update-prompt.md): 프롬프트를 부분 수정합니다. 제공한 필드만 변경되고 나머지는 유지됩니다. promptSetID 제공 시 해당 세트로 이동합니다. 이동 대상 세트가 한도(1,000개)에 도달했으면 이동할 수 없습니다.
- [실행 상태 조회](https://dev-docs.trychainshift.ai/api-reference/runs/get-run-status.md): 제출한 Run(runID)의 진행 상태와 전체/완료/성공/실패/진행중 건수, 항목별 세부 상태(answers)를 조회합니다.
- [실행 목록](https://dev-docs.trychainshift.ai/api-reference/runs/list-runs.md): 조직이 제출한 Run 목록을 상태·건수(전체/완료/성공/실패/진행중)와 함께 최신순 cursor 페이지네이션으로 조회합니다.
- [프롬프트 실행 개요](https://dev-docs.trychainshift.ai/api-reference/runs/run-overview.md): 프롬프트 실행의 비동기 동작 규칙, 제출 파라미터, 상태와 과금
- [실행 요청](https://dev-docs.trychainshift.ai/api-reference/runs/submit-run.md): 조직의 프롬프트들을 지정한 모델로 단발성 실행하는 Run을 생성합니다. 실행 대상은 promptIDs(개별 프롬프트 지정) 또는 promptSetID(프롬프트 세트 전체) 중 정확히 하나로 지정합니다. 진행 상태는 반환된 runID로 Run 상태 조회에서 확인합니다.
- [사이트 키워드 분석 상태](https://dev-docs.trychainshift.ai/api-reference/site-analysis/get-site-keyword-analysis.md): 제출된 분석 작업(taskID)의 진행 상태와, 완료됐다면 추출된 키워드 결과를 조회합니다.
- [사이트 키워드 분석 제출](https://dev-docs.trychainshift.ai/api-reference/site-analysis/submit-site-keyword-analysis.md): URL을 크롤링해 키워드 후보를 추출하는 분석을 제출합니다. 비동기로 처리되며 taskID로 상태를 조회합니다.
- [Fan-out 쿼리 통계](https://dev-docs.trychainshift.ai/api-reference/statistics/fanouts.md): AI가 답변을 생성하며 실제로 던진 검색 쿼리(fan-out)를 등장 횟수 기준 상위 랭킹으로 반환합니다. fan-out은 CHATGPT·PERPLEXITY·CLAUDE 답변에서만 수집되며, 그 외 모델은 항상 빈 결과입니다.
- [인용 도메인 통계](https://dev-docs.trychainshift.ai/api-reference/statistics/source-domains.md): 조직의 답변에 인용된 출처를 도메인 단위로 집계합니다. domains는 인용 수 내림차순 상위 limit개만 담는 랭킹이며(페이지네이션 아님), 스코프 내 총 인용 수(totalCitations)와 고유 도메인 수(totalDomains)를 함께 반환합니다. 기본 집계 단위는 eTLD+1이라 blog.naver.com과 cafe.naver.com이 naver.com으로 합산되며, groupBy=subdomain으로 서브도메인별 집계를 선택할 수 있습니다.
- [인용 URL 통계](https://dev-docs.trychainshift.ai/api-reference/statistics/source-urls.md): 조직의 답변에 인용된 출처를 URL 단위로 집계합니다. urls는 인용 수 내림차순 상위 limit개만 담는 랭킹이며(페이지네이션 아님), 스코프 내 총 인용 수(totalCitations)를 함께 반환합니다. domain을 지정하면 그 도메인 아래 인용된 URL만 보므로, 자사 페이지가 인용됐는지 상위 limit 제한에 걸리지 않고 확인할 수 있습니다.
- [집계 공통 규칙](https://dev-docs.trychainshift.ai/api-reference/statistics/statistics-overview.md): 인용 통계 3종에 공통으로 적용되는 범위·랭킹·옵트인 규칙
- [API 키](https://dev-docs.trychainshift.ai/authentication/api-key.md): 조직 API 키로 Chainshift 플랫폼 API 인증하기
- [OAuth 2.1](https://dev-docs.trychainshift.ai/authentication/oauth2.md): Claude.ai·ChatGPT 같은 브라우저 MCP 커넥터를 위한 OAuth 2.1 인증
- [개요](https://dev-docs.trychainshift.ai/authentication/overview.md): Chainshift 플랫폼 API 인증 방식 — 조직 API 키와 OAuth 2.1
- [Changelog](https://dev-docs.trychainshift.ai/changelog.md): Platform API와 문서의 변경 이력
- [핵심 개념](https://dev-docs.trychainshift.ai/concepts.md): Platform API의 리소스 구조와 관계 — 브랜드·프롬프트 세트·프롬프트·실행·답변
- [통계로 분석하기](https://dev-docs.trychainshift.ai/guides/analytics.md): 인용 출처 도메인·URL 랭킹, 답변 토큰 빈도, fan-out 쿼리 집계
- [답변 수집하기](https://dev-docs.trychainshift.ai/guides/collecting-answers.md): 필터와 cursor 페이지네이션으로 답변을 조회하고, 응답 구조 이해하기
- [에러 처리](https://dev-docs.trychainshift.ai/guides/error-handling.md): 에러 응답 형식, 주요 에러 코드, 재시도 전략
- [키워드 데이터](https://dev-docs.trychainshift.ai/guides/keywords.md): 구글·네이버 검색량, 연관 키워드, 자동완성과 사이트 키워드 분석
- [프롬프트 실행하기](https://dev-docs.trychainshift.ai/guides/submitting-runs.md): 프롬프트 등록부터 실행 요청, 완료 폴링까지 — 비동기 수집 파이프라인
- [Chainshift Platform API](https://dev-docs.trychainshift.ai/index.md): ChatGPT·Gemini·Perplexity 같은 AI 답변엔진에서 브랜드가 어떻게 언급되는지 수집하고 분석하는 REST API
- [연결](https://dev-docs.trychainshift.ai/mcp/connect.md): MCP 클라이언트별 연결 설정 예시
- [개요](https://dev-docs.trychainshift.ai/mcp/overview.md): MCP 호환 AI 에이전트에서 Chainshift 플랫폼 API 사용하기
- [웹 커넥터](https://dev-docs.trychainshift.ai/mcp/web-connectors.md): Claude.ai·ChatGPT 웹에서 OAuth로 Chainshift MCP 연결하기
- [지원 모델](https://dev-docs.trychainshift.ai/models.md): Chainshift가 지원하는 AI 모델과 팬아웃(fan-out) 데이터 제공 여부
- [빠른 시작](https://dev-docs.trychainshift.ai/quickstart.md): API 키 발급부터 첫 Platform API 호출까지 3단계
- [Rate Limit & 크레딧](https://dev-docs.trychainshift.ai/rate-limit.md): 조직 단위 요청 한도와 크레딧 과금 모델, 초과 시 처리 방법
- [활용 가이드](https://dev-docs.trychainshift.ai/usage.md): 프롬프트 4개로 끝내는 브랜드 AI 가시성 진단, 콘텐츠 갭 분석, 경쟁사 비교, 추이 추적
- [AEO/GEO 이해하기](https://dev-docs.trychainshift.ai/what-is-aeo.md): AI 답변엔진 시대의 검색 최적화 — 이 API가 측정하는 것들을 실데이터로 이해하기

## OpenAPI Specs

- [openapi](https://dev-docs.trychainshift.ai/openapi.json)

## Optional

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