> For the complete documentation index, see [llms.txt](https://movie-team.gitbook.io/movieteam/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://movie-team.gitbook.io/movieteam/movies/undefined-1.md).

# 영화 조회

## 현재 상영 중인 80개의 영화 전체 조회

<mark style="color:blue;">`GET`</mark> `http://127.0.0.1:8000/api/movies/`&#x20;

#### Headers

| Name                                            | Type   | Description                   |
| ----------------------------------------------- | ------ | ----------------------------- |
| Authorization<mark style="color:red;">\*</mark> | String | "Bearer" + 발급 받은 access token |

{% tabs %}
{% tab title="200: OK 영화 전체 조회 성공" %}

```json
[
    {
        "id": 34308,
        "genres": [
            18
        ],
        "theater_set": [],
        "adult": false,
        "title": "모딜리아니",
        "original_title": "Modigliani",
        "overview": "1919년 파리, 뜨겁고 파괴적이었던 세기의 예술가 ‘모딜리아니’는 술과 마약에 중독되어 방탕하고 동료 예술과들과 종잡을 수 없는 기행을 일삼는다. “당신을 영혼까지 알게 되면, 그때 눈동자를 그릴게요” 어느 날, ‘모딜리아니’는 아름다운 ‘잔’에게 매료되어 운명적인 사랑에 빠진다. ‘잔’은 ‘모딜리아니’에게 영감을 주는 뮤즈로 그는 더욱 작품 활동에 몰두하게 된다. 하지만 아이를 낳은 ‘잔’은 이어지는 궁핍한 생활에 지쳐가고, ‘피카소’를 찾아가 전시회에 ‘모딜리아니’의 그림을 걸어달라고 부탁하면서 사이가 좋지 않았던 그들의 갈등은 더욱 심해진다. ‘모딜리아니’는 약물과 알코올 중독 증세로 건강마저 악화되면서 점점 엉망진창이 된다. 그는 파리에서 매년 개최되는 상금이 걸린 미술 경연대회에 작품을 내기로 결심하고, 애증의 라이벌 ‘피카소’까지 참가한다는 소식에 파리가 들썩이기 시작하는데…",
        "popularity": 8.716,
        "poster": "/gWQLJFK4Z0KRBZqgiVLT5nU3TIk.jpg",
        "release_date": "2023-10-19",
        "vote_average": 7.0,
        "vote_count": 179,
        "created_at": "2023-11-14"
    },
    ...
```

{% endtab %}
{% endtabs %}

## 영화 ID를 이용해 영화 상세 조회

<mark style="color:blue;">`GET`</mark> `http://127.0.0.1:8000/api/movies/<int:movie_pk>`

#### Headers

| Name                                            | Type   | Description                   |
| ----------------------------------------------- | ------ | ----------------------------- |
| Authorization<mark style="color:red;">\*</mark> | String | "Bearer" + 발급 받은 access token |

{% tabs %}
{% tab title="200: OK 영화 상세 조회 성공" %}

```
{
    "id": 84334,
    "genres": [
        99,
        10402
    ],
    "theater_set": [],
    "adult": false,
    "title": "서칭 포 슈가맨",
    "original_title": "Searching for Sugar Man",
    "overview": "미국에선 ZERO, 남아공에선 HERO?!  팝 역사상 가장 신비로운 가수, ‘슈가맨’의 놀라운 이야기!  ● 본고장 미국: 음반 판매 6장, 아무도 알아주지 않는 비운의 가수!  ● 반대편 남아공: 밀리언셀러 히트가수, ‘엘비스’보다 유명한 슈퍼스타!  70년대 초, 우연히 남아공으로 흘러 들어온 ‘슈가맨’의 앨범은 수십 년간 가장 큰 사랑을 받으며 최고의 히트를 기록한다.  하지만 ‘슈가맨’은 단 두 장의 앨범만 남기고 사라져버린 신비의 가수!  전설의 ‘슈가맨’을 둘러싸고 갖가지 소문만 무성한 가운데,  두 명의 열성 팬이 진실을 밝히고자 그의 흔적을 찾기 시작한다.  그러나 단서라고는 오직 그의 노래 가사뿐!  기발한 추적 끝에 ‘슈가맨’에 대한 수수께끼를 풀었다고 생각한 순간,  그들은 상상하지도 못했던 놀라운 사실과 마주하게 되는데...!  지금부터 ‘슈가맨’의 리얼 기적이 시작됩니다!",
    "popularity": 10.235,
    "poster": "/2UlEwjiNud7V2aB2ghbkRbBjaPA.jpg",
    "release_date": "2012-10-11",
    "vote_average": 7.9,
    "vote_count": 838,
    "created_at": "2023-11-14"
}
```

{% endtab %}
{% endtabs %}

## 장르 별 영화 조회

<mark style="color:blue;">`GET`</mark> `http://127.0.0.1:8000/api/movies/genre/`

#### Headers

| Name                                            | Type   | Description                   |
| ----------------------------------------------- | ------ | ----------------------------- |
| Authorization<mark style="color:red;">\*</mark> | String | "Bearer" + 발급 받은 access token |

{% tabs %}
{% tab title="200: OK 장르 및 장르 별 영화 조회 성공" %}

```
[
    {
        "id": 12,
        "movies": [
            {
                "id": 299054,
                "genres": [
                    12,
                    28,
                    53
                ],
                "theater_set": [],
                "adult": false,
                "title": "익스펜더블 4",
                "original_title": "Expend4bles",
                "overview": "테러 단체에게 핵미사일이 탈취되어 3차 세계대전이 발발할 위기의 상황에 ‘리’(제이슨 스타뎀)를 새로운 리더로 맞은 무적의 팀 익스펜더블이 작전에 투입되는데...",
                "popularity": 1719.337,
                "poster": "/dWR8OTRCcYDbBmd8GKsyJT73kU2.jpg",
                "release_date": "2023-10-18",
                "vote_average": 6.475,
                "vote_count": 683,
                "created_at": "2023-11-14"
            },
            ...
            ]
    },
    ...
```

{% endtab %}
{% endtabs %}

## 인기도 내림차순으로 영화 정렬

<mark style="color:blue;">`GET`</mark> `http://127.0.0.1:8000/api/movies/popularity`

#### Headers

| Name                                            | Type   | Description                   |
| ----------------------------------------------- | ------ | ----------------------------- |
| Authorization<mark style="color:red;">\*</mark> | String | "Bearer" + 발급 받은 access token |

{% tabs %}
{% tab title="200: OK 인기도 순 정렬" %}

```
[
    {
        "id": 507089,
        "genres": [
            27,
            9648
        ],
        "theater_set": [],
        "adult": false,
        "title": "프레디의 피자가게",
        "original_title": "Five Nights at Freddy's",
        "overview": "80년대에 아이들이 실종되고 폐업한지 오래된 프레디의 피자가게 그곳의 야간 경비 알바를 하게 된 ‘마이크'는 캄캄한 어둠만이 존재하는 줄 알았던 피자가게에서 살아 움직이는 피자가게 마스코트 '프레디와 친구들’을 목격한다. 어딘가 기괴하고 섬뜩한 프레디와 친구들이 실체를 드러내기 시작하는데...",
        "popularity": 2054.608,
        "poster": "/h3hhfWdBhdb2JLMZprQ1IvBe90h.jpg",
        "release_date": "2023-11-15",
        "vote_average": 8.0,
        "vote_count": 2118,
        "created_at": "2023-11-14"
    },
    ...
```

{% endtab %}
{% endtabs %}