{"id":18243762,"url":"https://github.com/abdipr/myinstants-api","last_synced_at":"2026-04-24T16:06:50.451Z","repository":{"id":260715664,"uuid":"882132193","full_name":"abdipr/myinstants-api","owner":"abdipr","description":"MyInstants Unofficial REST API","archived":false,"fork":false,"pushed_at":"2024-12-14T09:02:09.000Z","size":84,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-14T14:43:29.411Z","etag":null,"topics":["api","json","myinstants","php","rest-api","simplehtmlphp","soundboard"],"latest_commit_sha":null,"homepage":"https://myinstants-api.vercel.app","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abdipr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-02T00:49:58.000Z","updated_at":"2024-12-14T09:02:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"6ee2b427-eed9-4bf8-b6cf-15ee24dcfae6","html_url":"https://github.com/abdipr/myinstants-api","commit_stats":{"total_commits":28,"total_committers":1,"mean_commits":28.0,"dds":0.0,"last_synced_commit":"2d234f08e3e945a4b98baf2b8b3de445d530a762"},"previous_names":["abdipr/myinstants-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abdipr%2Fmyinstants-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abdipr%2Fmyinstants-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abdipr%2Fmyinstants-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abdipr%2Fmyinstants-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abdipr","download_url":"https://codeload.github.com/abdipr/myinstants-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247900712,"owners_count":21015109,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","json","myinstants","php","rest-api","simplehtmlphp","soundboard"],"created_at":"2024-11-05T09:03:00.301Z","updated_at":"2026-04-24T16:06:50.433Z","avatar_url":"https://github.com/abdipr.png","language":"PHP","funding_links":["https://www.buymeacoffee.com/abdipr"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"https://www.myinstants.com/media/apple-touch-icon-114x114.png\" alt=\"MyInstants\"\u003e\u003c/p\u003e\n\u003ch1 align=\"center\"\u003eMyInstants REST API\u003c/h1\u003e\n\u003cp align=\"center\"\u003eA RESTful API for scraping and retrieving sound data from the \u003ca href=\"https://www.myinstants.com\" target=\"_blank\"\u003eMyInstants\u003c/a\u003e website. This API provides endpoints for retrieving information about sounds, including titles, URLs, descriptions, tags, favorites, views, and uploader details.\u003c/p\u003e\n\n## ✨ Support\n\nIf you like this project, please star on this repository, thank you ⭐\u003cbr\u003e\nYou can support me by:\u003cbr\u003e\n\u003ca href=\"https://trakteer.id/abdipr\" target=\"_blank\"\u003e\u003cimg id=\"wse-buttons-preview\" src=\"https://cdn.trakteer.id/images/embed/trbtn-red-1.png?date=18-11-2023\" height=\"40\" style=\"border: 0px; height: 40px;\" alt=\"Trakteer Saya\"\u003e\u003c/a\u003e\n\u003ca href=\"https://saweria.co/abdipr\" target=\"_blank\"\u003e\u003cimg height=\"42\" src=\"https://files.catbox.moe/fwpsve.png\"\u003e\u003c/a\u003e\n\u003ca href=\"https://www.buymeacoffee.com/abdipr\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 40px !important;width: auto !important;\" \u003e\u003c/a\u003e\n\n## Table of Contents\n\n- [Getting Started](#-getting-started)\n    - [Introduction](#introduction)\n    - [Requirements](#requirements)\n    - [Installation](#installation)\n- [Reference](#%EF%B8%8F-reference)\n    - [Endpoints](#endpoints)\n    - [Request Parameters](#request-parameters)\n    - [Response Parameters](#response-parameters)\n- [Error Handling](#-error-handling)\n- [Examples](#-examples)\n    - [Example 1: Trending](#example-1-get-trending-sounds-by-region)\n    - [Example 2: Search](#example-2-search-sounds-by-query)\n    - [Example 3: Detail](#example-3-get-sound-details-by-id)\n    - [Example 4: Recent](#example-4-get-recently-uploaded-sounds)\n    - [Example 5: Best of All Time](#example-5-get-best-of-all-time-sounds)\n    - [Example 6: Uploaded](#example-6-get-users-uploaded-sounds)\n    - [Example 7: Favorites](#example-7-get-users-favorite-sounds)\n- [Contributing](#-contributing)\n- [License](#%EF%B8%8F-license)\n- [Disclaimer](#%EF%B8%8F-disclaimer)\n\n## 🚀 Getting Started\n\n### Introduction\n\nThe MyInstants REST API is designed to provide a structured way to retrieve sound data from the MyInstants website. This API is suitable for applications that need to access sound information dynamically without direct interactions with the MyInstants site.\n\n### Requirements\n\n- PHP 7.4 or higher\n- [simple_html_dom.php](https://simplehtmldom.sourceforge.io/) library for HTML parsing\n- Internet access for scraping the MyInstants website\n\n### Installation\n\n1. Clone the repository to your server:\n    ```bash\n    git clone https://github.com/abdipr/myinstants-api.git\n    cd myinstants-api\n    ```\n\n2. Download and include `simple_html_dom.php` in the project directory.\n\n3. Set up your server to serve PHP files (e.g., Apache or Nginx).\n\n4. Or, you can deploy directly to Vercel here\u003cbr\u003e\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fabdipr%2Fmyinstants-api%2F\u0026redirect-url=https%3A%2F%2Fgithub.com%2Fabdipr%2Fmyinstants-api%2F)\n\n## ❇️ Reference\n\n### Endpoints\nBase URL: https://myinstants-api.vercel.app\n\n| Request                            | Response                  | Parameter |\n| :--------------------------------- | :------------------------ | :-------: |\n| `GET /trending`                    | Trending based region     |    `q`    |\n| `GET /search`                      | Search a sound            |    `q`    |\n| `GET /detail`                      | The sound details         |    `id`   |\n| `GET /recent`                      | Recently uploaded sounds  |           |\n| `GET /best`                        | Best of all time sounds   |           |\n| `GET /uploaded`                    | User's uploaded sounds    | `username`|\n| `GET /favorites`                   | User's favorite sounds    | `username`|\n\n### Request Parameters\n| Parameter | Description             |\n| :-------: | :---------------------- |\n|     `q`   | Search query or region  |\n| `username`| User's username         |\n|    `id`   | Sound's Unique ID       |\n\n### Response Parameters\n| Parameter     | Description                                                                |\n| :------------ | :------------------------------------------------------------------------- |\n| `id`          | Unique ID of the sound.                                                    |\n| `url`         | Direct URL to the sound page.                                              |\n| `title`       | Title of the sound.                                                        |\n| `mp3`         | Direct URL to the MP3 file.                                                |\n| `description` | Description of the sound.                                                  |\n| `tags`        | Array of tags associated with the sound.                                   |\n| `favorites`   | Number of users who favorited the sound.                                   |\n| `views`       | View count of the sound.                                                   |\n| `uploader`    | Details about the uploader, including the uploader’s name and profile URL. |\n\n## 💥 Error Handling\n\nAll errors return JSON objects with a `status` code and `message` explaining the issue.\n\n- **404 Error**:\n    - When the page is not found or the query parameter is missing.\n    ```json\n    {\n      \"status\": \"404\",\n      \"author\": \"abdiputranar\",\n      \"message\": \"Page not found\"\n    }\n    ```\n  \n## 🌐 Examples\n\n### Example 1: Get Trending Sounds by Region\n\nRetrieve trending sounds based on a specified region:\n```http\nGET https://myinstants-api.vercel.app/trending?q=id\n```\n\n### Example 2: Search Sounds by Query\n\nSearch for sounds using a specific keyword:\n```http\nGET https://myinstants-api.vercel.app/search?q=laugh\n```\n\n### Example 3: Get Sound Details by ID\n\nRetrieve the details of a sound using its unique ID:\n```http\nGET https://myinstants-api.vercel.app/detail?id=akh-26815\n```\n\n### Example 4: Get Recently Uploaded Sounds\n\nRetrieve a list of the most recently uploaded sounds:\n```http\nGET https://myinstants-api.vercel.app/recent\n```\n\n### Example 5: Get Best of All Time Sounds\n\nRetrieve a list of the most popular sounds of all time:\n```http\nGET https://myinstants-api.vercel.app/best\n```\n\n### Example 6: Get User's Uploaded Sounds\n\nRetrieve all sounds uploaded by a specific user:\n```http\nGET https://myinstants-api.vercel.app/uploaded?username=hellmouz\n```\n\n### Example 7: Get User's Favorite Sounds\n\nRetrieve a list of sounds favorited by a specific user:\n```http\nGET https://myinstants-api.vercel.app/favorites?username=hellmouz\n```\n\n### Notes\n- **`q` Parameter**: Used for searching or specifying the region for trending sounds.\n- **`id` Parameter**: Unique identifier for accessing sound details.\n- **`username` Parameter**: User's profile name for accessing their uploads or favorites.\n\n## 🌱 Contributing\n\nContributions are welcome! To contribute:\n\n1. Fork the repository.\n2. Create a feature branch: `git checkout -b feature-name`.\n3. Commit your changes: `git commit -m 'Add feature'`.\n4. Push to the branch: `git push origin feature-name`.\n5. Submit a pull request.\n\n## ⚖️ License\n\nThis project is licensed under the `MIT License`. See the [LICENSE](https://github.com/abdipr/myinstants-api/blob/main/LICENSE) file for more information.\n\n## ⚠️ Disclaimer\n\nThe sounds contained in this API are obtained from the original [MyInstants](https://www.myinstants.com) website by web scraping. Developers using this API must follow the applicable regulations by mentioning this project or the official owner in their projects and are prohibited from abusing this API for personal benefits.\n\n\n[⬆️ Back to Top](#myinstants-rest-api)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdipr%2Fmyinstants-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabdipr%2Fmyinstants-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdipr%2Fmyinstants-api/lists"}