From 42c0c7bbdbe259297c1677c878944a2849112deb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=CA=9C=C9=AA=C9=B4=E1=B4=87=C9=AA=20N=E1=B4=8F=E1=B4=9C?=
 =?UTF-8?q?=E1=B4=A2=E1=B4=87=C9=B4?=
 <157171073+Shineii86@users.noreply.github.com>
Date: Mon, 8 Jun 2026 17:17:38 +0530
Subject: [PATCH] docs: add disclaimer, Render deploy, JS code examples for all
 endpoints

---
 CHANGELOG.md |   7 ++
 README.md    | 198 +++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 205 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c55e1e9..d4a95f0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.5.2] - 2026-06-08
+
+### Added
+- Disclaimer section (educational purposes, 3rd party media, no affiliation)
+- Render deploy button alongside Vercel
+- JavaScript `import axios` code examples for all 25 API endpoints
+
 ## [1.5.1] - 2026-06-08
 
 ### Fixed
diff --git a/README.md b/README.md
index 249d7f2..0a6343d 100644
--- a/README.md
+++ b/README.md
@@ -41,6 +41,14 @@
 
 ---
 
+> ## ⚠️ Disclaimer
+>
+> 1. This `API` does not store any files — it only links to media hosted on 3rd party services.
+> 2. This `API` is explicitly made for **educational purposes only** and not for commercial usage. This repo will not be responsible for any misuse of it.
+> 3. All anime data, images, and content belong to their respective owners. This project is not affiliated with anikototv.to.
+
+---
+
 ## 📖 Table of Contents
 
 - [Overview](#-overview)
@@ -418,6 +426,12 @@ Home page data — spotlight carousel, trending anime, top airing, and genre lis
 curl "https://anikato.vercel.app/api/"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/");
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -486,6 +500,14 @@ Search anime by keyword with pagination.
 curl "https://anikato.vercel.app/api/search?keyword=one+piece"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/search", {
+  params: { keyword: "one piece", page: 1 }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -541,6 +563,14 @@ Search suggestions for autocomplete (returns max 10 results).
 curl "https://anikato.vercel.app/api/search/suggest?keyword=one+piece"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/search/suggest", {
+  params: { keyword: "one piece" }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -574,6 +604,14 @@ Detailed anime information including synopsis, genres, studios, and more.
 curl "https://anikato.vercel.app/api/info?id=one-piece-odmau"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/info", {
+  params: { id: "one-piece-odmau" }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -621,6 +659,14 @@ Complete watch page data — anime info, episode list, servers, trending, and re
 curl "https://anikato.vercel.app/api/watch?slug=one-piece-odmau&ep=1165"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/watch", {
+  params: { slug: "one-piece-odmau", ep: 1165 }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -678,6 +724,12 @@ Episode list for an anime (loaded via AJAX for accuracy).
 curl "https://anikato.vercel.app/api/episodes/one-piece-odmau"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/episodes/one-piece-odmau");
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -708,6 +760,12 @@ Raw AJAX episode list response from the source site. Returns HTML that contains
 curl "https://anikato.vercel.app/api/episodes-ajax/1642"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/episodes-ajax/1642");
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -735,6 +793,14 @@ Streaming server info — extracts video embed URL and skip data via AJAX. Requi
 curl "https://anikato.vercel.app/api/stream?id={linkId}"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/stream", {
+  params: { id: "yourLinkId" }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -769,6 +835,14 @@ Server list for an episode — returns available streaming servers with their na
 curl "https://anikato.vercel.app/api/servers?ids={episodeIds}"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/servers", {
+  params: { ids: "yourEpisodeIds" }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -804,6 +878,14 @@ Mapper API — fetches additional streaming servers from gogoanime/anivibe via t
 curl "https://anikato.vercel.app/api/mapper-servers?malId=21&slug=one-piece&timestamp=1717900000"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/mapper-servers", {
+  params: { malId: 21, slug: "one-piece", timestamp: 1717900000 }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -838,6 +920,12 @@ Top 10 anime rankings for day, week, and month.
 curl "https://anikato.vercel.app/api/top-ten"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/top-ten");
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -875,6 +963,12 @@ Spotlight carousel data — featured anime with posters, descriptions, and ratin
 curl "https://anikato.vercel.app/api/spotlight"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/spotlight");
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -917,6 +1011,12 @@ Trending anime — recently updated episodes with sub/dub counts.
 curl "https://anikato.vercel.app/api/trending"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/trending");
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -958,6 +1058,12 @@ Random anime — follows redirect to a random anime page and returns full info.
 curl "https://anikato.vercel.app/api/random"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/random");
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -994,6 +1100,14 @@ Most popular anime with pagination — sorted by view count.
 curl "https://anikato.vercel.app/api/most-popular?page=1"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/most-popular", {
+  params: { page: 1 }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -1045,6 +1159,14 @@ Newly released anime with pagination.
 curl "https://anikato.vercel.app/api/new-release?page=1"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/new-release", {
+  params: { page: 1 }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -1086,6 +1208,12 @@ Sidebar data — trending (day/week/month) + latest episodes for widget display.
 curl "https://anikato.vercel.app/api/trending-sidebar"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/trending-sidebar");
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -1126,6 +1254,14 @@ Recently added anime with pagination.
 curl "https://anikato.vercel.app/api/newly-added?page=1"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/newly-added", {
+  params: { page: 1 }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -1170,6 +1306,14 @@ Anime schedule for a specific date. Returns an array of anime airing on that dat
 curl "https://anikato.vercel.app/api/schedule?date=2026-06-08"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/schedule", {
+  params: { date: "2026-06-08" }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -1224,6 +1368,14 @@ Advanced filtering with multiple criteria. Requires `keyword` parameter (use emp
 curl "https://anikato.vercel.app/api/filter?genre=action&type=tv&page=1"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/filter", {
+  params: { genre: "action", type: "tv", page: 1 }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -1262,6 +1414,14 @@ Browse anime by genre.
 curl "https://anikato.vercel.app/api/genre/action?page=1"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/genre/action", {
+  params: { page: 1 }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -1307,6 +1467,14 @@ Browse anime by type.
 curl "https://anikato.vercel.app/api/type/movie?page=1"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/type/movie", {
+  params: { page: 1 }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -1353,6 +1521,14 @@ Browse anime by airing status.
 curl "https://anikato.vercel.app/api/status/currently-airing?page=1"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/status/currently-airing", {
+  params: { page: 1 }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -1398,6 +1574,14 @@ Browse anime alphabetically.
 curl "https://anikato.vercel.app/api/az-list/a?page=1"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/az-list/a", {
+  params: { page: 1 }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -1443,6 +1627,14 @@ Search suggestions for autocomplete (returns max 10 results).
 curl "https://anikato.vercel.app/api/suggestions?keyword=naruto"
 ```
 
+```javascript
+import axios from "axios";
+const resp = await axios.get("https://anikato.vercel.app/api/suggestions", {
+  params: { keyword: "naruto" }
+});
+console.log(resp.data);
+```
+
 <details>
 <summary>📄 Example Response</summary>
 
@@ -1550,6 +1742,12 @@ curl "https://anikato.vercel.app/api/suggestions?keyword=naruto"
 npx vercel --prod
 ```
 
+### 🖥️ Render
+
+Host your own instance of AniKatoAPI on Render.
+
+[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/Shineii86/AniKatoAPI)
+
 ### 🖥️ Standalone Server
 
 ```bash