플랫폼 가용성
- 24시간 상태
- 정상
최근 30일
제공 기능
각 Douban 액션의 기능, 가격, 최근 24시간 상태를 확인할 수 있습니다. 액션을 열면 파라미터, 응답 필드, 코드 예제를 볼 수 있습니다.
기능을 열면 파라미터, 응답 필드, 코드 샘플을 확인하고 직접 사용해 볼 수 있습니다.
Douban 액션별로 어떤 입력을 받나요?
아래 각 답변은 호출 가능한 액션 하나와 실제 입력값을 짝지어 보여 줍니다. 파라미터의 의미와 허용 값은 액션마다 다릅니다. 익숙한 이름이라도 모든 플랫폼에서 같은 의미를 갖지는 않습니다.
공식 출처 링크는 옆에 있는 플랫폼 용어를 설명하기 위한 것입니다. 플랫폼의 승인이나 보증을 의미하지 않으며, 이 페이지에 명시되지 않은 공식 사이트의 기능은 EveryInfra API에 포함되지 않습니다.
| 액션 | 필수 | 선택 | 전달 방식 | 한도 | 1,000건당 | 응답 필드 |
|---|---|---|---|---|---|---|
search검색 제목이나 주제로 Douban에서 영화, 책, 앨범을 찾습니다. 연도, 감독과 출연진, 저자 또는 아티스트, 평점, 평가자 수, 커버를 가져옵니다. | keyword | search_type, type | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · subject_type · year · director · cast · author · artist · rating · rating_scale · rating_count · cover_url · platform |
reviews리뷰 작품 링크로 Douban의 영화, 책, 앨범에 대한 장문 리뷰를 읽어 옵니다. 각 리뷰에는 제목, 본문, 평점 라벨, 작성자, 답글 수가 포함됩니다. 평점은 각 리뷰에 속한 값입니다. 결과에 해당 작품의 모든 리뷰가 포함되지 않을 수 있습니다. | url | — | Sync 응답 | 카탈로그 값: defaultLimit=15, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $24행 1개당 호출 1회로 계산 | id · url · subject_id · subject_name · subject_type · title · text · rating · rating_scale · rating_label · author_name · author_url · author_avatar_url · reply_count · posted_at · platform |
comments댓글 작품 링크로 Douban의 영화, 책, 앨범에 달린 단평을 나열합니다. 각 단평에는 텍스트, 평점 라벨, 작성자, 추천 수, 날짜가 포함됩니다. 이 짧은 단평은 | url | — | Sync 응답 | 카탈로그 값: defaultLimit=20, maxLimit=200. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · subject_id · subject_name · subject_type · text · rating · rating_scale · rating_label · author_name · author_url · author_avatar_url · vote_count · posted_at · platform |
group_topic그룹 토픽 토픽 링크로 Douban 그룹 토론을 읽어 옵니다. 첫 게시물, 그룹 이름과 링크, 작성자, 답글 수, 답글을 가져옵니다. | url | max_replies | Sync 응답 | 카탈로그 값: defaultLimit=10, maxLimit=50. 일부 액션에서는 limit이 페이지 수나 상위 항목별 확장 수를 제어하므로 항상 최종 행 수를 뜻하지는 않습니다. | 요청 1,000개당 $1.39 | id · url · title · text · group_id · group_name · group_url · author_name · author_url · reply_count · replies · posted_at · platform |
Douban search 파라미터는 각각 무엇을 의미하나요?
제목이나 주제로 Douban에서 영화, 책, 앨범을 찾습니다. 연도, 감독과 출연진, 저자 또는 아티스트, 평점, 평가자 수, 커버를 가져옵니다. search_type으로 결과를 영화, 책, 음악으로 제한할 수 있습니다. 두 값을 모두 보내면 type이 우선합니다.
keyword필수- Douban에서 영화, 도서, 음악 항목을 찾기 위한 제목 또는 주제 검색어를 지정합니다. 장문 리뷰나 그룹 토픽 본문은 전문 검색하지 않습니다.
search_type선택- all(기본값), movie, book, music으로 항목 카테고리 탐색 결과를 필터링합니다. type을 함께 지정하면 type이 우선하며, 인식할 수 없는 값은 all로 대체됩니다.허용 값:
allbookmoviemusic type선택- search_type보다 우선 적용되며, 카테고리(all, movie, book, music)로 항목 탐색 결과를 필터링합니다. 카탈로그 항목 유형만 필터링하며, reviews(장문 리뷰)와 comments(단문 댓글) 중 무엇을 가져올지는 액션 유형으로 결정됩니다.허용 값:
allbookmoviemusicDouban 도서: 책 평점과 리뷰의 범위 — Douban 도서는 평점, 장문 리뷰, 단문 리뷰를 구분하며, 책의 평점을 다른 피드백과 함께 고려하라고 권장합니다. 이는 도서 항목의 평가 맥락을 설명하기 위한 것으로, 점수가 가치의 객관적 척도라는 뜻이 아니며 웹사이트 전용 기능이 이 엔드포인트에 추가되는 것도 아닙니다. · 확인일
Douban reviews 파라미터는 각각 무엇을 의미하나요?
작품 링크로 Douban의 영화, 책, 앨범에 대한 장문 리뷰를 읽어 옵니다. 각 리뷰에는 제목, 본문, 평점 라벨, 작성자, 답글 수가 포함됩니다. 평점은 각 리뷰에 속한 값입니다. 결과에 해당 작품의 모든 리뷰가 포함되지 않을 수 있습니다.
전체 API 레퍼런스: 파라미터, 코드 예제, 응답 예시, 상태url필수- reviews 또는 comments 액션에서는 movie.douban.com, book.douban.com, music.douban.com의 /subject/<ID>/ 형식 URL을 지정하고, group_topic에서는 www.douban.com/group/topic/<ID>/ 형식 URL을 지정합니다. 장문 리뷰, 단문 댓글, 그룹 토픽 답글은 각각 별도의 액션 엔드포인트에서 처리합니다.Douban 영화: 장문 리뷰, 단문 리뷰, 공개 범위 제한 — Douban 영화는 영화 리뷰와 단문 리뷰를 따로 설명하며, 단문 리뷰 영역에 모든 단문 리뷰가 표시되지는 않고 접힌 콘텐츠는 공개 범위가 다르다고 안내합니다. 이 엔드포인트가 반환하는 영화 리뷰 목록을 전체 기록이나 모든 관객 의견으로 간주하면 안 됩니다. 이 자료는 도서나 음악에 적용되는 별도 규칙을 대신하지 않습니다. · 확인일
Douban comments 파라미터는 각각 무엇을 의미하나요?
작품 링크로 Douban의 영화, 책, 앨범에 달린 단평을 나열합니다. 각 단평에는 텍스트, 평점 라벨, 작성자, 추천 수, 날짜가 포함됩니다. 이 짧은 단평은 reviews가 반환하는 장문 리뷰와 별개입니다.
url필수- reviews 또는 comments 액션에서는 movie.douban.com, book.douban.com, music.douban.com의 /subject/<ID>/ 형식 URL을 지정하고, group_topic에서는 www.douban.com/group/topic/<ID>/ 형식 URL을 지정합니다. 장문 리뷰, 단문 댓글, 그룹 토픽 답글은 각각 별도의 액션 엔드포인트에서 처리합니다.Douban 영화: 장문 리뷰, 단문 리뷰, 공개 범위 제한 — Douban 영화는 영화 리뷰와 단문 리뷰를 따로 설명하며, 단문 리뷰 영역에 모든 단문 리뷰가 표시되지는 않고 접힌 콘텐츠는 공개 범위가 다르다고 안내합니다. 이 엔드포인트가 반환하는 영화 리뷰 목록을 전체 기록이나 모든 관객 의견으로 간주하면 안 됩니다. 이 자료는 도서나 음악에 적용되는 별도 규칙을 대신하지 않습니다. · 확인일
Douban group_topic 파라미터는 각각 무엇을 의미하나요?
토픽 링크로 Douban 그룹 토론을 읽어 옵니다. 첫 게시물, 그룹 이름과 링크, 작성자, 답글 수, 답글을 가져옵니다. max_replies로 가져올 답글 수를 1~100개(기본값 20) 범위에서 지정합니다. 비공개 그룹은 접근할 수 없으며, 스레드가 완전하지 않을 수 있습니다.
url필수- reviews 또는 comments 액션에서는 movie.douban.com, book.douban.com, music.douban.com의 /subject/<ID>/ 형식 URL을 지정하고, group_topic에서는 www.douban.com/group/topic/<ID>/ 형식 URL을 지정합니다. 장문 리뷰, 단문 댓글, 그룹 토픽 답글은 각각 별도의 액션 엔드포인트에서 처리합니다.Douban 그룹: 토픽 읽기는 멤버 관리와 별개 — Douban 도움말은 그룹 가입, 토픽 고정, 멤버 관리를 각각 별개의 기능으로 안내하며, 일부 작업에는 그룹장이나 관리자 권한이 필요합니다. 여기서 특정 토픽을 가져오고 관리 문서를 인용한다고 해서 그 권한이 주어지지는 않으며, 가입, 게시, 관리 작업도 제공하지 않습니다. · 확인일
max_replies선택- group_topic이 요청당 가져오는 토픽 답글 수를 제한하며, 1~100 사이의 정수를 받습니다(기본값 20). 범위를 벗어난 값은 경계값으로 조정되고, 해석할 수 없는 값은 기본값으로 되돌아갑니다. 반환된 답글 수만으로 과거 답글을 모두 가져왔다고 볼 수는 없습니다.
Douban API 사용 방법
- 01공개 카탈로그에서 플랫폼 액션을 선택합니다.
- 02플랫폼, 액션, 필수 파라미터를 POST /api/v1/social로 보냅니다.
- 03응답에서 결과를 읽습니다. 비동기 액션이면 반환된 작업 ID를 폴링합니다.
- 04애플리케이션에 필요한 응답 필드를 저장합니다.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"douban","action":"search","params":{"keyword":"<keyword>"}}'
Douban API 자주 묻는 질문
Douban API로 무엇을 가져올 수 있나요?
platform을 douban 값으로 설정하세요. 현재 카탈로그에 등록된 항목은 검색, 리뷰, 댓글 및 그룹 토픽입니다. 각 액션 이름은 서로 다른 Douban 객체나 뷰를 가리키며, 서로 바꿔 쓸 수 있는 검색 모드가 아닙니다.
Douban search 요청에는 어떤 입력이 필요한가요?
Douban에서 영화, 도서, 음악 항목을 찾기 위한 제목 또는 주제 검색어를 지정합니다. 장문 리뷰나 그룹 토픽 본문은 전문 검색하지 않습니다. params 안의 keyword 필드로 전달하세요.
Douban search 액션은 어떤 필드를 반환하나요?
선언된 스키마에 포함된 필드는 title, subject_type, year 및 director입니다. 선언된 필드라도 개별 레코드에는 없을 수 있으며, 다른 액션은 각각 고유한 필드 목록을 가집니다.
모든 Douban 액션이 즉시 결과를 반환하나요?
비동기로 표시된 액션은 폴링할 작업 ID를 반환합니다. 그 밖의 모든 액션도 비동기로 실행할 수 있습니다. 요청 본문에 "mode": "async"를 추가하면 작업 ID를 즉시 받을 수 있어, 오래 걸리는 작업이나 조회 한도가 큰 요청에 유용합니다. 현재 카탈로그의 액션 구성은 sync 응답입니다.