# Anime Details API
### Anime and Series Details API Documentation
An Anime and Series Details API gives you a structured collection of information about anime shows and Series, like titles, plot summaries, genres, episode counts, images, and sometimes even character list,link for the shows in various platforms and related works. You can use this data to create websites, apps, recommendation engines, or any project that needs detailed anime information.
## Base URL
The base URL for the Anime Details API is:
```
https://santechapi.vercel.app
```
## Authentication
```
headers : {
"token" : {YOUR API KEY}
}
```
**Endpoint:** `/animedetails/search/{:q}`
### Parameters:
* {q}: Anime or Series Name.
*HTTP Method: Get*
**Example request**
GET /animedetails/search/naruto
*The user can search for the Anime with its name and get the details of the Anime or Series*
**Example Response:**
**200**
{% code lineNumbers="true" fullWidth="false" %}
```json
{
"pagination": {
"last_visible_page": 2,
"has_next_page": true,
"current_page": 1,
"items": {
"count": 25,
"total": 30,
"per_page": 25
}
},
"data": [
{
"mal_id": 20,
"url": "https://myanimelist.net/anime/20/Naruto",
"images": {
"jpg": {
"image_url": "https://cdn.myanimelist.net/images/anime/1141/142503.jpg",
"small_image_url": "https://cdn.myanimelist.net/images/anime/1141/142503t.jpg",
"large_image_url": "https://cdn.myanimelist.net/images/anime/1141/142503l.jpg"
},
"webp": {
"image_url": "https://cdn.myanimelist.net/images/anime/1141/142503.webp",
"small_image_url": "https://cdn.myanimelist.net/images/anime/1141/142503t.webp",
"large_image_url": "https://cdn.myanimelist.net/images/anime/1141/142503l.webp"
}
},
"trailer": {
"youtube_id": null,
"url": null,
"embed_url": null,
"images": {
"image_url": null,
"small_image_url": null,
"medium_image_url": null,
"large_image_url": null,
"maximum_image_url": null
}
},
"approved": true,
"titles": [
{
"type": "Default",
"title": "Naruto"
},
{
"type": "Synonym",
"title": "NARUTO"
},
{
"type": "Japanese",
"title": "ナルト"
},
{
"type": "English",
"title": "Naruto"
}
],
"title": "Naruto",
"title_english": "Naruto",
"title_japanese": "ナルト",
"title_synonyms": [
"NARUTO"
],
"type": "TV",
"source": "Manga",
"episodes": 220,
"status": "Finished Airing",
"airing": false,
"aired": {
"from": "2002-10-03T00:00:00+00:00",
"to": "2007-02-08T00:00:00+00:00",
"prop": {
"from": {
"day": 3,
"month": 10,
"year": 2002
},
"to": {
"day": 8,
"month": 2,
"year": 2007
}
},
"string": "Oct 3, 2002 to Feb 8, 2007"
},
"duration": "23 min per ep",
"rating": "PG-13 - Teens 13 or older",
"score": 8,
"scored_by": 2008269,
"rank": 646,
"popularity": 9,
"members": 2911326,
"favorites": 80813,
"synopsis": "Moments before Naruto Uzumaki's birth, a huge demon known as the Nine-Tailed Fox attacked Konohagakure, the Hidden Leaf Village, and wreaked havoc. In order to put an end to the demon's rampage, the leader of the village, the Fourth Hokage, sacrificed his life and sealed the monstrous beast inside the newborn Naruto.\n\nIn the present, Naruto is a hyperactive and knuckle-headed ninja growing up within Konohagakure. Shunned because of the demon inside him, Naruto struggles to find his place in the village. His one burning desire to become the Hokage and be acknowledged by the villagers who despite him. However, while his goal leads him to unbreakable bonds with lifelong friends, it also lands him in the crosshairs of many deadly foes.\n\n[Written by MAL Rewrite]",
"background": "Naruto adapts the first 27 volumes of the original manga. It received numerous awards during its airing, including the \"Best Full-Length Animation Program Award\" in the Third UStv Awards and the 38th \"Best Animated Show\" in IGN's Top 100 Animated Series.",
"season": "fall",
"year": 2002,
"broadcast": {
"day": "Thursdays",
"time": "19:30",
"timezone": "Asia/Tokyo",
"string": "Thursdays at 19:30 (JST)"
},
"producers": [
{
"mal_id": 16,
"type": "anime",
"name": "TV Tokyo",
"url": "https://myanimelist.net/anime/producer/16/TV_Tokyo"
},
{
"mal_id": 17,
"type": "anime",
"name": "Aniplex",
"url": "https://myanimelist.net/anime/producer/17/Aniplex"
},
{
"mal_id": 1365,
"type": "anime",
"name": "Shueisha",
"url": "https://myanimelist.net/anime/producer/1365/Shueisha"
}
],
"licensors": [
{
"mal_id": 119,
"type": "anime",
"name": "VIZ Media",
"url": "https://myanimelist.net/anime/producer/119/VIZ_Media"
}
],
"studios": [
{
"mal_id": 1,
"type": "anime",
"name": "Pierrot",
"url": "https://myanimelist.net/anime/producer/1/Pierrot"
}
],
"genres": [
{
"mal_id": 1,
"type": "anime",
"name": "Action",
"url": "https://myanimelist.net/anime/genre/1/Action"
},
{
"mal_id": 2,
"type": "anime",
"name": "Adventure",
"url": "https://myanimelist.net/anime/genre/2/Adventure"
},
{
"mal_id": 10,
"type": "anime",
"name": "Fantasy",
"url": "https://myanimelist.net/anime/genre/10/Fantasy"
}
],
"explicit_genres": [],
"themes": [
{
"mal_id": 17,
"type": "anime",
"name": "Martial Arts",
"url": "https://myanimelist.net/anime/genre/17/Martial_Arts"
}
],
"demographics": [
{
"mal_id": 27,
"type": "anime",
"name": "Shounen",
"url": "https://myanimelist.net/anime/genre/27/Shounen"
}
]
},
],
"links": {
"first": "http://95.217.128.84/v4/anime?query=naruto&page=1",
"last": "http://95.217.128.84/v4/anime?query=naruto&page=2",
"prev": null,
"next": "http://95.217.128.84/v4/anime?query=naruto&page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 2,
"links": [
{
"url": null,
"label": "pagination.previous",
"active": false
},
{
"url": "http://95.217.128.84/v4/anime?query=naruto&page=1",
"label": "1",
"active": true
},
{
"url": "http://95.217.128.84/v4/anime?query=naruto&page=2",
"label": "2",
"active": false
},
{
"url": "http://95.217.128.84/v4/anime?query=naruto&page=2",
"label": "pagination.next",
"active": false
}
],
"path": "http://95.217.128.84/v4/anime",
"per_page": 25,
"to": 25,
"total": 30
}
}
```
{% endcode %}
### Error Handling
In case of an error, the API will respond with an appropriate HTTP status code and an error message in the response body.
**402**
```
{
message: "param required for keyword based anime fetch"
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://santech.gitbook.io/docs/anime-details-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.