> ## 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 페이지네이션으로 답변을 조회하고, 응답 구조 이해하기

수집된 답변은 `GET /answers`로 조회합니다. 실행 완료 여부와 무관하게 언제든 호출할 수 있으며, 이미 수집된 답변부터 반환됩니다.

## 답변 조회

```bash theme={null}
curl -H "API-Key: YOUR_API_KEY" \
  "https://dev-platform-api.trychainshift.ai/api/v1beta/platform/answers?runID=0PCCDohFaNRcUWjLGoBGfw&model=CHATGPT&status=SUCCESS"
```

아래는 실제 수집 응답입니다(본문은 일부만 남겼습니다).

```json theme={null}
{
  "answers": [
    {
      "id": "nyyblp5Yzq7gjZ3GKYopFw",
      "runID": "0PCCDohFaNRcUWjLGoBGfw",
      "promptID": "W-KMZMXwDB7ihFtj5CMHSQ",
      "query": "2000만원대 중고 SUV 추천해줘",
      "model": "CHATGPT",
      "region": "KR",
      "status": "SUCCESS",
      "content": "2000만원대 중고 SUV라면 “연식·크기·유지비” 균형을 보면 선택지가 꽤 좋습니다. 현재 시세 기준으로는 기아 셀토스, 현대 투싼, 기아 스포티지, 현대 싼타페 구형 세대 등이 많이 거론됩니다.\n제가 추천 순위를 매기면… (이하 생략)",
      "sources": [
        {
          "url": "https://car.ambitstock.com/domestic-suv-recommend-top7-segment-guide",
          "title": "국산 SUV 추천 TOP 7 — 2026년 가성비·연비·실내공간 세그먼트별 비교 | 모빌리티 인사이트",
          "domain": "ambitstock.com"
        },
        {
          "url": "https://car.ambitstock.com/mid-size-suv-recommend-top7-value-compare",
          "title": "중형 SUV 추천 TOP 7 — 3~5천만원대 국산·수입 가성비·연비·공간 완전 비교 (2026) | 모빌리티 인사이트",
          "domain": "ambitstock.com"
        }
      ],
      "fanouts": [
        "2026년 중고 SUV 2000만원대 추천 쏘렌토 싼타페 투싼 스포티지 시세"
      ],
      "markdownURL": "https://markdown-cdn.trychainshift.ai/a03e36ff-e99e-40d9-92d3-0784823f9b5b.md",
      "createdAt": "2026-07-28T06:27:40Z"
    }
  ],
  "nextCursor": "eyJpZCI6Njk0NTY5fQ"
}
```

이 응답 하나에 AEO 분석의 재료가 다 들어 있습니다: ChatGPT가 이 질문에 **어떤 답을 했고**(`content`), **어떤 페이지를 근거로 인용했으며**(`sources` — 이 예시에서는 특정 자동차 블로그의 두 글), **그 답을 만들기 위해 실제로 어떤 검색어를 던졌는지**(`fanouts`)까지. sources에 내 사이트가 등장하는지, fanouts의 검색어에서 내 콘텐츠가 검색되는지가 곧 AEO 액션 아이템이 됩니다.

### 필터

| 파라미터          | 설명                                            |
| ------------- | --------------------------------------------- |
| `runID`       | 특정 실행 요청의 답변만                                 |
| `promptSetID` | 특정 프롬프트 세트의 답변만                               |
| `promptID`    | 특정 프롬프트의 답변만                                  |
| `model`       | 특정 모델의 답변만 (예: `CHATGPT`)                     |
| `region`      | 특정 지역의 답변만 (예: `KR`)                          |
| `status`      | `PENDING` / `SUCCESS` / `FAILED`              |
| `from` / `to` | 생성 일시 범위 (RFC3339, 예: `2026-07-01T00:00:00Z`) |

## 페이지네이션

모든 목록 엔드포인트는 cursor 방식을 사용합니다.

1. 첫 요청은 `cursor` 없이 보냅니다. 페이지 크기는 `limit`으로 지정합니다(답변 기본 20, 최대 100).
2. 응답의 `nextCursor` 값을 다음 요청의 `cursor` 파라미터로 그대로 전달합니다.
3. `nextCursor`가 `null`이면 마지막 페이지입니다.

```bash theme={null}
curl -H "API-Key: YOUR_API_KEY" \
  "https://dev-platform-api.trychainshift.ai/api/v1beta/platform/answers?runID=0PCCDohFaNRcUWjLGoBGfw&limit=100&cursor=eyJpZCI6Njk0NTY5fQ"
```

<Note>
  필터 조건을 바꾸면 cursor를 비우고 첫 페이지부터 다시 조회하세요. 이전 조건에서 발급된 cursor를 다른 조건과 섞어 쓰면 결과가 어긋납니다.
</Note>

## 응답 필드 이해하기

* `content` — 답변 본문 텍스트.
* `sources` — AI가 답변에 인용한 출처 목록. 출처별 URL·제목·도메인을 포함합니다. 출처에서 실제 인용된 문장이 필요하면 [인용 URL 랭킹](/guides/analytics#인용-url-랭킹)의 `include=quotes`를 사용하세요.
* `fanouts` — AI가 답변을 만들기 위해 내부적으로 던진 검색 쿼리 목록. [지원 모델](/models)의 fan-out 설명 참고.
* `markdownURL` — 답변 원문 마크다운 파일 URL. 없으면 필드 자체가 생략됩니다.

<Warning>
  `fanouts` · `sources`는 모델과 답변에 따라 비어 있을 수 있습니다. 빈 값이 언제 정상 동작인지는 [답변 객체](/api-reference/answers/answer-object)의 빈 값 규칙을 참고하세요.
</Warning>

## 브랜드 언급 측정하기

브랜드명이 몇 개의 답변에 등장하는지는 [답변 토큰 빈도](/guides/analytics#답변-토큰-빈도)로 측정합니다(실측 예시: "중고차"가 등장한 답변 124건). 토큰 통계는 `runID`·`promptID`로 범위를 좁힐 수 있어 실행별 언급 비교에도 쓸 수 있습니다. 언급의 문맥 — 브랜드가 어떤 단어와 함께 등장하는지 — 은 [근접 토큰](/guides/analytics#근접-토큰-neighbors)으로 확인합니다.

## 다음 단계

<Card title="통계로 분석하기" icon="chart-column" href="/guides/analytics">
  출처 도메인 랭킹, 토큰 빈도, fan-out 집계로 답변을 요약하기
</Card>