Morsel API Client

Overview

The Morsel API Client provides functions to interact with various APIs, including Apple App Store, Google Play Store, Deezer, Spotify, and more. This client allows you to fetch data from different sources.

Installation

To get started, you need to install the morsel-api library:

npm install morsel-api

MorselAPI Class

The MorselAPI class provides various methods to interact with different APIs. Below are the available methods and their usage examples.

Getting Started

First, import the MorselAPI class and create an instance:

const MorselAPI = require('morsel-api');
const api = new MorselAPI();

Available Methods

1. Apple App Store Search Searches for apps on the Apple App Store.

   const results = await api.appleAppStoreSearch('Instagram', 5, 'US', 'en_us');
   console.log(results);

2. Apple Store Search Searches for products on the Apple Store.

   const results = await api.appleStoreSearch('MacBook Pro', 'en');
   console.log(results);

3. Aoi.js Functions Search Searches for Aoi.js functions.

   const results = await api.aoijsFunctionsSearch('sendMessage', 5);
   console.log(results);

4. Brawl Stars User Info Fetches information about a specified Brawl Stars user.

   const info = await api.brawlstarsUserInfo('USER_ID');
   console.log(info);

5. Color Info Retrieves information about a given color.

   const info = await api.colorInfo('#ff5733');
   console.log(info);

6. Deezer Search Searches for music on Deezer.

   const results = await api.deezerSearch('Daft Punk', 'track');
   console.log(results);

7. Discord User Info Fetches information about a specified Discord user.

   const info = await api.discordUserInfo('USER_ID');
   console.log(info);

8. Earthquake Search Searches for earthquake data.

   const results = await api.earthquakeSearch(34.0, 36.0, 25.0, 27.0);
   console.log(results);

9. Exchange Rate Calculates the exchange rate between two currencies.

   const rate = await api.exchangeRate(100, 'USD', 'EUR');
   console.log(rate);

10. Fitness Calorie Needs Calculates daily calorie needs based on provided parameters.

    const calories = await api.fitnessCalorieNeeds('male', 25, 180, 70, 'active');
    console.log(calories);

11. Gender Detection Predicts gender based on a given name.

    const gender = await api.detectGender('John');
    console.log(gender);

12. Song Search Searches for songs.

    const results = await api.songSearch('Shape of You');
    console.log(results);

13. YouTube Search Performs a search on YouTube.

    const results = await api.youtubeSearch('JavaScript Tutorials', 'videos');
    console.log(results);

14. Genius Artist Info Fetches information about an artist on Genius.

    const info = await api.geniusArtistInfo('Eminem');
    console.log(info);

15. GitHub Search Performs a search on GitHub.

    const results = await api.githubSearch('axios', 5, 'repositories');
    console.log(results);

16. GitHub User Info Fetches information about a specified GitHub user.

    const info = await api.githubUserInfo('octocat');
    console.log(info);

17. Google Image Search Performs an image search on Google.

    const results = await api.googleImageSearch('sunsets', true);
    console.log(results);

18. Google Play Store Search Searches for apps on the Google Play Store.

    const results = await api.googlePlaystoreSearch('Facebook', 5);
    console.log(results);

19. Google Trends Fetches Google trends for a specified date and country.

    const trends = await api.googleTrends('2024-08-01', 'US');
    console.log(trends);

20. Historical Events Fetches historical events for a specified date.

    const events = await api.historicalEvents('2024-08-01');
    console.log(events);

21. Instagram User Info Fetches information about a specified Instagram user.

    const info = await api.instagramUserInfo('instagram');
    console.log(info);

22. IP Geolocation Fetches the geographical location of an IP address.

    const location = await api.ipGeolocation('8.8.8.8');
    console.log(location);

23. iTunes Search Searches for songs on iTunes.

    const results = await api.appleItunesSearch('Adele');
    console.log(results);

24. Minecraft Server Status Checks the status of a Minecraft server.

    const status = await api.minecraftServerStatus('mc.hypixel.net');
    console.log(status);

25. Movie Info Fetches information about a specified movie.

    const info = await api.movieInfo('Inception');
    console.log(info);

26. Movie Search Searches for movies.

    const results = await api.movieSearch('Inception');
    console.log(results);

27. NBA Player Info Fetches information about an NBA player.

    const info = await api.nbaPlayerInfo('LeBron James');
    console.log(info);

28. News Fetches current news for a specified country.

    const articles = await api.news('tr');
    console.log(articles);

29. NPM Package Info Fetches information about an NPM package.

    const info = await api.npmPackageInfo('axios');
    console.log(info);

30. NPM Package Search Searches for NPM packages.

    const results = await api.npmPackageSearch('axios', 5);
    console.log(results);

31. Password Generator Generates a random password based on provided criteria.

    const password = await api.passwordGenerate(12, true, true, true, true);
    console.log(password);

32. Random User Fetches random user information.

    const users = await api.randomUser('female', 'us', 5);
    console.log(users);

33. Recipes Searches for recipes based on the provided criteria.

    const recipes = await api.recipes('pasta', 'italian', 3);
    console.log(recipes);

34. Reverse Text Reverses the given text.

    const reversed = await api.reverseText('Hello World');
    console.log(reversed);

35. Roblox User Search Searches for users on Roblox.

    const results = await api.robloxUserSearch('RobloxUser', 5);
    console.log(results);

36. Song Suggestion Suggests songs based on mood or genre.

    const songs = await api.songSuggestion('happy', 'pop', 5);
    console.log(songs);

37. SoundCloud Search Performs a search on SoundCloud.

    const results = await api.soundcloudSearch('lofi beats');
    console.log(results);

38. Spotify Search Searches for songs on Spotify.

    const results = await api.spotifySearch('Blinding Lights');
    console.log(results);

39. Steam Game Info Fetches information about a specified game on Steam.

    const gameInfo = await api.steamGameInfo('Counter-Strike: Global Offensive');
    console.log(gameInfo);

40. Steam Search Searches for games on Steam.

    const results = await api.steamSearch('Half-Life');
    console.log(results);

41. TikTok User Info Fetches information about a specified TikTok user.

    const userInfo = await api.tiktokUserInfo('tiktokuser');
    console.log(userInfo);

42. Translate Translates the given text into a target language.

    const translation = await api.translate('Hello, world!', 'tr', 'en');
    console.log(translation);

43. Trendyol Search Searches for products on Trendyol.

    const products = await api.trendyolSearch('laptop', 1000, 5000);
    console.log(products);

44. URL Detector Checks if a given URL is malicious.

    const result = await api.urlDetector('https://example.com');
    console.log(result);

45. Wattpad Search Searches for stories on Wattpad.

    const stories = await api.wattpadSearch('romance', 5, 'en', false);
    console.log(stories);

46. Weather Fetches weather information for a specified location.

    const weather = await api.weather('Istanbul', 3);
    console.log(weather);

47. Wikipedia Search Performs a search on Wikipedia.

    const results = await api.wikipediaSearch('JavaScript', 'en');
    console.log(results);

48. WHD Indicator Fetches World Health Data (WHD) indicator information.

    const data = await api.whdIndicator('life_expectancy');
    console.log(data);

49. YouTube Search Searches for videos on YouTube.

    const songs = await api.youtubeSearch('Mr Beast', 'videos');
    console.log(songs);

50. YouTube Music Search Searches for music on YouTube Music.

    const songs = await api.youtubeMusicSearch('lofi', 'tracks');
    console.log(songs);

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.