# 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 <a href="#base-url" id="base-url"></a>

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**

<pre><code><strong>GET /animedetails/search/naruto  
</strong></code></pre>

*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"
}
```
