# Quick Start

## Get your API key

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.

You can generate a new API key in your [user dashboard](https://phantommovies.com/user/profile/dashboard/edit) at anytime 

## Install the library

The best way to interact with our API is to use one of our official libraries:

{% tabs %}
{% tab title="Node" %}

```
# Install via NPM
npm install phantom-movies
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Tip:** Join our [Discord Server](https://discord.gg/7hGWepuMe5) for updates & new features.
{% endhint %}

## Make your first request

To make your first request, send an query request to the movies endpoint with the title of the movie.

## Search Movie

<mark style="color:blue;">`GET`</mark> `https://api.phantommovies.com/3/movies/movie`

Search for a movie title.

#### Query Parameters

| Name                                          | Type   | Description                             |
| --------------------------------------------- | ------ | --------------------------------------- |
| accessToken<mark style="color:red;">\*</mark> | String | Your API Key                            |
| title<mark style="color:red;">\*</mark>       | String | The `title` of the movie being searched |

{% tabs %}
{% tab title="200: OK Movie Found" %}

```javascript
{
    title: "Avatar: The Way Of Water",
    cover: "https://www.themoviedb.org/t/p/original/t6HIqrRAclMCA60NsSmeqe9RmNV.jpg",
    banner: "https://www.themoviedb.org/t/p/original/198vrF8k7mfQ4FjDJsBmdQcaiyq.jpg",
    trailer: "https://www.youtube.com/watch?v=o5F8MOz_IDw",
    description: "Set more than a decade after the events of the first film, learn the story of the Sully family (Jake, Neytiri, and their kids), the trouble that follows them, the lengths they go to keep each other safe, the battles they fight to stay alive, and the tragedies they endure.",
    rating: "PG-13",
    releaseYear: "2022",
    length: "3h 12m",
    primegenre: "Sci-Fi",
    genres: {
        genre: [
            "Action",
            "Adventure",
            "Sci-Fi"
        ]
    },
    statistics: {
        views: 160,
        votes: 0
    },
    stream: "https://dood.re/e/t1trpkm17b7yxfa4gwsh3l99vt7kl521",
    url: "https://ologyyvidss.com/movies/Avatar:%20The%20Way%20Of%20Water"
}
```

{% endtab %}

{% tab title="404: Not Found No Result" %}

```javascript
{
    status: "nothing_found",
    message: "No movies found."
}
```

{% endtab %}
{% endtabs %}

Take a look at how you might call this method using our official library, `node`:

{% tabs %}
{% tab title="Node" %}

```javascript
// require ologyyvidss module and set it up with your API key
const PhantomMovies = require("phantom-movies");
const API = new PhantomMovies.API("YOUR_API_KEY");

API.searchMovie("Avatar: The Way of Water").then((res) => {
	console.log(res); // Get information on the Movie with the Title Avatar: The Way of Water
});
```

{% endtab %}
{% endtabs %}