### Install Cuevana3 Scraper

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Install the cuevana3 package using npm.

```bash
npm install cuevana3
```

--------------------------------

### Get Series with Cuevana3

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Fetch a list of series using the getMovies function with a specific type code. Note: The example incorrectly uses getMovies for series; it should likely be getSeries.

```javascript
const cuevana3 = require('cuevana3');

cuevana3.getMovies(4)
  .then((res) => console.log(res));
```

--------------------------------

### Get Download Links with getDownload

Source: https://context7.com/carlosfdezb/cuevana3/llms.txt

Returns a list of direct download links for a movie or episode, annotated with server, language, and quality. Use this for download workflows.

```javascript
const cuevana3 = require('cuevana3');

async function fetchDownloads() {
  try {
    const downloads = await cuevana3.getDownload('21711/joker');
    console.log(`Found ${downloads.length} download options`);
    downloads.forEach(dl => {
      console.log(`[${dl.quality}] ${dl.language} via ${dl.server}: ${dl.link}`);
    });
    // [HD] Latino via Uptobox: https://api.cuevana3.io/uptobox/goto.php?h=...
    // [HD] Subtitulado via Uptobox: https://api.cuevana3.io/uptobox/goto.php?h=...
    // [HD] Español via Uptobox: https://api.cuevana3.io/uptobox/goto.php?h=...
  } catch (err) {
    console.error('Failed to fetch downloads:', err.message);
  }
}

fetchDownloads();
```

--------------------------------

### Get Movie/Episode Download Links

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Retrieve a list of direct download links for a movie or episode ID. Links are provided per server, language, and quality.

```javascript
const cuevana3 = require('cuevana3');

cuevana3.getDownload('21711/joker')
  .then((res) => console.log(res));
```

--------------------------------

### Get Latest Movies with Cuevana3

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Fetch a list of the latest movies added using the getMovies function. Requires the cuevana3 module to be imported.

```javascript
const cuevana3 = require('cuevana3');

cuevana3.getMovies(0)
  .then((res) => console.log(res));
```

--------------------------------

### Get Trailer Link for Movie/Serie

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Use this function to retrieve a trailer link for a selected movie or series by providing its ID. Requires the 'cuevana3' library to be imported.

```javascript
const cuevana3 = require('cuevana3');

cuevana3.getTrailer('21711/joker')
  .then((res) => console.log(res));
```

```json
[
  {
    url: 'https://www.youtube.com/embed/UEpPggajCVQ'
  }
]
```

--------------------------------

### Get Movie/Episode Links

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Obtain a list of streaming links for a given movie or episode ID. Links are categorized by language (latino, español, sub).

```javascript
const cuevana3 = require('cuevana3');

cuevana3.getLinks('21711/joker')
  .then((res) => console.log(res));
```

--------------------------------

### Get Streaming Links with getLinks

Source: https://context7.com/carlosfdezb/cuevana3/llms.txt

Retrieves available streaming embed URLs for a movie or episode, grouped by audio/subtitle language (latino, espanol, sub). Each group can contain up to 10 mirror links. Use this to drive a playback experience.

```javascript
const cuevana3 = require('cuevana3');

async function fetchLinks() {
  try {
    const result = await cuevana3.getLinks('21711/joker');
    const { latino, espanol, sub } = result[0];

    console.log(`Latino links: ${latino.length}`);
    console.log(`Español links: ${espanol.length}`);
    console.log(`Subtitled links: ${sub.length}`);
    console.log(latino[0]);
    // { url: 'https://api.cuevana3.io/ir/goto_ddh.php?h=...' }

    // Use the URL directly in an iframe or redirect
    const streamUrl = latino[0]?.url || espanol[0]?.url || sub[0]?.url;
    console.log('Best available stream:', streamUrl);
  } catch (err) {
    console.error('Failed to fetch links:', err.message);
  }
}

fetchLinks();
```

--------------------------------

### Get Movies by Actor

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Retrieve a list of movies associated with a specific actor ID. Requires the actor's ID and the desired page number.

```javascript
const cuevana3 = require('cuevana3');

cuevana3.getByActor('joaquin-phoenix',1)
  .then((res) => console.log(res));
```

--------------------------------

### Get YouTube Trailer URL with getTrailer

Source: https://context7.com/carlosfdezb/cuevana3/llms.txt

Fetches the YouTube embed URL for a movie or series trailer. Returns a single-element array with a 'url' property. Useful for embedding trailers directly in HTML.

```javascript
const cuevana3 = require('cuevana3');

async function fetchTrailer() {
  try {
    const result = await cuevana3.getTrailer('21711/joker');
    console.log(result[0]);
    // { url: 'https://www.youtube.com/embed/UEpPggajCVQ' }

    // Embed directly in HTML
    const embedUrl = result[0].url;
    if (embedUrl) {
      console.log(`<iframe src="${embedUrl}" allowfullscreen></iframe>`);
    } else {
      console.log('No trailer available for this title.');
    }
  } catch (err) {
    console.error('Failed to fetch trailer:', err.message);
  }
}

fetchTrailer();
```

--------------------------------

### Browse Series by Category with cuevana3

Source: https://context7.com/carlosfdezb/cuevana3/llms.txt

Use the `getSeries` function to fetch series listings by category. Different types return either full series objects or lightweight episode objects. Handles fetching latest added series or latest episodes.

```javascript
const cuevana3 = require('cuevana3');

async function browseSeries() {
  try {
    // Get latest added series (type 0)
    const latestSeries = await cuevana3.getSeries(0);
    console.log(latestSeries[0]);
    // {
    //   id: 'serie/loki',
    //   title: 'Loki',
    //   poster: 'https://...',
    //   year: '2021',
    //   sypnosis: '...',
    //   rating: '4.5',
    //   duration: '~50m',
    //   director: [...],
    //   genres: ['Acción', 'Aventura'],
    //   cast: [...] 
    // }

    // Get latest episodes added (type 4) — lighter response
    const latestEpisodes = await cuevana3.getSeries(4);
    console.log(latestEpisodes[0]);
    // {
    //   id: 'episodio/the-innocent-1x8',
    //   episode: 'The Innocent 1x8',
    //   poster: 'https://image.tmdb.org/t/p/w185/o2Xf958jMUS7H7ggZLt7qYyGTD.jpg'
    // }
  } catch (err) {
    console.error('Failed to fetch series:', err.message);
  }
}

browseSeries();
```

--------------------------------

### Browse Movies by Category with cuevana3

Source: https://context7.com/carlosfdezb/cuevana3/llms.txt

Use the `getMovies` function to fetch paginated lists of movies based on category type. Specify the category type and page number. The function returns an array of movie objects.

```javascript
const cuevana3 = require('cuevana3');

// Type reference:
// 0 = Latest added | 1 = Premieres | 2 = Most viewed
// 3 = Top rated    | 4 = Latin dub | 5 = Spanish dub | 6 = Subtitled

async function browseMovies() {
  try {
    // Get page 1 of premiere movies
    const premieres = await cuevana3.getMovies(1, 1);
    console.log(`Found ${premieres.length} movies`);
    console.log(premieres[0]);
    // {
    //   id: '42040/without-remorse',
    //   title: 'Sin remordimientos',
    //   poster: 'https://cuevana3.io/wp-content/uploads/2021/04/sin-remordimientos-42040-poster-204x300.jpg',
    //   year: '2021',
    //   sypnosis: 'Un ex Navy SEAL convertido en agente de la CIA...', 
    //   rating: '4.42',
    //   duration: '1h 49m',
    //   director: ['Stefano Sollima'],
    //   genres: ['Acción', 'Aventura', 'Thriller'],
    //   cast: ['Adrian Rawlins', 'Alec Rosenthal', 'Artjom Gilz']
    // }
  } catch (err) {
    console.error('Failed to fetch movies:', err.message);
  }
}

browseMovies();
```

--------------------------------

### Fetch Full Movie or Series Detail

Source: https://context7.com/carlosfdezb/cuevana3/llms.txt

Fetches complete details for a movie or series using its path-based ID. For movies, it returns streaming links by language. For series, it provides a full episode list organized by season. Ensure the 'cuevana3' module is imported.

```javascript
const cuevana3 = require('cuevana3');

async function fetchDetail() {
  try {
    // Movie detail
    const movie = await cuevana3.getDetail('21711/joker');
    console.log(movie[0]);
    // { ... movie details ... }

    // Series detail — includes episodes grouped by season
    const series = await cuevana3.getDetail('serie/the-boys');
    console.log(series[0].episodes[0]);
    // { ... series episode details ... }
  } catch (err) {
    console.error('Failed to fetch detail:', err.message);
  }
}

fetchDetail();
```

--------------------------------

### getDownload(id)

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Fetches a list of download links for a specified movie or series episode using its ID.

```APIDOC
## getDownload(id)

### Description
Returns a list of download links of selected movie or episode of serie, using `id`.

### Parameters
- **id** (string) - Required - The ID of the movie or series episode.

### Example
```javascript
const cuevana3 = require('cuevana3');

cuevana3.getDownload('21711/joker')
  .then((res) => console.log(res));
```

### Response
#### Success Response
Returns an array of download link objects, each specifying the server, language, quality, and the download link.
```

--------------------------------

### Search Movies and Series with getSearch

Source: https://context7.com/carlosfdezb/cuevana3/llms.txt

Performs a keyword search across movies and series. Spaces in the query are URL-encoded automatically. Use this for full-text discovery.

```javascript
const cuevana3 = require('cuevana3');

async function search() {
  try {
    const results = await cuevana3.getSearch('toy story', 1);
    console.log(`Found ${results.length} results`);
    console.log(results[0]);
    // {
    //   id: '16941/toy-story-4',
    //   title: 'Toy Story 4',
    //   poster: 'https://cuevana3.io/wp-content/uploads/2019/06/ப்புகளை',
    //   year: '2019',
    //   sypnosis: 'Las aventuras de este dúo...',
    //   rating: '3.91',
    //   duration: '1h 30m',
    //   director: ['Josh Cooley'],
    //   genres: ['Animación', 'Aventura', 'Comedia'],
    //   cast: ['Alan Oppenheimer', 'Ally Maki', ...]
    // }
  } catch (err) {
    console.error('Search failed:', err.message);
  }
}

search();
```

--------------------------------

### getDetail(id)

Source: https://context7.com/carlosfdezb/cuevana3/llms.txt

Fetches the complete detail page for a movie or series using its path-based `id`. For movies, it returns streaming links grouped by language. For series, it returns a full episode list organized by season.

```APIDOC
## getDetail(id)

### Description
Fetches the complete detail page for a movie or series using its path-based `id` (e.g., `'21711/joker'` or `'serie/loki'`). For movies, returns streaming links grouped by language (latino, espanol, sub). For series, returns a full episode list organized by season.

### Parameters
#### Path Parameters
- **id** (string) - Required - The path-based ID of the movie or series (e.g., `'21711/joker'` or `'serie/loki'`).

### Request Example
```javascript
const cuevana3 = require('cuevana3');

async function fetchDetail() {
  try {
    // Movie detail
    const movie = await cuevana3.getDetail('21711/joker');
    console.log(movie[0]);
  } catch (err) {
    console.error('Failed to fetch detail:', err.message);
  }
}

fetchDetail();
```

### Response
#### Success Response
- **movie** (object) - Details for a movie, including links.
- **series** (object) - Details for a series, including episodes grouped by season.

#### Response Example (Movie)
```json
{
  "id": "21711/joker",
  "poster": "https://image.tmdb.org/t/p/w600_and_h900_bestv2/v0eQLbzT6sWelfApuYsEkYpzufl.jpg",
  "background": "https://image.tmdb.org/t/p/w1280/ftkY1xIQ6ianSVp3EDufPVPLwa2.jpg",
  "title": "Joker",
  "original_title": "Joker",
  "sypnosis": "Situada en los años 80...",
  "year": "2019",
  "duration": "2h 1m",
  "rating": "4,01",
  "director": ["Todd Phillips"],
  "genres": [{ "id": "crimen", "genre": "Crimen" }, ...],
  "cast": [{ "id": "joaquin-phoenix", "name": "Joaquin Phoenix" }, ...],
  "links": {
    "latino": [{ "url": "https://api.cuevana3.io/ir/goto_ddh.php?h=..." }],
    "espanol": [{ "url": "https://api.cuevana3.io/ir/goto_ddh.php?h=..." }],
    "sub": [{ "url": "https://api.cuevana3.io/ir/goto_ddh.php?h=..." }]
  }
}
```

#### Response Example (Series)
```json
{
  "season": 1,
  "episodes": [
    { "id": "episodio/the-boys-1x1", "episode": "1", "preview": "https://...", "release": "2019-07-26" },
    ...
  ]
}
```
```

--------------------------------

### Browse Movies by Actor

Source: https://context7.com/carlosfdezb/cuevana3/llms.txt

Fetches a paginated list of movies featuring a specific actor, identified by their slug. The actor's slug can be found in the cast list of movie details. The 'cuevana3' module needs to be imported.

```javascript
const cuevana3 = require('cuevana3');

async function browseByActor() {
  try {
    const films = await cuevana3.getByActor('joaquin-phoenix', 1);
    console.log(`Found ${films.length} films`);
    console.log(films[0]);
    // { ... movie details ... }
  } catch (err) {
    console.error('Failed to fetch by actor:', err.message);
  }
}

browseByActor();
```

--------------------------------

### getSearch(query, page)

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Searches for movies and series based on a given query string. Supports pagination.

```APIDOC
## getSearch(query, page)

### Description
Returns a list with movies/series according to `query`.

### Parameters
- **query** (string) - Required - The search term.
- **page** (number) - Required - The page number for pagination.

### Example
```javascript
const cuevana3 = require('cuevana3');

cuevana3.getSearch('toy story', 1)
  .then((res) => console.log(res));
```

### Response
#### Success Response
Returns an array of movie/series objects, each containing details like id, title, poster, year, synopsis, rating, duration, director, genres, and cast.
```

--------------------------------

### getMovies(type)

Source: https://context7.com/carlosfdezb/cuevana3/llms.txt

Fetches a paginated list of movies matching one of seven category types. Returns an array of movie objects including id, title, poster URL, year, synopsis, rating, duration, director, genres, and cast.

```APIDOC
## getMovies(type) — Browse movies by category

### Description
Fetches a paginated list of movies matching one of seven category types: latest added (0), premieres (1), most viewed (2), top rated (3), Latin dub (4), Spanish dub (5), or subtitled (6). Returns an array of movie objects including id, title, poster URL, year, synopsis, rating, duration, director, genres, and cast.

### Method
```javascript
getMovies(type, page)
```

### Parameters
#### Path Parameters
- **type** (number) - Required - Category type for movies (0-6).
- **page** (number) - Optional - Page number to fetch. Defaults to 1.

### Request Example
```javascript
const cuevana3 = require('cuevana3');

// Type reference:
// 0 = Latest added | 1 = Premieres | 2 = Most viewed
// 3 = Top rated    | 4 = Latin dub | 5 = Spanish dub | 6 = Subtitled

async function browseMovies() {
  try {
    // Get page 1 of premiere movies
    const premieres = await cuevana3.getMovies(1, 1);
    console.log(`Found ${premieres.length} movies`);
    console.log(premieres[0]);
  } catch (err) {
    console.error('Failed to fetch movies:', err.message);
  }
}

browseMovies();
```

### Response
#### Success Response (200)
- **Array of movie objects** - Each object contains:
  - **id** (string)
  - **title** (string)
  - **poster** (string)
  - **year** (string)
  - **sypnosis** (string)
  - **rating** (string)
  - **duration** (string)
  - **director** (Array<string>)
  - **genres** (Array<string>)
  - **cast** (Array<string>)

#### Response Example
```json
{
  "id": "42040/without-remorse",
  "title": "Sin remordimientos",
  "poster": "https://cuevana3.io/wp-content/uploads/2021/04/sin-remordimientos-42040-poster-204x300.jpg",
  "year": "2021",
  "sypnosis": "Un ex Navy SEAL convertido en agente de la CIA...",
  "rating": "4.42",
  "duration": "1h 49m",
  "director": ["Stefano Sollima"],
  "genres": ["Acción", "Aventura", "Thriller"],
  "cast": ["Adrian Rawlins", "Alec Rosenthal", "Artjom Gilz"]
}
```
```

--------------------------------

### getTrailer(id)

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Returns a trailer link of a selected movie or series using its ID.

```APIDOC
## getTrailer(id)

### Description
Returns a trailer link of selected movie/serie, using `id`.

### Parameters
#### Path Parameters
- **id** (string) - Required - The ID of the movie or series for which to retrieve the trailer.

### Request Example
```javascript
const cuevana3 = require('cuevana3');

cuevana3.getTrailer('21711/joker')
  .then((res) => console.log(res));
```

### Response
#### Success Response (200)
- **url** (string) - The URL of the trailer.

#### Response Example
```json
[
  {
    "url": "https://www.youtube.com/embed/UEpPggajCVQ"
  }
]
```
```

--------------------------------

### Browse Movies by Genre

Source: https://context7.com/carlosfdezb/cuevana3/llms.txt

Retrieves a paginated list of movies filtered by a specific genre. The genre is specified by a numeric index (0-16), and a 1-based page number is required. The 'cuevana3' module must be imported.

```javascript
const cuevana3 = require('cuevana3');

// Genre index reference:
// 0=Acción  1=Animación  2=Aventura   3=Bélico   4=Biografía
// 5=Sci-Fi  6=Comedia    7=Crimen     8=Docs     9=Drama
// 10=Familiar 11=Fantasía 12=Misterio 13=Musical 14=Romance
// 15=Terror  16=Thriller

async function browseByGenre() {
  try {
    const comedies = await cuevana3.getByGenre(6, 1); // Comedia, page 1
    console.log(`Found ${comedies.length} comedies`);
    console.log(comedies[0]);
    // { ... movie details ... }
  } catch (err) {
    console.error('Failed to fetch by genre:', err.message);
  }
}

browseByGenre();
```

--------------------------------

### getSeries(type)

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Returns a list of series based on the specified type. Types include latest added, premieres, top rated, most viewed, and latest episodes added.

```APIDOC
## getSeries(type)

### Description
Returns a list with the series according to the indicated `type`.

### Parameters
#### Query Parameters
- **type** (number) - Required - Specifies the type of series list to retrieve. Possible values are:
  - 0: Latest series added
  - 1: Premiere series
  - 2: Top rated series
  - 3: Most viewed series
  - 4: Latest episodes added

### Request Example
```javascript
const cuevana3 = require('cuevana3');

cuevana3.getSeries(4)
  .then((res) => console.log(res));
```

### Response
#### Success Response (200)
- **id** (string) - Unique identifier for the series episode.
- **episode** (string) - The title of the series episode.
- **poster** (string) - URL to the series episode's poster image.

#### Response Example
```json
[
  {
    "id": "episodio/the-innocent-1x8",
    "episode": "The Innocent 1x8",
    "poster": "https://image.tmdb.org/t/p/w185/o2Xf958jMUS7H7ggZLt7qYyGTD.jpg"
  }
]
```
```

--------------------------------

### getSeries(type)

Source: https://context7.com/carlosfdezb/cuevana3/llms.txt

Fetches series listings by category. Types 0–3 return full series objects, while type 4 returns lightweight episode objects.

```APIDOC
## getSeries(type) — Browse series by category

### Description
Fetches series listings by category: latest added (0), premieres (1), top rated (2), most viewed (3), or latest episodes added (4). Types 0–3 return full series objects (id, title, poster, year, synopsis, rating, duration, director, genres, cast). Type 4 returns lightweight episode objects (id, episode title, poster).

### Method
```javascript
getSeries(type)
```

### Parameters
#### Path Parameters
- **type** (number) - Required - Category type for series (0-4).

### Request Example
```javascript
const cuevana3 = require('cuevana3');

async function browseSeries() {
  try {
    // Get latest added series (type 0)
    const latestSeries = await cuevana3.getSeries(0);
    console.log(latestSeries[0]);

    // Get latest episodes added (type 4) — lighter response
    const latestEpisodes = await cuevana3.getSeries(4);
    console.log(latestEpisodes[0]);
  } catch (err) {
    console.error('Failed to fetch series:', err.message);
  }
}

browseSeries();
```

### Response
#### Success Response (200)
- **Array of series/episode objects** - Depending on the type:
  - **Full Series Object (types 0-3)**:
    - **id** (string)
    - **title** (string)
    - **poster** (string)
    - **year** (string)
    - **sypnosis** (string)
    - **rating** (string)
    - **duration** (string)
    - **director** (Array<string>)
    - **genres** (Array<string>)
    - **cast** (Array<string>)
  - **Lightweight Episode Object (type 4)**:
    - **id** (string)
    - **episode** (string)
    - **poster** (string)

#### Response Example (Full Series)
```json
{
  "id": "serie/loki",
  "title": "Loki",
  "poster": "https://...",
  "year": "2021",
  "sypnosis": "...",
  "rating": "4.5",
  "duration": "~50m",
  "director": [...],
  "genres": ["Acción", "Aventura"],
  "cast": [...]
}
```
#### Response Example (Lightweight Episode)
```json
{
  "id": "episodio/the-innocent-1x8",
  "episode": "The Innocent 1x8",
  "poster": "https://image.tmdb.org/t/p/w185/o2Xf958jMUS7H7ggZLt7qYyGTD.jpg"
}
```
```

--------------------------------

### getMovies(type)

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Returns a list of movies based on the specified type. Types include latest added, premieres, most viewed, top rated, Latin dub, Spanish dub, and subtitled movies.

```APIDOC
## getMovies(type)

### Description
Returns a list with the movies according to the indicated `type`.

### Parameters
#### Query Parameters
- **type** (number) - Required - Specifies the type of movie list to retrieve. Possible values are:
  - 0: Latest movies added
  - 1: Premiere movies
  - 2: Most viewed movies
  - 3: Top rated movies
  - 4: Latin dub movies
  - 5: Spanish dub movies
  - 6: Subtitled movies

### Request Example
```javascript
const cuevana3 = require('cuevana3');

cuevana3.getMovies(0)
  .then((res) => console.log(res));
```

### Response
#### Success Response (200)
- **id** (string) - Unique identifier for the movie.
- **title** (string) - The title of the movie.
- **poster** (string) - URL to the movie's poster image.
- **year** (string) - The release year of the movie.
- **sypnosis** (string) - A brief synopsis of the movie.
- **rating** (string) - The rating of the movie.
- **duration** (string) - The duration of the movie.
- **director** (array of strings) - The director(s) of the movie.
- **genres** (array of strings) - The genres associated with the movie.
- **cast** (array of strings) - The main cast of the movie.

#### Response Example
```json
[
  {
    "id": "42040/without-remorse",
    "title": "Sin remordimientos",
    "poster": "https://cuevana3.io/wp-content/uploads/2021/04/sin-remordimientos-42040-poster-204x300.jpg",
    "year": "2021",
    "sypnosis": "Un ex Navy SEAL convertido en agente de la CIA busca venganza después de que su novia es asesinada por un narcotraficante de Baltimore.",
    "rating": "4.42",
    "duration": "1h 49m",
    "director": [ "Stefano Sollima" ],
    "genres": [ "Acción", "Aventura", "Thriller" ],
    "cast": [ "Adrian Rawlins", "Alec Rosenthal", "Artjom Gilz" ]
  }
]
```
```

--------------------------------

### Search Movies and Series

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Find movies or series based on a search query. Specify the query string and the desired page number.

```javascript
const cuevana3 = require('cuevana3');

cuevana3.getSearch('toy story',1)
  .then((res) => console.log(res));
```

--------------------------------

### getByGenre(type, page)

Source: https://context7.com/carlosfdezb/cuevana3/llms.txt

Returns a paginated list of movies filtered by genre. The `type` parameter is a numeric index mapping to genre slugs, and `page` is a 1-based page number.

```APIDOC
## getByGenre(type, page)

### Description
Returns a paginated list of movies filtered by genre. The `type` parameter is a numeric index (0–16) mapping to genre slugs. The `page` parameter is a 1-based page number.

### Parameters
#### Path Parameters
- **type** (integer) - Required - A numeric index (0–16) representing the genre.
- **page** (integer) - Required - The 1-based page number for the results.

### Genre Index Reference
- 0=Acción  1=Animación  2=Aventura   3=Bélico   4=Biografía
- 5=Sci-Fi  6=Comedia    7=Crimen     8=Docs     9=Drama
- 10=Familiar 11=Fantasía 12=Misterio 13=Musical 14=Romance
- 15=Terror  16=Thriller

### Request Example
```javascript
const cuevana3 = require('cuevana3');

async function browseByGenre() {
  try {
    const comedies = await cuevana3.getByGenre(6, 1); // Comedia, page 1
    console.log(`Found ${comedies.length} comedies`);
    console.log(comedies[0]);
  } catch (err) {
    console.error('Failed to fetch by genre:', err.message);
  }
}

browseByGenre();
```

### Response
#### Success Response
- **array** - A list of movie objects matching the specified genre and page.

#### Response Example
```json
{
  "id": "12299/book-of-monsters",
  "title": "Book of Monsters",
  "poster": "https://cuevana3.io/wp-content/uploads/2019/04/ப்புகளை...",
  "year": "2018",
  "sypnosis": "La fiesta de cumpleaños de Sophie...",
  "rating": "2.78",
  "duration": "1h 24m",
  "director": ["Stewart Sparke"],
  "genres": ["Acción", "Comedia", "Terror"],
  "cast": ["Anna Dawson", ...]
}
```
```

--------------------------------

### getByActor(id, page)

Source: https://context7.com/carlosfdezb/cuevana3/llms.txt

Returns a paginated list of movies featuring a specific actor, identified by their slug. The slug can be obtained from cast objects returned by `getDetail()`.

```APIDOC
## getByActor(id, page)

### Description
Returns a paginated list of movies featuring a specific actor, identified by their slug (e.g., `'joaquin-phoenix'`). The slug can be obtained from cast objects returned by `getDetail()`.

### Parameters
#### Path Parameters
- **id** (string) - Required - The slug of the actor (e.g., `'joaquin-phoenix'`).
- **page** (integer) - Required - The 1-based page number for the results.

### Request Example
```javascript
const cuevana3 = require('cuevana3');

async function browseByActor() {
  try {
    const films = await cuevana3.getByActor('joaquin-phoenix', 1);
    console.log(`Found ${films.length} films`);
    console.log(films[0]);
  } catch (err) {
    console.error('Failed to fetch by actor:', err.message);
  }
}

browseByActor();
```

### Response
#### Success Response
- **array** - A list of movie objects featuring the specified actor.

#### Response Example
```json
{
  "id": "21711/joker",
  "title": "Joker",
  "poster": "https://cuevana3.io/wp-content/uploads/2019/10/...".jpg",
  "year": "2019",
  "sypnosis": "Situada en los años 80...",
  "rating": "4.01",
  "duration": "2h 1m",
  "director": ["Todd Phillips"],
  "genres": ["Crimen", "Drama", "Thriller"],
  "cast": ["Adrienne Lovette", "Bill Camp", ...]
}
```
```

--------------------------------

### getLinks(id)

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Retrieves a list of streaming links for a specified movie or series episode using its ID.

```APIDOC
## getLinks(id)

### Description
Returns a list of links of selected movie or episode of serie, using `id`.

### Parameters
- **id** (string) - Required - The ID of the movie or series episode.

### Example
```javascript
const cuevana3 = require('cuevana3');

cuevana3.getLinks('21711/joker')
  .then((res) => console.log(res));
```

### Response
#### Success Response
Returns an object containing arrays of links categorized by language (latino, espanol, sub).
```

--------------------------------

### getByActor(id, page)

Source: https://github.com/carlosfdezb/cuevana3/blob/master/README.md

Returns a list of movies associated with a specific actor, identified by their ID. Supports pagination.

```APIDOC
## getByActor(id, page)

### Description
Returns a list with movies according to the indicated actor using `id`.

### Parameters
- **id** (string) - Required - The ID of the actor.
- **page** (number) - Required - The page number for pagination.

### Example
```javascript
const cuevana3 = require('cuevana3');

cuevana3.getByActor('joaquin-phoenix', 1)
  .then((res) => console.log(res));
```

### Response
#### Success Response
Returns an array of movie objects, each containing details like id, title, poster, year, synopsis, rating, duration, director, genres, and cast.
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.