This is the Songtradr API. Use it to retrieve deep music metadata and trigger processes like auto-tagging. You can also use the API to manage your account and musicube cloud data. **Authentication** 1. Reach out to support@songtradr.com to receive a free account or use your login data if you are already signed up. 2. To authenticate, you need to login via the POST /api/v1/user/login endpoint. 3. The endpoint responds with a jwtToken which you can use in all following API requests as a bearer token. **Rate Limiting** The current limit is 120 Requests per minute. Reach out to us via support@songtradr.com if you need to request more. **Getting Started with auto-tagging** 1. If you want to get your own files auto-tagged, use the POST /api/v1/user/file/{name}/initUpload endpoint. It responds with a presigned S3 link where you can upload your file. 2. You can check the processing status of your file via the GET /api/v1/user/file/{name}/filesStatus endpoint. 3. As soon as processing is done, you can request the generated data via the GET /api/v1/user/files endpoint. **Getting Started with search** You can either search the released music via the /public/recording endpoints or your own private uploaded music via the /user/file/ endpoints. 1. If you want to search the world's released music, a good starting point is the GET /api/v1/public/recording/search endpoint. Please find the extensive list of parameters that serve as semantic search filters. 2. If you want to search your own previously uploaded music, a good starting point is the GET GET /api/v1/user/files endpoint. It has the same extensive list of parameters that serve as semantic search filters.
Raw data
{
"_id": null,
"home_page": "https://github.com/songtradr/songtradr-python-api-client-docs",
"name": "songtradr-api-client-python",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "OpenAPI, OpenAPI-Generator, Songtradr API",
"author": "Songtradr Inc.",
"author_email": "info@songtradr.com",
"download_url": "https://files.pythonhosted.org/packages/4b/77/dc643e984f658c6784a932d7d99eeed7b0e69b38357949ebf6deff68122b/songtradr_api_client_python-3.0.0.tar.gz",
"platform": null,
"description": " This is the Songtradr API. Use it to retrieve deep music metadata and trigger processes like auto-tagging. You can also use the API to manage your account and musicube cloud data. **Authentication** 1. Reach out to support@songtradr.com to receive a free account or use your login data if you are already signed up. 2. To authenticate, you need to login via the POST /api/v1/user/login endpoint. 3. The endpoint responds with a jwtToken which you can use in all following API requests as a bearer token. **Rate Limiting** The current limit is 120 Requests per minute. Reach out to us via support@songtradr.com if you need to request more. **Getting Started with auto-tagging** 1. If you want to get your own files auto-tagged, use the POST /api/v1/user/file/{name}/initUpload endpoint. It responds with a presigned S3 link where you can upload your file. 2. You can check the processing status of your file via the GET /api/v1/user/file/{name}/filesStatus endpoint. 3. As soon as processing is done, you can request the generated data via the GET /api/v1/user/files endpoint. **Getting Started with search** You can either search the released music via the /public/recording endpoints or your own private uploaded music via the /user/file/ endpoints. 1. If you want to search the world's released music, a good starting point is the GET /api/v1/public/recording/search endpoint. Please find the extensive list of parameters that serve as semantic search filters. 2. If you want to search your own previously uploaded music, a good starting point is the GET GET /api/v1/user/files endpoint. It has the same extensive list of parameters that serve as semantic search filters.\n \n",
"bugtrack_url": null,
"license": null,
"summary": "Songtradr API",
"version": "3.0.0",
"project_urls": {
"Homepage": "https://github.com/songtradr/songtradr-python-api-client-docs"
},
"split_keywords": [
"openapi",
" openapi-generator",
" songtradr api"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f876f9981cda60b57a3b528685d5c6ec46971ab8e614b5f0baac0daeb17084b1",
"md5": "7ebfd59b672bd2412afb5455b7adaee8",
"sha256": "58abce7ae61f1f677bdd08e828d5f7339cdc0cab14af3e1af9d1aa411aff557e"
},
"downloads": -1,
"filename": "songtradr_api_client_python-3.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7ebfd59b672bd2412afb5455b7adaee8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 133470,
"upload_time": "2024-06-03T14:40:59",
"upload_time_iso_8601": "2024-06-03T14:40:59.494081Z",
"url": "https://files.pythonhosted.org/packages/f8/76/f9981cda60b57a3b528685d5c6ec46971ab8e614b5f0baac0daeb17084b1/songtradr_api_client_python-3.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4b77dc643e984f658c6784a932d7d99eeed7b0e69b38357949ebf6deff68122b",
"md5": "9ddb957034c28df885f9e00cb3a299ac",
"sha256": "935342bdd252c9932b93d889a0320b447250dec7e0f8bb6b13dc981a8703ac23"
},
"downloads": -1,
"filename": "songtradr_api_client_python-3.0.0.tar.gz",
"has_sig": false,
"md5_digest": "9ddb957034c28df885f9e00cb3a299ac",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 67760,
"upload_time": "2024-06-03T14:41:00",
"upload_time_iso_8601": "2024-06-03T14:41:00.838520Z",
"url": "https://files.pythonhosted.org/packages/4b/77/dc643e984f658c6784a932d7d99eeed7b0e69b38357949ebf6deff68122b/songtradr_api_client_python-3.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-03 14:41:00",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "songtradr",
"github_project": "songtradr-python-api-client-docs",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "songtradr-api-client-python"
}
JSON
