API Usage Documentation

IMDb API

GET /imdb/api/genres

Description: Returns a list of available IMDb genres.

Response:

["action", "adventure", ...]

GET /imdb/api/top-lists

Description: Returns a list of available IMDb top lists.

Response:

["top_movies", "top_tv", ...]

GET /imdb/api/genre

Description: Retrieves selected IMDb genre categories and their items.

Response:

{
  "data": {
    "action": [
      { "title": "Movie Title", "slug": "movie-title", "id": "int:123", "image": "url" },
      ...
    ],
    ...
  }
}

GET /imdb/api/genre/:genreName

Description: Retrieves details for a specific IMDb genre.

Parameters:

genreName: The name of the genre (e.g., action).

Response:

{
  "genre": "genreName",
  "data": {
    "genreTitle": "Action",
    "coverImg": "url",
    "description": "Description text",
    "type": "Genre type",
    "popular_movies": [
      { "imdbId": "tt123", "title": "Movie Title", "rating": "8.0", "image": "url" },
      ...
    ],
    ...
  }
}

GET /imdb/api/top/:listName

Description: Retrieves a specific IMDb top list.

Parameters:

listName: The name of the top list (e.g., top_movies).

Response:

{
  "list": "listName",
  "data": [
    { "rank": 1, "imdbId": "tt123", "title": "Movie Title", "year": "2020", "rating": "8.0", "image": "url" },
    ...
  ]
}

GET /imdb/news

Description: Retrieves news from IMDb.

Response:

{
  "articles": [
    {
      "title": "Article Title",
      "body": "Article body text",
      "source": "Article source",
      "url": "Article URL",
      "image": "Article image URL",
      "date": "Article date",
      "author": "Article author"
    },
    ...
  }
}

GET /imdb/api/titles:batch_get

Description: Retrieves data from IMDb for multiple titles.

Example:

GET /imdb/api/titles:batch_get?title_ids=tt4154796&title_ids=tt0332280&title_ids=tt32223398

Parameters:

title_ids: IMDb IDs of the titles to retrieve (required).

Response:

[
  {
    "id": "tt4154796",
    "title": "Avengers: Endgame",
    "release": "2019",
    "image": "https://m.media-amazon.com/images/M/MV5BMTc5MDE2ODcwNV5BMl5BanBnXkFtZTgwMzI2NzQ2NzM@._V1_.jpg",
    "rating": 8.4
  },
  {
    "id": "tt0332280",
    "title": "The Notebook",
    "release": "2004",
    "image": "https://m.media-amazon.com/images/M/MV5BZjE0ZjgzMzYtMTAxYi00NGMzLThmZDktNzFlMzA2MWRmYWQ0XkEyXkFqcGc@._V1_.jpg",
    "rating": 7.8
  },
  {
    "id": "tt32223398",
    "title": "Jaat",
    "release": "2025",
    "image": "https://m.media-amazon.com/images/M/MV5BNDQxYmM2YmUtOGJmYy00YzcyLTkxOTItYmI3ZTZjZmUwZDMxXkEyXkFqcGc@._V1_.jpg",
    "rating": 6
  },
  ...
]

TMDb API

GET /tmdb/:category/:type

Description: Retrieves data from TMDb for a specific category and type.

Parameters:

category: Category of data (trending, popular, top-rated, discover).
type: Type of content (all, movie, tv).

Response:

[
  {
    "id": "tt123",
    "title": "Title",
    "media_type": "movie|tv",
    "rating": 8.0,
    "poster": "url",
    "genres": ["action", "drama"]
  },
  ...
]

AniList API

GET /anilist

Description: Welcome message for AniList API.

Response:

📺📚 Welcome to AniList Anime & Manga REST API

GET /anilist/manga/top100

Description: Retrieves the top 100 manga from AniList.

Parameters:

page: Page number (optional, default: 1).
perPage: Items per page (optional, default: 10).

Response:

{
  "success": true,
  "pagination": {...},
  "results": [...],
  "cached": false
}

GET /anilist/manga/trending

Description: Retrieves trending manga from AniList.

Parameters:

page: Page number (optional, default: 1).
perPage: Items per page (optional, default: 10).

Response:

{
  "success": true,
  "pagination": {...},
  "results": [...],
  "cached": false
}

GET /anilist/manga/top-manhwa

Description: Retrieves top manhwa from AniList.

Parameters:

page: Page number (optional, default: 1).
perPage: Items per page (optional, default: 10).

Response:

{
  "success": true,
  "pagination": {...},
  "results": [...],
  "cached": false
}

GET /anilist/manga/search/:query

Description: Searches manga by query on AniList.

Parameters:

query: Search query.
page: Page number (optional, default: 1).
perPage: Items per page (optional, default: 10).

Response:

{
  "success": true,
  "pagination": {...},
  "results": [...],
  "cached": false
}

GET /anilist/manga/:id

Description: Retrieves manga details by ID from AniList.

Parameters:

id: Manga ID.

Response:

{
  "success": true,
  "manga": {...}
}

GET /anilist/anime/top100

Description: Retrieves the top 100 anime from AniList.

Parameters:

page: Page number (optional, default: 1).
perPage: Items per page (optional, default: 10).

Response:

{
  "success": true,
  "pagination": {...},
  "results": [...],
  "cached": false
}

GET /anilist/anime/trending

Description: Retrieves trending anime from AniList.

Parameters:

page: Page number (optional, default: 1).
perPage: Items per page (optional, default: 10).

Response:

{
  "success": true,
  "pagination": {...},
  "results": [...],
  "cached": false
}

GET /anilist/anime/search/:query

Description: Searches anime by query on AniList.

Parameters:

query: Search query.
page: Page number (optional, default: 1).
perPage: Items per page (optional, default: 10).

Response:

{
  "success": true,
  "pagination": {...},
  "results": [...],
  "cached": false
}

GET /anilist/anime/:id

Description: Retrieves anime details by ID from AniList.

Parameters:

id: Anime ID.

Response:

{
  "success": true,
  "anime": {...}
}

AI API

GET /ai/suggest

Description: Provides AI-driven recommendations based on a query using TMDb and IMDb data.

Parameters:

query: User query for recommendations (required).

Response:

{
  "query": "user query",
  "analysis": {
    "recommended_genres": ["genre1", "genre2"],
    "content_type": "movies|tv_shows|both",
    "theme_keywords": ["keyword1", "keyword2"],
    "explanation": "Explanation text"
  },
  "titles": [
    {
      "id": "tt123",
      "type": "movie|tv",
      "primary_title": "Title",
      "primary_image": "url",
      "genres": ["genre1", "genre2"],
      "rating": { "aggregate_rating": 8.0 },
      "start_year": "2020",
      "runtime_minutes": 120,
      "plot": "Plot description",
      "source": "tmdb|imdb"
    },
    ...
  ]
}

GET /ai/genre/:genreName

Description: Retrieves titles for a specific genre from TMDb and IMDb.

Parameters:

genreName: Genre name (e.g., action, must be from available genres).

Response:

{
  "genre": "genreName",
  "titles": [
    {
      "id": "tt123",
      "type": "movie|tv",
      "primary_title": "Title",
      "primary_image": "url",
      "genres": ["genre1", "genre2"],
      "rating": { "aggregate_rating": 8.0 },
      "start_year": "2020",
      "runtime_minutes": 120,
      "plot": "Plot description",
      "source": "tmdb|imdb"
    },
    ...
  ]
}

GET /ai/health

Description: Health check endpoint for the AI API.

Response:

{
  "status": "healthy",
  "timestamp": "ISO timestamp",
  "ALL_GENRES": ["action", "adventure", ...]
}

GET /ai/genres

Description: Returns the list of available genres for AI recommendations.

Response:

{
  "ALL_GENRES": ["action", "adventure", ...]
}

Episode List API

GET /eplist/episodes

Description: Retrieves episode details for a TV show by IMDb ID from vidsrc.xyz.

Parameters:

id: IMDb ID of the TV show (required).

Response:

{
  "imdb_id": "tt123",
  "total_seasons": 2,
  "seasons": {
    "1": [
      {
        "episode": 1,
        "title": "Episode Title",
        "url": "https://vidsrc.xyz/embed/..."
      },
      ...
    ],
    ...
  }
}

Truecaller API

GET /truecaller/lookup

Description: Retrieves information about a phone number using Truecaller.

Parameters:

number: Phone number with country code to lookup (required).

Response:

{
  "id": "idData",
  "name": "nameData",
  "imId": "imIdData",
  "about": "aboutData",
  "image": "imageData",
  "jobTitle": "jobTitleData",
  "score": 0.9,
  "access": "PUBLIC",
  "enhanced": true,
  "companyName": "companyNameData",
  "phones": [
    {
      "e164Format": "e164FormatData",
      "numberType": "numberTypeData",
      "nationalFormat": "nationalFormatData",
      "dialingCode": 977,
      "countryCode": "NP",
      "carrier": "Nepal Telecom",
      "type": "openPhone"
    }
  ],
  "addresses": [
    {
      "address": "addressData",
      "zipCode": "zipCodeData",
      "city": "cityData",
      "countryCode": "countryCodeData",
      "timeZone": "timeZoneData",
      "type": "addressData"
    }
  ],
  "internetAddresses": [
    {
      "id": "idData",
      "service": "serviceData",
      "caption": "captionData",
      "type": "internetAddressData"
    },
    {
      "id": "idData",
      "service": "serviceData",
      "type": "internetAddressData"
    }
  ],
  "badges": [
    "user"
  ],
  "tags": [],
  "cacheTtl": 1296000000,
  "sources": [],
  "searchWarnings": [],
  "surveys": [
    {
      "id": "surveyIdData",
      "frequency": 86400,
      "passthroughData": "passthroughData",
      "perNumberCooldown": 31536000,
      "dynamicContentAccessKey": "dynamicContentAccessKeyData"
    },
    {
      "id": "surveyIdData",
      "frequency": 86400,
      "passthroughData": "passthroughData",
      "perNumberCooldown": 31536000,
      "dynamicContentAccessKey": "dynamicContentAccessKeyData"
    },
    {
      "id": "surveyIdData",
      "frequency": 0,
      "passthroughData": "passthroughData",
      "perNumberCooldown": 0,
      "dynamicContentAccessKey": "dynamicContentAccessKeyData"
    }
  ],
  "commentsStats": {
    "showComments": false
  },
  "manualCallerIdPrompt": false,
  "ns": 0
}

Manga API

GET /manga

Detailed documentation: Manga API

Anime API

GET /anime

Detailed documentation: Anime API