Skip to content

FanaticExplorer/MyinstantsAPI-py

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎵 MyInstants Unofficial API

FastAPI-based unofficial API for accessing and scraping the MyInstants soundboard website.

🛠️ Originally based on abdipr/myinstants-api, this version is fully rewritten in Python, powered by FastAPI, updated and fixed.


✨ Features

  • 🔍 Search for sounds by keyword
  • 📈 Get trending and all-time best sounds by locale
  • 🆕 Browse recently added sounds
  • 👤 Retrieve a user's favorite or uploaded sounds
  • 📄 Get detailed info about any individual sound

🚀 API Endpoints

Base URL: http://localhost:8000/ (or your deployed host)

🔸 GET /docs

Interactive API documentation using Swagger UI.

🔸 GET /search?q=<query>

Search for sounds.

🔸 GET /trending?locale=us

Get trending sounds for a specific country.

🔸 GET /recent

Latest added sounds.

🔸 GET /best?locale=fr

All-time best sounds for a locale.

🔸 GET /favorites?username=<user>

Get a user's favorited sounds.

🔸 GET /uploaded?username=<user>

Get sounds uploaded by a user.

🔸 GET /detail?id=<sound_id>

Get full detail of a specific sound.


📦 Installation & Usage

  • Clone the repository
git clone https://github.com/FanaticExplorer/MyinstantsAPI-py
cd MyinstantsAPI-py
  • Install dependencies
pip install -r requirements.txt
  • Run the FastAPI server
python main.py
  • Access the API at http://localhost:8000/

💖 Support the Developer

If you find this tool useful, consider supporting my work:

Buy me a coffee Ko-fi Monobank Card

You can also support me with cryptocurrency:

Binance Pay ID: 780389392

Binance Pay QR code

Direct Wallet Addresses:

  • BTC: 1ksLDnSTekh9kdQcgeqtbdZtxKuLtDobC
  • ETH (ERC20): 0xef174683a9ca0cc6065bb8de433188bb1767b631
  • USDT (TRC20): TC3SSLB1cyD1PEugufHF5zUv3sVpFhCi7z
  • SOL (Solana): 4ZZhbfJMevkg3x9W8KQiBsdFLz5NAkKMm7takXi2Lz8i

Every donation helps me create and maintain more useful tools!


📄 License

MIT License


🗒️ Notes

⚠️ This API uses web scraping — it may break if the original website changes its structure.

About

🎶 FastAPI-based unofficial API for accessing and scraping the MyInstants soundboard website. 🚀🔊

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages