AquaScript

Comprehensive Documentation

Back
Core APIs
Books API Books++ API Movies API Movies++ API
Content APIs
Quotes API Quotes++ API Jokes API Programming Jokes API
Data APIs
Random User API Recipes API Songs API
Coming Soon
New APIs

Books API

Access a comprehensive collection of book data including titles, authors, genres, and publication details. Perfect for building book-related applications or populating your UI with realistic book data.

Schema Structure

[
  {
    "title": "Book Title",
    "author": "Author Name",
    "language": "Language",
    "country": "Country of Origin",
    "pages": 320,
    "year": 2020,
    "imageLink": "URL to cover image",
    "link": "Wikipedia or other reference link"
  },
  ...
]

Example Usage

fetch('https://aquascript.xyz/api/books.json')
  .then(response => response.json())
  .then(data => {
    // Process book data
    data.forEach(book => {
      console.log(`Title: ${book.title}, Author: ${book.author}`);
    });
  });

Books++ API

Enhanced book data with additional details like ISBN, publisher, description, and ratings. Ideal for applications requiring more comprehensive book information.

Schema Structure

[
  {
    "title": "Book Title",
    "author": "Author Name",
    "isbn": "ISBN Number",
    "publisher": "Publisher Name",
    "publishedDate": "YYYY-MM-DD",
    "description": "Book summary...",
    "pageCount": 320,
    "categories": ["Genre1", "Genre2"],
    "averageRating": 4.5,
    "ratingsCount": 120,
    "language": "en",
    "imageLinks": {
      "thumbnail": "URL to thumbnail",
      "small": "URL to small image",
      "medium": "URL to medium image",
      "large": "URL to large image"
    },
    "previewLink": "URL to preview"
  },
  ...
]

Movies API

Comprehensive movie database with titles, release years, genres, and directors. Perfect for building movie-related applications or displaying film data.

Schema Structure

{
  "genres": ["Action", "Comedy", "Drama", ...],
  "movies": [
    {
      "title": "Movie Title",
      "year": 2020,
      "genre": ["Genre1", "Genre2"],
      "director": "Director Name",
      "poster": "URL to poster image"
    },
    ...
  ]
}

Movies++ API

Extended movie data with cast information, ratings, plot summaries, and more. Ideal for applications requiring detailed movie information.

Schema Structure

[
  {
    "title": "Movie Title",
    "year": 2020,
    "rated": "PG-13",
    "released": "YYYY-MM-DD",
    "runtime": "120 min",
    "genre": ["Genre1", "Genre2"],
    "director": "Director Name",
    "writers": ["Writer1", "Writer2"],
    "actors": ["Actor1", "Actor2", "Actor3"],
    "plot": "Movie plot summary...",
    "language": "English",
    "country": "Country",
    "awards": "Awards info",
    "poster": "URL to poster image",
    "ratings": [
      {
        "source": "Internet Movie Database",
        "value": "7.5/10"
      },
      {
        "source": "Rotten Tomatoes",
        "value": "85%"
      }
    ],
    "metascore": "75",
    "imdbRating": "7.5",
    "imdbVotes": "120,000",
    "imdbID": "tt1234567",
    "type": "movie",
    "dvd": "YYYY-MM-DD",
    "boxOffice": "$100,000,000",
    "production": "Production Company",
    "website": "Official website URL"
  },
  ...
]

Quotes API

Collection of inspirational, motivational, and thought-provoking quotes from various authors. Perfect for daily inspiration or content generation.

Schema Structure

[
  {
    "text": "The quote text...",
    "author": "Author Name",
    "category": "Category/Tag"
  },
  ...
]

Quotes++ API

Extended quotes collection with additional metadata including source, date, and popularity. Ideal for applications requiring richer quote data.

Schema Structure

[
  {
    "text": "The quote text...",
    "author": "Author Name",
    "source": "Book/Speech Title",
    "year": 1999,
    "categories": ["Category1", "Category2"],
    "popularity": 85,
    "language": "en",
    "length": 120,
    "tags": ["tag1", "tag2"]
  },
  ...
]

Jokes API

Collection of clean, family-friendly jokes for entertainment and fun applications. Great for chatbots, social features, or just to brighten someone's day.

Schema Structure

[
  {
    "setup": "The joke setup...",
    "punchline": "The punchline...",
    "type": "Joke Type"
  },
  ...
]

Programming Jokes API

A collection of tech-themed jokes specifically for developers and programmers. Perfect for coding communities, developer tools, or tech-related applications.

Schema Structure

[
  {
    "id": 1,
    "type": "programming",
    "setup": "Why do programmers prefer dark mode?",
    "punchline": "Because light attracts bugs!",
    "language": "JavaScript",
    "difficulty": "easy",
    "tags": ["programming", "dark mode", "bugs"]
  },
  {
    "id": 2,
    "type": "programming",
    "setup": "How many programmers does it take to change a light bulb?",
    "punchline": "None, that's a hardware problem!",
    "language": "General",
    "difficulty": "medium",
    "tags": ["hardware", "classic"]
  },
  ...
]

Example Usage

fetch('https://aquascript.xyz/api/programming-jokes.json')
  .then(response => response.json())
  .then(jokes => {
    // Get a random programming joke
    const randomJoke = jokes[Math.floor(Math.random() * jokes.length)];
    console.log(`${randomJoke.setup}\n${randomJoke.punchline}`);
    
    // Display in UI
    document.getElementById('joke-setup').textContent = randomJoke.setup;
    document.getElementById('joke-punchline').textContent = randomJoke.punchline;
  });
Example Response
{
  "id": 42,
  "type": "programming",
  "setup": "Why did the React component feel lost?",
  "punchline": "Because it didn't know what state it was in!",
  "language": "React",
  "difficulty": "medium",
  "tags": ["react", "state", "frontend"]
}

Random User API

Generate realistic user profiles with names, emails, addresses, and profile pictures. Perfect for prototyping user interfaces or testing applications.

Schema Structure

{
  "results": [
    {
      "gender": "male/female",
      "name": {
        "title": "Mr/Mrs/Ms",
        "first": "First",
        "last": "Last"
      },
      "location": {
        "street": {
          "number": 123,
          "name": "Street Name"
        },
        "city": "City",
        "state": "State",
        "country": "Country",
        "postcode": "Postcode",
        "coordinates": {
          "latitude": "00.0000",
          "longitude": "00.0000"
        },
        "timezone": {
          "offset": "+1:00",
          "description": "Timezone"
        }
      },
      "email": "email@example.com",
      "login": {
        "uuid": "UUID",
        "username": "username",
        "password": "password",
        "salt": "salt",
        "md5": "md5",
        "sha1": "sha1",
        "sha256": "sha256"
      },
      "dob": {
        "date": "YYYY-MM-DD",
        "age": 30
      },
      "registered": {
        "date": "YYYY-MM-DD",
        "age": 5
      },
      "phone": "Phone Number",
      "cell": "Cell Number",
      "id": {
        "name": "ID Type",
        "value": "ID Value"
      },
      "picture": {
        "large": "URL to large image",
        "medium": "URL to medium image",
        "thumbnail": "URL to thumbnail"
      },
      "nat": "Nationality"
    }
  ],
  "info": {
    "seed": "Seed Value",
    "results": 1,
    "page": 1,
    "version": "1.3"
  }
}

Recipes API

Comprehensive recipe database with ingredients, instructions, cooking times, and nutritional information. Perfect for food-related applications or meal planning tools.

Schema Structure

{
  "recipes": {
    "recipe1": {
      "name": "Recipe Name",
      "source": "Source",
      "preptime": 15,
      "cooktime": 30,
      "waittime": 10,
      "servings": 4,
      "comments": "Additional notes",
      "ingredients": [
        "1 cup Ingredient1",
        "2 tbsp Ingredient2",
        ...
      ],
      "instructions": "Step by step instructions...",
      "tags": ["tag1", "tag2"],
      "calories": 350,
      "fat": 12,
      "satfat": 4,
      "carbs": 45,
      "fiber": 5,
      "sugar": 10,
      "protein": 15
    },
    ...
  }
}

Songs API

Music database with song titles, artists, release dates, and durations. Great for music-related applications or historical data analysis.

Schema Structure

{
  "table": {
    "songs": {
      "song": [
        {
          "date": "Month DD, YYYY",
          "artist": "Artist Name",
          "title": "Song Title",
          "duration": "Duration in seconds"
        },
        ...
      ]
    }
  }
}

Coming Soon

We're constantly expanding our API offerings. Here's what we're working on:

Upcoming APIs

  • Weather API: Global weather data with forecasts
  • Sports API: Live scores and team statistics
  • News API: Current headlines from multiple sources
  • Products API: E-commerce product data
  • Places API: Location and point of interest data
  • Finance API: Stock market and cryptocurrency data

Have a suggestion?

We'd love to hear your ideas for new APIs! Contact us at support@aquascript.xyz with your API requests.