{"id":22859171,"url":"https://github.com/prakhardoneria/soundcloud-search-api","last_synced_at":"2026-05-09T15:17:56.475Z","repository":{"id":267698027,"uuid":"806566479","full_name":"PrakharDoneria/SoundCloud-Search-API","owner":"PrakharDoneria","description":"This Flask server provides a simple endpoint to search for tracks on SoundCloud using the SoundCloud Search API. It allows users to make GET requests with search queries to retrieve relevant tracks from SoundCloud's vast collection.","archived":false,"fork":false,"pushed_at":"2024-05-28T04:46:51.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-28T20:38:39.983Z","etag":null,"topics":["flask","flask-api","music","python3","soundcloud","soundcloud-api"],"latest_commit_sha":null,"homepage":"https://music-search-api.vercel.app","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PrakharDoneria.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-05-27T12:50:11.000Z","updated_at":"2024-05-28T04:46:55.000Z","dependencies_parsed_at":"2024-12-11T22:41:26.143Z","dependency_job_id":null,"html_url":"https://github.com/PrakharDoneria/SoundCloud-Search-API","commit_stats":null,"previous_names":["prakhardoneria/soundcloud-search-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrakharDoneria%2FSoundCloud-Search-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrakharDoneria%2FSoundCloud-Search-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrakharDoneria%2FSoundCloud-Search-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrakharDoneria%2FSoundCloud-Search-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PrakharDoneria","download_url":"https://codeload.github.com/PrakharDoneria/SoundCloud-Search-API/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246436339,"owners_count":20776995,"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":["flask","flask-api","music","python3","soundcloud","soundcloud-api"],"created_at":"2024-12-13T09:06:15.555Z","updated_at":"2026-05-09T15:17:56.393Z","avatar_url":"https://github.com/PrakharDoneria.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SoundCloud Search API - Flask Server\n\nThis Flask server provides endpoints to search for tracks on SoundCloud using the SoundCloud Search API.\n\n## Getting Started\n\nThese instructions will get you a copy of the project up and running on your local machine for development and testing purposes.\n\n### Prerequisites\n\n- Python 3.x\n- pip\n\n### Installation\n\n1. Clone the repository:\n\n    ```bash\n    git clone https://github.com/prakhardoneria/SoundCloud-Search.git\n    ```\n\n2. Navigate into the project directory:\n\n    ```bash\n    cd SoundCloud-Search\n    ```\n\n3. Install dependencies:\n\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n### Usage\n\n1. Set the SoundCloud client ID as an environment variable:\n\n    ```bash\n    export SOUNDCLOUD_CLIENT_ID=your_soundcloud_client_id\n    ```\n\n2. Run the Flask app:\n\n    ```bash\n    python main.py\n    ```\n\n3. Make GET requests to the endpoints with the `q` parameter to search for tracks on SoundCloud.\n\n#### `/search` Endpoint\n\nMake a GET request to the `/search` endpoint to search for tracks:\n\nExample:\n\n```bash\ncurl http://localhost:5000/search?q=khamo\n```\n\nSample Response:\n\n```json\n{\n    \"collection\": [\n        {\n            \"output\": \"khamoshiyan arjit singh\",\n            \"query\": \"khamoshiyan arjit singh\"\n        },\n        ...\n    ],\n    ...\n}\n```\n\n#### `/searchOne` Endpoint\n\nMake a GET request to the `/searchOne` endpoint to get the first suggestion:\n\nExample:\n\n```bash\ncurl http://localhost:5000/searchOne?q=khamo\n```\n\nSample Response:\n\n```json\n{\n    \"suggestion\": \"khamoshiyan arjit singh\"\n}\n```\n\nIf no suggestions are found:\n\n```json\n{\n    \"suggestion\": null\n}\n```\n\n### Environment Variables\n\n- `SOUNDCLOUD_CLIENT_ID`: Your SoundCloud API client ID.\n\n### Endpoints\n\n1. **/search**: Returns a list of search suggestions for the given query.\n\n    - **URL**: `/search`\n    - **Method**: `GET`\n    - **Query Parameter**: `q` (The search query)\n\n2. **/searchOne**: Returns the first search suggestion for the given query.\n\n    - **URL**: `/searchOne`\n    - **Method**: `GET`\n    - **Query Parameter**: `q` (The search query)\n\n### Sample Usage\n\n#### `/search` Endpoint\n\n```bash\ncurl http://localhost:5000/search?q=khamo\n```\n\n#### `/searchOne` Endpoint\n\n```bash\ncurl http://localhost:5000/searchOne?q=khamo\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprakhardoneria%2Fsoundcloud-search-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprakhardoneria%2Fsoundcloud-search-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprakhardoneria%2Fsoundcloud-search-api/lists"}