morsel-api
Version:
Morsel api node.js package.
432 lines (319 loc) • 10 kB
Markdown
### 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:
```bash
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:
```javascript
const MorselAPI = require('morsel-api');
const api = new MorselAPI();
```
**Available Methods**
1. **Apple App Store Search**
Searches for apps on the Apple App Store.
```javascript
const results = await api.appleAppStoreSearch('Instagram', 5, 'US', 'en_us');
console.log(results);
```
2. **Apple Store Search**
Searches for products on the Apple Store.
```javascript
const results = await api.appleStoreSearch('MacBook Pro', 'en');
console.log(results);
```
3. **Aoi.js Functions Search**
Searches for Aoi.js functions.
```javascript
const results = await api.aoijsFunctionsSearch('sendMessage', 5);
console.log(results);
```
4. **Brawl Stars User Info**
Fetches information about a specified Brawl Stars user.
```javascript
const info = await api.brawlstarsUserInfo('USER_ID');
console.log(info);
```
5. **Color Info**
Retrieves information about a given color.
```javascript
const info = await api.colorInfo('#ff5733');
console.log(info);
```
6. **Deezer Search**
Searches for music on Deezer.
```javascript
const results = await api.deezerSearch('Daft Punk', 'track');
console.log(results);
```
7. **Discord User Info**
Fetches information about a specified Discord user.
```javascript
const info = await api.discordUserInfo('USER_ID');
console.log(info);
```
8. **Earthquake Search**
Searches for earthquake data.
```javascript
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.
```javascript
const rate = await api.exchangeRate(100, 'USD', 'EUR');
console.log(rate);
```
10. **Fitness Calorie Needs**
Calculates daily calorie needs based on provided parameters.
```javascript
const calories = await api.fitnessCalorieNeeds('male', 25, 180, 70, 'active');
console.log(calories);
```
11. **Gender Detection**
Predicts gender based on a given name.
```javascript
const gender = await api.detectGender('John');
console.log(gender);
```
12. **Song Search**
Searches for songs.
```javascript
const results = await api.songSearch('Shape of You');
console.log(results);
```
13. **YouTube Search**
Performs a search on YouTube.
```javascript
const results = await api.youtubeSearch('JavaScript Tutorials', 'videos');
console.log(results);
```
14. **Genius Artist Info**
Fetches information about an artist on Genius.
```javascript
const info = await api.geniusArtistInfo('Eminem');
console.log(info);
```
15. **GitHub Search**
Performs a search on GitHub.
```javascript
const results = await api.githubSearch('axios', 5, 'repositories');
console.log(results);
```
16. **GitHub User Info**
Fetches information about a specified GitHub user.
```javascript
const info = await api.githubUserInfo('octocat');
console.log(info);
```
17. **Google Image Search**
Performs an image search on Google.
```javascript
const results = await api.googleImageSearch('sunsets', true);
console.log(results);
```
18. **Google Play Store Search**
Searches for apps on the Google Play Store.
```javascript
const results = await api.googlePlaystoreSearch('Facebook', 5);
console.log(results);
```
19. **Google Trends**
Fetches Google trends for a specified date and country.
```javascript
const trends = await api.googleTrends('2024-08-01', 'US');
console.log(trends);
```
20. **Historical Events**
Fetches historical events for a specified date.
```javascript
const events = await api.historicalEvents('2024-08-01');
console.log(events);
```
21. **Instagram User Info**
Fetches information about a specified Instagram user.
```javascript
const info = await api.instagramUserInfo('instagram');
console.log(info);
```
22. **IP Geolocation**
Fetches the geographical location of an IP address.
```javascript
const location = await api.ipGeolocation('8.8.8.8');
console.log(location);
```
23. **iTunes Search**
Searches for songs on iTunes.
```javascript
const results = await api.appleItunesSearch('Adele');
console.log(results);
```
24. **Minecraft Server Status**
Checks the status of a Minecraft server.
```javascript
const status = await api.minecraftServerStatus('mc.hypixel.net');
console.log(status);
```
25. **Movie Info**
Fetches information about a specified movie.
```javascript
const info = await api.movieInfo('Inception');
console.log(info);
```
26. **Movie Search**
Searches for movies.
```javascript
const results = await api.movieSearch('Inception');
console.log(results);
```
27. **NBA Player Info**
Fetches information about an NBA player.
```javascript
const info = await api.nbaPlayerInfo('LeBron James');
console.log(info);
```
28. **News**
Fetches current news for a specified country.
```javascript
const articles = await api.news('tr');
console.log(articles);
```
29. **NPM Package Info**
Fetches information about an NPM package.
```javascript
const info = await api.npmPackageInfo('axios');
console.log(info);
```
30. **NPM Package Search**
Searches for NPM packages.
```javascript
const results = await api.npmPackageSearch('axios', 5);
console.log(results);
```
31. **Password Generator**
Generates a random password based on provided criteria.
```javascript
const password = await api.passwordGenerate(12, true, true, true, true);
console.log(password);
```
32. **Random User**
Fetches random user information.
```javascript
const users = await api.randomUser('female', 'us', 5);
console.log(users);
```
33. **Recipes**
Searches for recipes based on the provided criteria.
```javascript
const recipes = await api.recipes('pasta', 'italian', 3);
console.log(recipes);
```
34. **Reverse Text**
Reverses the given text.
```javascript
const reversed = await api.reverseText('Hello World');
console.log(reversed);
```
35. **Roblox User Search**
Searches for users on Roblox.
```javascript
const results = await api.robloxUserSearch('RobloxUser', 5);
console.log(results);
```
36. **Song Suggestion**
Suggests songs based on mood or genre.
```javascript
const songs = await api.songSuggestion('happy', 'pop', 5);
console.log(songs);
```
37. **SoundCloud Search**
Performs a search on SoundCloud.
```javascript
const results = await api.soundcloudSearch('lofi beats');
console.log(results);
```
38. **Spotify Search**
Searches for songs on Spotify.
```javascript
const results = await api.spotifySearch('Blinding Lights');
console.log(results);
```
39. **Steam Game Info**
Fetches information about a specified game on Steam.
```javascript
const gameInfo = await api.steamGameInfo('Counter-Strike: Global Offensive');
console.log(gameInfo);
```
40. **Steam Search**
Searches for games on Steam.
```javascript
const results = await api.steamSearch('Half-Life');
console.log(results);
```
41. **TikTok User Info**
Fetches information about a specified TikTok user.
```javascript
const userInfo = await api.tiktokUserInfo('tiktokuser');
console.log(userInfo);
```
42. **Translate**
Translates the given text into a target language.
```javascript
const translation = await api.translate('Hello, world!', 'tr', 'en');
console.log(translation);
```
43. **Trendyol Search**
Searches for products on Trendyol.
```javascript
const products = await api.trendyolSearch('laptop', 1000, 5000);
console.log(products);
```
44. **URL Detector**
Checks if a given URL is malicious.
```javascript
const result = await api.urlDetector('https://example.com');
console.log(result);
```
45. **Wattpad Search**
Searches for stories on Wattpad.
```javascript
const stories = await api.wattpadSearch('romance', 5, 'en', false);
console.log(stories);
```
46. **Weather**
Fetches weather information for a specified location.
```javascript
const weather = await api.weather('Istanbul', 3);
console.log(weather);
```
47. **Wikipedia Search**
Performs a search on Wikipedia.
```javascript
const results = await api.wikipediaSearch('JavaScript', 'en');
console.log(results);
```
48. **WHD Indicator**
Fetches World Health Data (WHD) indicator information.
```javascript
const data = await api.whdIndicator('life_expectancy');
console.log(data);
```
49. **YouTube Search**
Searches for videos on YouTube.
```javascript
const songs = await api.youtubeSearch('Mr Beast', 'videos');
console.log(songs);
```
50. **YouTube Music Search**
Searches for music on YouTube Music.
```javascript
const songs = await api.youtubeMusicSearch('lofi', 'tracks');
console.log(songs);
```
## License
This project is licensed under the Apache License 2.0 - see the [LICENSE](./LICENSE) file for details.