# 친구 목록 조회

## 아이템 블록

현재 로그인한 사용자의 카카오계정에 연결된 카카오톡의 친구 정보를 받아 옵니다.

<figure><img src="/files/iczDj5XBIrq5AbGhB79S" alt=""><figcaption></figcaption></figure>

## 설정 팝업

<figure><img src="/files/8fNQFA1Hq7VrLSTd4tDS" alt=""><figcaption></figcaption></figure>

## 설정 필드

### Access Token

사용자 인증 수단이며, 사용자 정보를 요청하고자 하는 사용자를 구분하는 키 입니다.

### 시작 Index

친구 목록 조회의시작 지점입니다. (기본값: 0)

### 조회갯수

한 페이지에 가져올 친구 최대 수  입니다. (기본값: 10, 최대: 100)

### 정렬방식

친구 목록 조회의정렬 순서입니다.  오름차순 또는 내림차순 중 선택해주세요. (기본값:오름차순)

### 정렬기준

친구 목록 정렬 시 기준 설정을 해 주세요. <mark style="color:blue;">**즐겨찾기 친구 우선 정렬**</mark>과 <mark style="color:blue;">**닉네임 순서 정렬**</mark>이 있습니다. (기본값: 즐겨찾기 친구 우선 정렬)

## 응답

자세한 응답 내용은 아래 링크를 통해 카카오 API  문서를 확인해주세요.

<https://developers.kakao.com/docs/latest/ko/kakaotalk-social/rest-api#get-friends-response>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.apidrag.com/kakao-api/references/kakaotalk-social/friends-list.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.