> ## Documentation Index > Fetch the complete documentation index at: https://dev-docs.trychainshift.ai/llms.txt > Use this file to discover all available pages before exploring further. # 답변 목록 > 조직의 답변(실행) 목록을 최신순 cursor 페이지네이션으로 조회합니다. 각 답변은 본문과 함께 인용 출처(sources)·검색 쿼리(fanouts)·원본 마크다운 URL(markdownURL)을 포함하며, PENDING/FAILED 실행도 상태와 함께 반환됩니다. 응답 필드의 의미와 빈 값 규칙(`fanouts`·`sources`가 언제 비는지)은 [답변 객체](/api-reference/answers/answer-object)를, 실제 응답 예시와 해석은 [답변 수집하기](/guides/collecting-answers) 가이드를 참고하세요. ## OpenAPI ````yaml GET /v1beta/platform/answers openapi: 3.1.0 info: description: >- 외부 파트너용 플랫폼 API. 조직 API 키 기반 인증을 사용합니다. ### 공통 요청 제한 - 요청 body 크기는 최대 2MiB이며, 초과 시 413과 함께 `COMMON_REQUEST_BODY_TOO_LARGE` 코드를 반환합니다. - 배열 파라미터와 문자열 필드에는 엔드포인트별 개수·길이 상한이 있습니다. 상한은 각 필드/파라미터 설명에 명시되어 있으며, 위반 시 400과 함께 `COMMON_VALIDATION` 코드를 반환합니다. - 검증 실패 시 `details` 배열에 위반 필드와 사유가 담깁니다. 예: `{"code":"COMMON_VALIDATION","message":"데이터 검증에 실패했습니다","details":["keywords: 최대 100개까지 입력할 수 있습니다"]}` - `message`와 `details`는 Accept-Language 헤더에 따라 한국어(ko) 또는 영어(en)로 제공됩니다. title: Platform API version: '1.0' servers: - url: https://dev-platform-api.trychainshift.ai/api security: [] tags: - description: API 키가 귀속되는 최상위 계정 단위입니다. 조직의 기본 정보를 조회합니다. name: Organization - description: AI 서비스에서 노출을 모니터링하는 대상 브랜드입니다. 브랜드 등록·조회·수정·삭제를 제공합니다. name: Brand - description: >- 브랜드와 시장을 분석하기 위한 키워드 인텔리전스입니다. 구글·네이버 검색 지표, 연관·자동완성 키워드 조회와 사이트 URL 기반 키워드 분석을 제공합니다. name: Keyword - description: 프롬프트를 목적별로 묶는 그룹입니다. 프롬프트 세트 생성·조회·수정·삭제를 제공합니다. name: PromptSet - description: AI 서비스에 질의하는 문장 단위입니다. 프롬프트 생성·조회·수정·삭제와 대량 생성을 제공합니다. name: Prompt - description: 실행(Run)에 사용하는 AI 서비스 모델입니다. 지원 모델 목록을 조회합니다. name: Model - description: Run 제출에 사용하는 실행 지역입니다. 지원 리전 목록을 조회합니다. name: Region - description: 프롬프트를 AI 서비스에 실제로 실행하는 작업 단위입니다. Run 제출과 진행 상태·목록 조회를 제공합니다. name: Run - description: 실행으로 수집된 AI 서비스의 응답입니다. 인용 출처·검색 쿼리를 포함한 답변을 조회합니다. name: Answer - description: 답변에 인용된 출처를 도메인·URL 단위로 집계한 지표입니다. 인용 요약, 도메인별·URL별 인용 집계를 조회합니다. name: SourceStatistics - description: 답변 본문의 토큰(Kiwi 명사)을 집계한 지표입니다. 많이 나온 토큰 랭킹과 특정 단어의 근접 토큰을 조회합니다. name: AnswerStatistics - description: AI가 답변 생성 시 실제로 던진 검색 쿼리(팬아웃)를 집계한 지표입니다. 검색 쿼리별 등장 횟수 랭킹을 조회합니다. name: FanoutStatistics - description: 텍스트에서 고유명사를 식별하는 부가 기능입니다. 고유명사 추출을 제공합니다. name: ProperNoun - description: 조직 크레딧 잔액 및 플랫폼 API 과금 정보입니다. 현재 크레딧 잔액을 조회합니다. name: Credit externalDocs: description: '' url: '' paths: /v1beta/platform/answers: get: tags: - Answer summary: 답변 목록 조회 description: >- 조직의 답변(실행) 목록을 최신순 cursor 페이지네이션으로 조회합니다. 각 답변은 본문과 함께 인용 출처(sources)·검색 쿼리(fanouts)·원본 마크다운 URL(markdownURL)을 포함하며, PENDING/FAILED 실행도 상태와 함께 반환됩니다. operationId: listAnswers parameters: - description: 특정 Run으로 범위를 좁히는 필터 (제출 시 발급된 Run ID) (ID 문자열) in: query name: runID schema: type: string - description: 특정 프롬프트 세트로 범위를 좁히는 필터 (ID 문자열) in: query name: promptSetID schema: type: string - description: 특정 프롬프트로 범위를 좁히는 필터 (ID 문자열) in: query name: promptID schema: type: string - description: '특정 모델로 범위를 좁히는 필터 (예: CHATGPT)' in: query name: model schema: type: string - description: '특정 지역으로 범위를 좁히는 필터 (예: KR)' in: query name: region schema: type: string - description: 실행 상태 필터 (PENDING, SUCCESS, FAILED) in: query name: status schema: type: string - description: 생성일 시작 (RFC3339) in: query name: from schema: type: string - description: 생성일 종료 (RFC3339) in: query name: to schema: type: string - description: 이전 응답의 nextCursor (첫 요청은 생략) in: query name: cursor schema: type: string - description: 페이지 크기 (기본 20, 최대 100) in: query name: limit schema: type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/domain.ListAnswersResponse' description: OK '400': content: application/json: schema: $ref: '#/components/schemas/domain.Error' description: >- 잘못된 요청: cursor 형식 오류(COMMON_INVALID_CURSOR), limit 범위 위반(1~100), 또는 status 값 오류 '401': content: application/json: schema: $ref: '#/components/schemas/domain.Error' description: '인증 실패: API 키가 유효하지 않습니다' '402': content: application/json: schema: $ref: '#/components/schemas/domain.Error' description: 크레딧 부족 (INSUFFICIENT_CREDITS) '429': content: application/json: schema: $ref: '#/components/schemas/domain.Error' description: 요청 한도 초과 (PLATFORM_RATE_LIMIT_EXCEEDED, Retry-After 헤더 참조) '500': content: application/json: schema: $ref: '#/components/schemas/domain.Error' description: 서버 내부 오류 security: - OrgAPIKeyAuth: [] components: schemas: domain.ListAnswersResponse: properties: answers: description: 답변 목록 items: $ref: '#/components/schemas/domain.AnswerDTO' type: array uniqueItems: false nextCursor: description: 다음 페이지 cursor (더 이상 없으면 null) type: string type: object domain.Error: properties: code: type: string details: {} type: object domain.AnswerDTO: properties: content: description: 분류된 답변 본문 (미완료/건너뜀이면 빈 문자열) type: string createdAt: description: 생성 일시 (RFC3339) type: string fanouts: description: AI가 답변 생성 시 수행한 검색 쿼리(query fan-out) 목록. 페이지네이션 없이 전체 제공 items: type: string type: array uniqueItems: false id: description: 답변 ID (내부 task_content ID) type: string markdownURL: description: 답변 원본 마크다운(스크래핑 원문)의 CDN URL. 원본이 없거나 변환 실패 시 null(생략) type: string model: description: '실행된 모델 (예: CHATGPT)' type: string promptID: description: 답변 대상 프롬프트 ID type: string query: description: 실행된 질의 텍스트 type: string region: description: '지역 코드 (예: KR)' type: string runID: description: 이 답변을 생성한 Run ID (제출 시 발급). 연관 Run이 없으면 생략 type: string sources: description: 답변에 인용된 출처 목록. 페이지네이션 없이 전체 제공 items: $ref: '#/components/schemas/domain.AnswerSourceDTO' type: array uniqueItems: false status: description: '실행 상태 (PENDING: 진행중, SUCCESS: 완료, FAILED: 실패 또는 스킵)' type: string required: - id - model - promptID - region - status type: object domain.AnswerSourceDTO: properties: domain: description: >- 출처 도메인 (eTLD+1, 예: naver.com). 출처 집계 API의 domain 필터에 그대로 넣을 수 있다. 판별 실패 시 생략 type: string title: description: 출처 콘텐츠 제목 (분류 전이면 빈 문자열) type: string url: description: 출처 URL type: string type: object securitySchemes: OrgAPIKeyAuth: description: '"조직 API 키를 입력하세요. 예: ''cs_live_xxxx'' 또는 ''cs_test_xxxx''"' in: header name: API-Key type: apiKey ````