> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Perplexity API: 답변, 인용, 검색어

> Perplexity에 질문하고 답변, 인용 출처, 관련 질문, 검색어, 미디어를 받습니다.

`PERPLEXITY`는 Perplexity에 묻고, 답변과 인용한 출처, 모델이 실행한 검색을 반환합니다.

| | |
| - | - |
| taskType | `PERPLEXITY` |
| 읽는 필드 | `prompt` (없으면 `query`) |
| 크레딧 | 1 |
| 국가 | 선택, 기본값 `US`. `CN`은 `422 REGION_UNSUPPORTED`로 거절됩니다. |

## 요청

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "PERPLEXITY", "payload": { "prompt": "best CRM for a small team", "country": "US", "include": { "searchQueries": true } } }'
```

## 응답

| 필드 | 타입 | 설명 |
| - | - | - |
| `text` | string | 답변. 항상 있습니다. |
| `sources` | array | 인용 출처: `position`, `url`, `label`, `description`. 항상 있습니다. |
| `related_queries` | string\[] | Perplexity가 제안하는 후속 질문. |
| `search_model_queries` | array | Perplexity 모델이 실행한 검색. 각각 `{ query, engine, limit }`. |
| `searchQueries` | string\[] | 같은 검색을 일반 문자열로. `include.searchQueries`일 때만. |
| `images`, `videos` | array | 답변과 함께 나온 미디어: `title`, `url`, `medium`, `image`, `thumbnail`, `source`, `image_width`, `image_height`, 동영상에는 `duration`. |
| `markdown` | string | Markdown 답변. 이미지는 제자리에 놓입니다. `include.markdown`일 때만. |
| `rawResponse` | array | 파싱된 스트림 이벤트. `include.rawResponse`일 때만. |

`images`와 `videos`에서 `url`은 항목이 나온 페이지이고 `image`는 그림 자체입니다.

예시:

```json theme={"theme":"css-variables"}
{
  "text": "HubSpot CRM and Pipedrive are the most common choices for small teams ...",
  "sources": [
    { "position": 1, "url": "https://www.example.com/crm-review", "label": "Best CRM for small teams", "description": "..." }
  ],
  "related_queries": ["Is HubSpot CRM free?"],
  "search_model_queries": [{ "query": "best CRM small team", "engine": "web", "limit": 8 }],
  "searchQueries": ["best CRM small team"]
}
```

`related_queries`는 사용자에게 보여 주는 제안입니다. `search_model_queries`와 `searchQueries`가 Perplexity가 실제로 검색한 내용입니다.

## include 플래그

| 플래그 | 효과 |
| - | - |
| `markdown` | `markdown`을 추가합니다. |
| `searchQueries` | `searchQueries`를 추가합니다. |
| `rawResponse` | `rawResponse`를 추가합니다. |
| `html` | Perplexity가 보여 준 화면인 `html`을 추가합니다. 페이지가 저장되면 0.25크레딧. [HTML 페이지](/ko/engines/html-pages.md)를 참고하세요. |
| `analysis` | `analysis`를 추가합니다. 1크레딧. [답변 분석](/ko/engines/answer-analysis.md)을 참고하세요. |
| `citationAnalysis` | 답변에 [Citation Analysis](/ko/research/citation-analysis.md)를 실행합니다. |

`ads`와 `shopping`은 효과가 없습니다. [Markdown과 원본 응답](/ko/engines/response-options.md)을 참고하세요.

## 관련 문서

* [Perplexity 제품 페이지](https://querying.ai/ko/engines/perplexity)
* [엔진 개요](/ko/engines/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.