자체 방문 통계는 항상 수집됩니다. 사용자가 공개 페이지를 어떻게 이용하는지 파악하는 데 쓰이는 Google Analytics(로그인한 워크스페이스는 제외)는 동의한 경우에만 사용됩니다. 자세한 내용은 개인정보 처리방침을 참고하세요.

Discord API

이 Discord 서버 API는 초대 링크나 키워드로 공개 서버를 조회해 JSON으로 반환합니다. 서버 디렉터리 탐색과 이름으로 사용자 찾기도 지원합니다.

초대 코드나 URL을 전달하면 커뮤니티에 참여하지 않고도 공개 서버 메타데이터를 확인할 수 있습니다.

플랫폼 가용성

24시간 상태
정상
정상

최근 30일

제공 기능

각 Discord 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.

기능설명1,000건당24시간 상태
검색search키워드와 일치하는 Discord 서버를 찾습니다.요청 1,000개당 $1.39정상
디렉터리directoryDiscord 서버 디렉터리를 탐색하며, 카테고리를 선택적으로 지정할 수 있습니다.요청 1,000개당 $1.39정상
서버serverDiscord 초대 코드나 링크로 서버 이름, 설명, 멤버 수와 온라인 멤버 수, 부스트, 인증 레벨, 채널, 초대한 사람, 만료 시각을 조회합니다.요청 1,000개당 $1.39정상
사용자 검색search_users사용자 이름이나 표시 이름으로 Discord 사용자를 조회해 각 계정의 ID, 프로필 이미지, 클랜 태그, 생성일, 서버 수와 초대 수를 가져옵니다.요청 1,000개당 $1.39정상

기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.

Discord 액션별로 어떤 입력을 받나요?

아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.

공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.

액션필수선택전달 방식한도1,000건당응답 필드
search

검색

키워드와 일치하는 Discord 서버를 찾습니다. 설명, 멤버 수와 온라인 멤버 수, 부스트 수, 언어, 카테고리, 인증 수준, NSFW 여부를 가져옵니다. 서버 내부 메시지를 검색하지 않으며 비공개 커뮤니티에 접근하지도 않습니다.

keyword—Sync 응답카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $1.39id · name · url · text · member_count · online_count · boost_count · vanity_url_code · language · categories · keywords · icon_url · banner_url · verification_level · is_nsfw · created_at · directory_url · platform
directory

디렉터리

Discord 서버 디렉터리를 탐색하며, 카테고리를 선택적으로 지정할 수 있습니다. 각 서버에는 설명, 멤버 수와 온라인 멤버 수, 부스트 수, 언어, 태그, 인증 수준이 포함됩니다. category에는 gaming, entertainment, education, music, science-and-tech 중 하나를 지정할 수 있습니다. 인식되지 않는 값은 무시됩니다.

categorySync 응답카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $1.39id · name · url · text · member_count · online_count · boost_count · vanity_url_code · language · categories · keywords · icon_url · banner_url · verification_level · is_nsfw · created_at · directory_url · platform
server

서버

Discord 초대 코드나 링크로 서버 이름, 설명, 멤버 수와 온라인 멤버 수, 부스트, 인증 레벨, 채널, 초대한 사람, 만료 시각을 조회합니다. 초대를 조회해도 서버에 참여하지 않으며, expires_at이 null이면 만료되지 않는 초대입니다.

invitecode, urlSync 응답—요청 1,000개당 $1.39id · name · url · text · member_count · online_count · boost_count · invite_code · vanity_url_code · icon_url · banner_url · verification_level · nsfw_level · channel_name · channel_type · inviter_username · inviter_name · expires_at · platform
search_users

사용자 검색

사용자 이름이나 표시 이름으로 Discord 사용자를 조회해 각 계정의 ID, 프로필 이미지, 클랜 태그, 생성일, 서버 수와 초대 수를 가져옵니다. 전체 멤버 검색이 아니며 비공개 관계 정보는 노출하지 않습니다.

keyword—Sync 응답카탈로그 값: defaultLimit=20, maxLimit=100. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다.요청 1,000개당 $1.39id · username · name · avatar · clan_tag · server_count · invite_count · created_at · platform

Discord search 파라미터는 각각 무엇을 의미하나요?

키워드와 일치하는 Discord 서버를 찾습니다. 설명, 멤버 수와 온라인 멤버 수, 부스트 수, 언어, 카테고리, 인증 수준, NSFW 여부를 가져옵니다. 서버 내부 메시지를 검색하지 않으며 비공개 커뮤니티에 접근하지도 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
search에서는 공개 Discord 서버 탐색에, search_users에서는 사용자 이름과 표시 이름으로 공개 사용자를 매칭하는 데 사용할 검색어를 지정합니다. 채널 메시지는 색인하지 않으며, 비공개 서버 접근 권한을 부여하지 않습니다.
Discord Discover: 커뮤니티 서버 찾기 — Discord 공식 문서는 Discover Servers를 카테고리별로 둘러볼 수 있는 검색 가능한 커뮤니티 서버로 정의합니다. 이는 서버, 카테고리, 탐색 개념을 설명할 뿐이며, 클라이언트 실험 상태나 디렉터리 전체 커버리지를 API가 보장하는 것으로 제시하지 않습니다. · 확인일

Discord directory 파라미터는 각각 무엇을 의미하나요?

Discord 서버 디렉터리를 탐색하며, 카테고리를 선택적으로 지정할 수 있습니다. 각 서버에는 설명, 멤버 수와 온라인 멤버 수, 부스트 수, 언어, 태그, 인증 수준이 포함됩니다. category에는 gaming, entertainment, education, music, science-and-tech 중 하나를 지정할 수 있습니다. 인식되지 않는 값은 무시됩니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
category선택
디렉터리의 서버 탐색 결과를 사전 정의된 값으로 필터링합니다: gaming, entertainment, education, music, science-and-tech. 지정하지 않으면 필터링되지 않은 디렉터리 결과를 반환하며, 인식되지 않는 카테고리는 무시됩니다.
Discord 서버 카테고리와 탐색 범위 — Discord 공식 문서는 게임, 음악, 엔터테인먼트 등의 커뮤니티 카테고리를 제시합니다. 지원되는 카테고리는 이 페이지에 나열된 것으로 한정되며, 이전 Discovery 문서의 카테고리나 정렬 기능은 적용하지 않습니다. · 확인일

Discord server 파라미터는 각각 무엇을 의미하나요?

Discord 초대 코드나 링크로 서버 이름, 설명, 멤버 수와 온라인 멤버 수, 부스트, 인증 레벨, 채널, 초대한 사람, 만료 시각을 조회합니다. 초대를 조회해도 서버에 참여하지 않으며, expires_at이 null이면 만료되지 않는 초대입니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
invite필수
초대 코드 자체 또는 전체 URL 형식(discord.gg/<code> 또는 discord.com/invite/<code>)으로 대상 서버를 지정합니다. server 액션은 서버에 참여하지 않고 초대에 연결된 공개 메타데이터를 읽습니다. 초대가 만료되었거나 유효하지 않더라도 서버가 존재하지 않는다는 의미는 아닙니다.
Discord 초대: 초대 코드, 서버, 채널은 별개의 객체다 — Discord 공식 Invite 객체는 `code`, `guild`, `channel`, `inviter`, `expires_at`을 구분하며, 초대에서 반환되는 멤버 수는 근사치로 취급합니다. 이 참고 자료는 객체 간 관계와 집계 수치의 한계를 설명할 뿐이며, 초대 생성·삭제나 대상 사용자 관리를 지원한다는 의미는 아닙니다. · 확인일
code선택
초대 링크의 초대 코드 부분을 받는 invite 파라미터의 호환용 별칭입니다. 요청에는 여전히 필수 파라미터인 invite를 전달해야 하며, 이 필드는 인증 코드, 봇 토큰, 서버 ID를 받지 않습니다.
url선택
Discord 초대 링크 전체를 받는 invite 파라미터의 호환용 별칭입니다. 요청에는 여전히 필수 파라미터인 invite를 전달해야 하며, 채널 메시지 링크는 유효한 초대로 인정되지 않습니다.

Discord search_users 파라미터는 각각 무엇을 의미하나요?

사용자 이름이나 표시 이름으로 Discord 사용자를 조회해 각 계정의 ID, 프로필 이미지, 클랜 태그, 생성일, 서버 수와 초대 수를 가져옵니다. 전체 멤버 검색이 아니며 비공개 관계 정보는 노출하지 않습니다.

전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태
keyword필수
search에서는 공개 Discord 서버 탐색에, search_users에서는 사용자 이름과 표시 이름으로 공개 사용자를 매칭하는 데 사용할 검색어를 지정합니다. 채널 메시지는 색인하지 않으며, 비공개 서버 접근 권한을 부여하지 않습니다.
Discord: 고유 사용자 이름, 표시 이름, 서버 별명은 어떻게 다른가 — Discord 공식 자료는 고유 사용자 이름을 수정 가능한 표시 이름 및 우선 표시되는 서버 별명과 구분합니다. 이 구분은 반환되는 후보 필드를 명확히 하지만, 전체 사용자 디렉터리나 멤버십 조회 기능을 의미하지는 않습니다. · 확인일

Discord API 사용 방법

  1. 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
  2. 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
  3. 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
  4. 04애플리케이션에 필요한 응답 필드를 저장합니다.
discord_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"discord","action":"search","params":{"keyword":"<keyword>"}}'

Discord API 자주 묻는 질문

Discord API로 무엇을 가져올 수 있나요?

platform을 discord 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 디렉터리, 서버 및 사용자 검색입니다. 각 액션 이름은 서로 다른 Discord 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.

Discord search 요청에는 어떤 입력이 필요한가요?

search에서는 공개 Discord 서버 탐색에, search_users에서는 사용자 이름과 표시 이름으로 공개 사용자를 매칭하는 데 사용할 검색어를 지정합니다. 채널 메시지는 색인하지 않으며, 비공개 서버 접근 권한을 부여하지 않습니다. params 안의 keyword 필드로 전달하세요.

Discord search 액션은 어떤 필드를 반환하나요?

선언된 스키마에 포함된 필드는 name, text, member_count 및 online_count입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.

모든 Discord 액션이 즉시 결과를 반환하나요?

비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.