조회수 18

이 게시물을 읽어주셔서 감사합니다. 구독하는 것을 잊지 마세요!

V2 API 권한은 3가지 카테고리로 나뉩니다.

• 공개(필수 범위 URI: movie_basic_r, movie_basic_w) - 모든 개발자가 사용할 수 있으며, 승인되었습니다. 요청은 분당 40건으로 제한됩니다. 오픈 기본 데이터 인터페이스, 일반 개인 취미로 자체 구축한 웹사이트 또는 애플리케이션이 만족할 것입니다.
• 고급(필수 범위 URI에 해당: movie_advance_r, movie_advance_w) - 일정 기간 운영한 후 비영리 사이트(예: 비영리 도서관, 학교, 자선 단체 등)가 정말 뛰어나고, 두반과 부합하는 가치를 지니며, 저작권 문제가 없고 두반 무비와 경쟁하지 않는 경우 고급 권한을 신청할 수 있습니다. 저작권 문제가 없고 두반 무비와 경쟁하지 않는 경우 고급 권한을 신청할 수 있습니다. 기본적으로 모든 인터페이스를 개방합니다.
• 비즈니스(필수 범위 URI: movie_premium_r, movie_premium_w) - 비즈니스 협력에 사용, 횟수 제한 없음, 제한된 개방형 인터페이스. 상용화된 사이트에는 이 인터페이스를 사용하세요. V2로 마이그레이션한 후에는 API 요구 사항(아래 참조)을 충족하면 열 수 있습니다. 프리미엄 또는 상업용 인터페이스 개방을 신청하려면 bd-team@douban.com 으로 문의하세요.
• 등급은 프로필과 함께 표시되며 “두반 등급'이라는 레이블이 붙어 있어야 합니다.”
• 데이터를 사용하는 경우 영화 데이터 아래에 해당 항목 URL을 가리키는 “두반 영화로 이동” 링크를 추가해야 합니다.
• 영화 리뷰는 개별적으로 “두반 영화”로 표시해야 하며 다른 리뷰 데이터와 혼합할 수 없습니다.
• 애플리케이션에 클라이언트 서비스가 포함된 경우, 이름과 해당 로고에 “Douban“ 및 ”Douban Movie”라는 단어가 포함된 방식으로 클라이언트를 사용해서는 안 됩니다.
• 앱이 두반 데이터, 평점 및 영화 리뷰를 사용하는 경우 앱은 다른 플랫폼에서 제공하는 동일한 유형의 데이터를 사용해서는 안 되며, 자체 평점 및 영화 리뷰 서비스를 구축해서는 안 됩니다.

API 목록

영화 출품작

• 영화 출품 정보
• 영화 응모 스틸
• 영화 출품작에 대한 긴 리뷰
• 영화 출품작에 대한 짧은 리뷰

영화 제작자 출품작

• 영화 제작자 출품 정보
• 섀도우맨 스틸컷
• 영화 제작자의 작업

STH를 찾습니다.

• 영화 검색

이름 목록

• 현재 극장 상영 중
• 곧 출시됩니다.
• Top250
• 공개 칭찬 목록
• 북미 박스오피스 차트
• 새 릴리스

TODO

• [ ] 메인랜드_게시일과 의미가 중복되는 영화의 출품 정보에서 게시일 필드를 제거합니다.

영화 출품 정보

---

리소스 URI

/v2/movie/subject/:id

필수 범위

movie_basic_r

예시.

GET /v2/movie/subject/1764796

상태.

200 OK

리소스 속성.

속성	설명	유형	기본	사전	프리미엄	기본값
id	항목 ID	str	Y	Y	Y	-
title	중국어 이름	str	Y	Y	Y	-
original_title	원래 이름	str	Y	Y	Y	’’
일명	라고도 합니다.	배열	Y	Y	Y	[]
alt	응모 페이지 URL	str	Y	Y	Y	-
mobile_url	모바일 응모 페이지 URL	str	Y	Y	Y	-
평가	득점.부록 참조	dict	Y	Y	Y	-
ratings_count	평점 수	int	Y	Y	Y	0
wish_count	보고 싶은 사람 수	int	Y	Y	Y	0
collect_count	본 사람 수	int	Y	Y	Y	0
do_count	시청자 수, TV 시리즈인 경우 기본값은 0, 영화인 경우 null입니다.	int	Y	Y	Y	0 / null
이미지	영화 포스터 아트워크는 각각 288px x 465px(대형), 96px x 155px(중형), 64px x 103px(소형) 크기로 제공됩니다.	dict	Y	Y	Y	-
하위 유형	카테고리, 영화 또는 TV	str	Y	Y	Y	영화
디렉터	디렉터에 대한 데이터 구조는 Shadowman의부록 참조	배열	Y	Y	Y	[]
캐스트	주연, 최대 4명까지, 데이터 구조는 영화 제작자의부록 참조	배열	Y	Y	Y	[]
작가	시나리오 작가를 영화 제작자에 대한 단순화된 설명으로 데이터 구조와 함께 설명합니다.부록 참조	배열	N	Y	Y	[]
웹사이트	공식 웹사이트	str	N	Y	Y	’’
douban_site	두반, 중국 소셜 네트워킹 웹사이트	str	Y	Y	Y	’’
게시글	출품 유형이 영화인 경우 개봉일, TV 시리즈인 경우 첫 번째 날짜	배열	N	Y	Y	[]
메인랜드_게시	대륙별 개봉일, 출품작 유형이 영화인 경우 개봉일, TV 시리즈인 경우 초연일입니다.	str	N	Y	Y	’’
게시 날짜	향후 삭제될 호환성 데이터, 대륙별 개봉일, 출품작 유형이 영화인 경우 개봉일, TV 시리즈인 경우 초연일입니다.	str	N	Y	Y	’’
년	나이	str	Y	Y	Y	’’
언어	다국어 지원	배열	N	Y	Y	[]
지속 시간	필름 길이	배열	N	Y	Y	[]
장르	영화 장르, 최대 3개	배열	Y	Y	Y	[]
국가	생산 국가/지역	배열	Y	Y	Y	[]
요약	개요	str	Y	Y	Y	’’
댓글 수	짧은 댓글 수	int	Y	Y	Y	0
리뷰 수	영화 리뷰 수	int	Y	Y	Y	0
seasons_count	총 시즌(TV 전용)	int	Y	Y	Y	0 / null
current_season	현재 시즌(TV 전용)	int	Y	Y	Y	0 / null
에피소드_수	현재 시즌 에피소드(TV 전용)	int	Y	Y	Y	0 / null
schedule_url	동영상 페이지 URL(동영상만 해당)	str	Y	Y	Y	’’
trailer_urls	프리미엄 사용자 이상에게 공개되는 트레일러 URL, 최대 4개 주소 공개	배열	N	Y	Y	[]
clip_urls	세그먼트 URL, 프리미엄 사용자 이상에게 개방, 최대 4개 주소 개방	배열	N	Y	Y	[]
blooper_urls	하이라이트 URL, 프리미엄 사용자 이상에게 공개, 최대 4개 주소 열기	배열	N	Y	Y	[]
사진	영화 스틸, 첫 10장.부록 참조	배열	N	Y	Y	[]
인기_리뷰	영화 리뷰, 톱 10, 영화 리뷰 구조.부록 참조	배열	N	Y	Y	[]

영화 제작자 출품 정보

---

리소스 URI

/v2/movie/celebrity/:id

필수 범위

movie_basic_r

예시.

V2/영화/연예인/1054395 받기

상태.

200 OK

리소스 속성.

속성	설명	유형	기본	사전	프리미엄	기본값
id	항목 ID	str	Y	Y	N/A	-
이름	중국어 이름	str	Y	Y	N/A	-
name_en	영어 이름	str	Y	Y	N/A	’’
alt	응모 페이지 URL	str	Y	Y	N/A	-
mobile_url	항목 모바일 URL	str	Y	Y	N/A	-
아바타	사진작가 아바타는 420픽셀 x 600픽셀(대형), 140픽셀 x 200픽셀(중형), 70픽셀 x 100픽셀(소형) 크기로 제공됩니다.	dict	Y	Y	N/A	-
요약	개요	str	N	Y	N/A	’’
일명	더 많은 중국어 이름	배열	Y	Y	N/A	[]
aka_en	더 많은 영어 이름	배열	Y	Y	N/A	[]
웹사이트	공식 웹사이트	str	N	Y	N/A	’’
성별	성별 구분	str	Y	Y	N/A	’’
생일	생년월일	str	N	Y	N/A	’’
born_place	출생지	str	Y	Y	N/A	’’
직업	채용 정보	배열	N	Y	N/A	[]
별자리	별자리	str	N	Y	N/A	’’
사진	배우와 배우의 스틸 사진, 최대 10개까지.부록 참조	배열	N	Y	N/A	[]
작품	영화 제작자의 작품, 최대 5편, 단편 영화 출품 구조.부록 참조	배열	Y	Y	N/A	[]

영화 응모 스틸

---

리소스 URI

/v2/movie/subject/:id/photos

필수 범위

movie_advance_r

예시.

GET /v2/movie/subject/1054395/photos

상태.

200 OK

속성 요청.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	N/A	Y	Y	0
카운트	카운트	int	N/A	Y	Y	10

리소스 속성.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	N/A	Y	Y	0
카운트	카운트	int	N/A	Y	Y	10
합계	집계	int	N/A	Y	Y	0
subject	영화 출품작.부록 참조	dict	N/A	Y	Y	-
사진	쿼리 결과.부록 참조	배열	N/A	Y	Y	-

영화 출품작 리뷰 목록

---

리소스 URI

/v2/movie/subject/:id/reviews

필수 범위

movie_advance_r

예시.

GET /v2/movie/subject/1054395/reviews

상태.

200 OK

속성 요청.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	N/A	Y	Y	0
카운트	카운트	int	N/A	Y	Y	10

리소스 속성.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	N/A	Y	Y	0
카운트	카운트	int	N/A	Y	Y	10
합계	집계	int	N/A	Y	Y	0
subject	영화 출품작.부록 참조	dict	N/A	Y	Y	-
리뷰	영화 리뷰 목록입니다.부록 참조	배열	N/A	Y	Y	-

영화 출품작에 대한 짧은 리뷰 목록

---

리소스 URI

/v2/movie/subject/:id/comments

필수 범위

movie_advance_r

예시.

GET /v2/movie/subject/1054395/comments

상태.

200 OK

속성 요청.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	N/A	Y	Y	0
카운트	카운트	int	N/A	Y	Y	10

리소스 속성.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	N/A	Y	Y	0
카운트	카운트	int	N/A	Y	Y	10
합계	집계	int	N/A	Y	Y	0
subject	영화 출품작.부록 참조	dict	N/A	Y	Y	-
댓글	짧은 댓글 목록입니다.부록 참조	배열	N/A	Y	Y	-

영화 제작자의 작업

---

리소스 URI

/V2/영화/연예인/:ID/작품

필수 범위

movie_advance_r

예시.

V2/영화/연예인/1054395/작품 받기

상태.

200 OK

속성 요청.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	N/A	Y	Y	0
카운트	카운트	int	N/A	Y	Y	5

리소스 속성.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	N/A	Y	Y	0
카운트	카운트	int	N/A	Y	Y	5
합계	집계	int	N/A	Y	Y	0
유명인	영화 제작자 출품작.부록 참조	dict	N/A	Y	Y	-
작품	작품과 해당 캐릭터를 포함한 작품 목록입니다.부록 참조	배열	N/A	Y	Y	-

섀도우맨 스틸컷

---

리소스 URI

/V2/영화/연예인/:ID/사진

필수 범위

movie_advance_r

예시.

GET /v2/movie/celebrity/1054395/photos

상태.

200 OK

속성 요청.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	N/A	Y	Y	0
카운트	카운트	int	N/A	Y	Y	10

리소스 속성.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	N/A	Y	Y	0
카운트	카운트	int	N/A	Y	Y	10
합계	집계	int	N/A	Y	Y	0
유명인	영화 제작자 출품작.부록 참조	dict	N/A	Y	Y	-
사진	스틸 목록입니다.부록 참조	배열	N/A	Y	Y	-

영화 항목 검색

---

리소스 URI

/v2/movie/search?q={text}

필수 범위

movie_basic_r

예시.

GET /v2/movie/search?q=장이머우 GET /v2/movie/search?tag=코미디

상태.

200 OK

속성 요청.

속성	설명	유형	기본	사전	프리미엄	기본값
q	쿼리 문자열	str	Y	Y	Y	-
태그	태그 쿼리 문자열	str	Y	Y	Y	-
시작	시작	int	Y	Y	Y	0
카운트	카운트	int	Y	Y	Y	20

리소스 속성.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	Y	Y	Y	0
카운트	카운트	int	Y	Y	Y	20
합계	총, 기본은 최대 20개의 레코드를 반환합니다.	int	Y	Y	Y	0
쿼리	검색 문자열	str	Y	Y	Y	-
태그	검색 태그	str	Y	Y	Y	-
과목	검색 결과 목록.부록 참조	배열	Y	Y	Y	-

Top250

---

리소스 URI

/v2/movie/top250

필수 범위

movie_basic_r

예시.

GET /v2/movie/top250

상태.

200 OK

속성 요청.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	Y	Y	N/A	0
카운트	카운트	int	Y	Y	N/A	10

리소스 속성.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	Y	Y	N/A	0
카운트	카운트	int	Y	Y	N/A	10
합계	집계	int	Y	Y	N/A	0
title	순위 이름	str	Y	Y	N/A	-
과목	항목 목록입니다.부록 참조	배열	Y	Y	N/A	-

북미 박스오피스 차트

---

리소스 URI

/v2/movie/us_box

필수 범위

movie_basic_r

예시.

GET /v2/movie/us_box

상태.

200 OK

리소스 속성.

속성	설명	유형	기본	사전	프리미엄	기본값
title	순위 이름	str	Y	Y	N/A	-
날짜	차트 날짜 범위	str	Y	Y	N/A	-
과목	USBOX 항목 목록.부록 참조	배열	Y	Y	N/A	-

공개 칭찬 목록

---

리소스 URI

/v2/movie/weekly

필수 범위

movie_advance_r

예시.

GET /v2/movie/weekly

상태.

200 OK

리소스 속성.

속성	설명	유형	기본	사전	프리미엄	기본값
title	순위 이름	str	N/A	Y	N/A	-
과목	주간 항목 목록.부록 참조	배열	N/A	Y	N/A	-

새 릴리스

---

리소스 URI

/v2/movie/새_영화

필수 범위

movie_advance_r

예시.

GET /v2/movie/새_영화

상태.

200 OK

리소스 속성.

속성	설명	유형	기본	사전	프리미엄	기본값
title	순위 이름	str	N/A	Y	N/A	-
과목	항목 목록입니다.부록 참조	배열	N/A	Y	N/A	-

지금 극장에서 상영 중입니다.

---

리소스 URI

/v2/movie/in_theaters

필수 범위

movie_premium_r

예시.

GET /v2/movie/in_theaters

상태.

200 OK

{
    "title":: "극장에서 상영 중인 영화 - 베이징".,
    "total": 39,
    "시작": 0,
    "count": 20,
    "subjects": [, ...] ,
}

속성 요청.

이름	유형	선택 사항	참고
도시	문자열	예(기본값: 베이징)	중국어, 예: “베이징” 또는 디지털 ID: 108288

리소스 속성.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	N/A	Y	Y	0
카운트	카운트	int	N/A	Y	Y	20
합계	집계	int	N/A	Y	Y	0
subject	영화 출품작.부록 참조	dict	N/A	Y	Y	-
title	캡션	str	N/A	Y	Y	현재 극장 상영 중-베이징

곧 출시됩니다.

---

리소스 URI

/v2/movie/coming_soon

필수 범위

movie_premium_r

예시.

GET /v2/movie/coming_soon

상태.

200 OK

{
    "시작": 0,
    "count": 20,
    "title":: "예정된 영화".,
    "total": 39,
    "subjects": [, ...] ,
}

속성 요청.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	Y	Y	N/A	0
카운트	카운트	int	Y	Y	N/A	20

리소스 속성.

속성	설명	유형	기본	사전	프리미엄	기본값
시작	시작	int	N/A	Y	Y	0
카운트	카운트	int	N/A	Y	Y	20
합계	집계	int	N/A	Y	Y	0
subject	영화 출품작.부록 참조	dict	N/A	Y	Y	-
title	캡션	str	N/A	Y	Y	예정된 영화

부록

간단한 유명인 속성

---

속성	설명	유형	기본	사전	프리미엄	기본값
id	섀도우맨 입장 ID	str	Y	Y	Y	-
이름	중국어 이름	str	Y	Y	Y	-
alt	영화 제작자 출품작 URL	str	Y	Y	Y	-
아바타	사진작가 아바타는 420픽셀 x 600픽셀(대형), 140픽셀 x 200픽셀(중형), 70픽셀 x 100픽셀(소형) 크기로 제공됩니다.	dict	Y	Y	Y	-

단순 등급 속성

---

속성	설명	유형	기본	사전	프리미엄	기본값
분	최소 등급	int	Y	Y	Y	-
최대	최고 평점	int	Y	Y	Y	-
평균	점수(학생의 과제)	float(1)	Y	Y	Y	-
별	별 개수	int	Y	Y	Y	-

등급 속성

---

속성	설명	유형	기본	사전	프리미엄	기본값
분	최소 등급	int	Y	Y	Y	-
최대	최고 평점	int	Y	Y	Y	-
값	점수(학생의 과제)	int	Y	Y	Y	-

간단한 주제 속성

---

속성	설명	유형	기본	사전	프리미엄	기본값
id	항목 ID	str	Y	Y	Y	-
title	중국어 이름	str	Y	Y	Y	-
original_title	원래 이름	str	Y	Y	Y	’’
alt	항목 URL	float(1)	Y	Y	Y	-
이미지	영화 포스터 아트워크는 각각 288px x 465px(대형), 96px x 155px(중형), 64px x 103px(소형) 크기로 제공됩니다.	dict	Y	Y	Y	-
평가	득점.부록 참조	dict	Y	Y	Y	-
게시글	출품 유형이 영화인 경우 개봉일, TV 시리즈인 경우 초연 날짜	배열	N	Y	Y	[]
년	나이	str	Y	Y	Y	’’
하위 유형	카테고리, 영화 또는 TV	str	Y	Y	Y	영화

사진 속성

---

속성	설명	유형	기본	사전	프리미엄	기본값
id	이미지 ID	str	N/A	Y	Y	-
subject_id	항목 ID	str	N/A	Y	Y	-
alt	사진 표시 페이지 URL	str	N/A	Y	Y	-
아이콘	이미지 주소, 아이콘 크기	str	N/A	Y	Y	-
이미지	이미지 주소, 이미지 크기	str	N/A	Y	Y	-
엄지	이미지 주소, 엄지손가락 크기	str	N/A	Y	Y	-
커버	이미지 주소, 표지 크기	str	N/A	Y	Y	-
created_at	출시일	str	N/A	Y	Y	-
desc	사진 설명	str	N/A	Y	Y	’’
작성자	사용자를 업로드합니다.부록 참조	dict	N/A	Y	Y	-
album_id	앨범 ID	str	N/A	Y	Y	-
앨범 제목	앨범 제목	str	N/A	Y	Y	-
album_url	앨범 주소	str	N/A	Y	Y	-
다음_사진	다음 이미지.	str	N/A	Y	Y	’’
이전_사진	이전 이미지.	str	N/A	Y	Y	’’
위치	시간별로 정렬된 앨범 내 사진의 위치	int	N/A	Y	Y	0
댓글 수	댓글 수	int	N/A	Y	Y	0
photos_count	모든 스틸 사진 수	int	N/A	Y	Y	0

간단한 사진 속성

---

속성	설명	유형	기본	사전	프리미엄	기본값
id	이미지 ID	str	N/A	Y	Y	-
alt	사진 표시 페이지 URL	str	N/A	Y	Y	-
아이콘	이미지 주소, 아이콘 크기	str	N/A	Y	Y	-
이미지	이미지 주소, 이미지 크기	str	N/A	Y	Y	-
엄지	이미지 주소, 엄지손가락 크기	str	N/A	Y	Y	-
커버	이미지 주소, 표지 크기	str	N/A	Y	Y	-

속성 검토

---

속성	설명	유형	기본	사전	프리미엄	기본값
id	영화 리뷰 아이디	str	Y	Y	Y	-
title	영화 리뷰어 이름	str	Y	Y	Y	-
alt	영화 리뷰 URL	str	Y	Y	Y	-
created_at	출시일	str	Y	Y	Y	-
updated_at	업데이트 날짜	str	Y	Y	Y	-
subject_id	항목 ID	str	Y	Y	Y	-
작성자	사용자를 업로드합니다.부록 참조	dict	Y	Y	Y	-
요약	초록, 100단어 이하	str	Y	Y	Y	-
평가	영화 리뷰 평점.부록 참조	dict	Y	Y	Y	-
useful_count	유용성	int	Y	Y	Y	0
useless_count	쓸모없는 번호	int	Y	Y	Y	0
댓글 수	댓글 수	int	Y	Y	Y	0

간단한 검토 속성

---

속성	설명	유형	기본	사전	프리미엄	기본값
id	영화 리뷰 아이디	str	Y	Y	Y	-
title	영화 리뷰어 이름	str	Y	Y	Y	-
alt	영화 리뷰 URL	str	Y	Y	Y	-
subject_id	항목 ID	str	Y	Y	Y	-
작성자	사용자를 업로드합니다.부록 참조	dict	Y	Y	Y	-
평가	영화 리뷰 평점.부록 참조	dict	Y	Y	Y	-
요약	초록, 100단어 이하	str	Y	Y	Y	-

댓글 속성

---

속성	설명	유형	기본	사전	프리미엄	기본값
id	짧은 댓글 아이디	str	Y	Y	Y	-
created_at	출시일	str	Y	Y	Y	-
subject_id	항목 ID	str	Y	Y	Y	-
작성자	사용자를 업로드합니다.부록 참조	dict	Y	Y	Y	-
콘텐츠	140자 이하의 짧은 댓글 내용	str	Y	Y	Y	-
평가	짧은 리뷰 평가.부록 참조	dict	Y	Y	Y	-
useful_count	유용성	int	Y	Y	Y	0

간단한 사용자 속성

---

속성	설명	유형	기본	사전	프리미엄	기본값
id	사용자 ID	str	Y	Y	Y	-
이름	사용자 ID	str	Y	Y	Y	-
uid	사용자 고유 식별자	str	Y	Y	Y	-
서명	사용자 서명	str	Y	Y	Y	’’
alt	사용자 프로필 URL	str	Y	Y	Y	-
아바타	사용자 아바타	str	Y	Y	Y	-

상자-주제 속성

---

속성	설명	유형	기본	사전	프리미엄	기본값
순위	순위	int	Y	Y	Y	-
상자	박스 오피스	int	Y	Y	Y	-
new	새 릴리스인가요?	bool	Y	Y	-
subject	영화 출품작부록 참조	dict	Y	Y	Y	-

주간 주제 속성

---

속성	설명	유형	기본	사전	프리미엄	기본값
순위	순위	int	Y	Y	Y	-
델타	순위 변경	int	Y	Y	Y	Y