🎵 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:

You can also support me with cryptocurrency:

Binance Pay ID: 780389392

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.