![\"Tutorial](\"https://i.vimeocdn.com/filter/overlay?src0=https://i.vimeocdn.com/video/1115080774_1280x720&src1=https://f.vimeocdn.com/images_v6/share/play_icon_overlay.png\"){kind=icon}
This is a documentation for AIMS Similarity Search. If you're looking for documentation for AIMS Auto-Tagging, please continue to docs-auto-tagging.aimsapi.com.
\nLive API: api.aimsapi.com
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"7012487","collectionId":"e25a9929-95ab-4b8d-a6c9-bd9fa1d120a1","publishedId":"S17qTprj","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"8137cf"},"publishDate":"2021-03-11T12:00:16.000Z"},"item":[{"name":"Concepts","item":[{"name":"Typical integration roadmap","item":[],"id":"ef1a9377-f093-4c39-84bc-4dc76442a847","description":"The integration roadmap depends on your preferences and the features you're going to use. The description below is purely orientational. To get a better idea of what the implementation of AIMS might look like, check out this tutorial video for our demo application. You can also play with the demo application yourself (contact us if you didn't receive a link to test the demo application yet). Finally, you can also check examples of actual client integrations at the end of this section.
\n
You can split the integration into two parts - core features and advanced features. First, there's a minimal amount of bootstrapping needed before you start calling the endpoints. The exact steps depend on your system's specifics, but generally, you \"only\" need a client that calls HTTP requests. All programming languages usually have many libraries that can do the complicated part for you. We can also recommend some of them that we have experience with if you'd like.
\nCore features are the ones that provide the similarity search functionality itself and are also the easiest to integrate.
\nSearch by ID is usually the easiest thing to integrate. From the front-end point of view, you only need to add a button to each track to perform the similarity search action and display the results in the same way you do with your current search or listing.
\nAs long as you already have a search bar, URL search is also easy to integrate. The user can paste a link into the search bar, you do some necessary validation (i.e. check if the URL leads to a supported host), and you display the results in the same way you do with your current search. You might also skip the validation since AIMS API will let you know in the response in case you submit an unsupported or invalid link (see exceptions).
\nSearch by an audio file is a bit more complicated than the previous two endpoints unless you already have an upload feature for some other use case. Ideally, you could make your search bar capable of accepting drag-n-dropped audio files and add an alternative way of uploading for users who can't (or don't want to) use dragging (e.g. an upload-icon button in the search bar). You might also want to add a progress indicator for uploading. Search by an audio file is the only search endpoint that requires multipart requests, making it a bit different on the back end as well. Still, the HTTP communication libraries usually have an easy way to create multipart requests. Displaying the results would be the same as with other endpoints.
\nBy file URL is also easy to integrate. The user can paste a link into the search bar to search similarities to track by audio file publicly accessible on a URL. You do some necessary validation (i.e. the provided URL must be publicly accessible by GET method), and you display the results in the same way you do with your current search. You might also skip the validation since AIMS API will let you know in the response in case you submit an unsupported or invalid link (see exceptions).
\nYou need to keep AIMS API in sync with your newest additions to search for the similarity among them. The add new track endpoint allows you to submit a new track. You upload an audio file and specify the metadata (most notably the id_client value for you to match the results from AIMS API with your database(s)). The endpoint provides a webhook functionality, so if you pass a webhook URL within the request, we will let you know once the track is processed. You can then make it available for search on your site (i.e. start showing the similarity button for this track).
Depending on how your publishing process looks, you might also need to implement deleting tracks and updating track metadata.
\nIf you remove a track from your system, it's also necessary to remove it from AIMS (otherwise, AIMS can still return it within results to search queries). Therefore, integration of Delete track by client ID is required to perform deletions.
\nPrompt Search is a feature that allows you to search music using natural language. You can now explore music catalogues using natural phrases, synch briefs, scene descriptions, or any other prompts you can think of.
\nTypically, when people search for music, they use keywords that align with the music catalogue and its taxonomy. However, with AIMS Prompt Search, you can simply describe what you're looking for, and you'll receive accurate results.
\nFor instance, search \"desert scene\" for Western vibes. But, tweak it to \"desert scene with camels\" and you'll find more Eastern-themed tracks.
\nThe segment selection tool allows your users to set a specific part of the track they want to use for the similarity search. This feature improves the search results, especially if the user is looking for a distinct part of the track (e.g. the intro). The segment selection tool is a purely UI thing. You only need to supply time_offset and time_limit parameters within the search request on the back end. The front-end implementation depends on the technologies you use on your site. You usually want to display a waveform of the seed track, allow the user to play the track and drag some handles over it to select the segment. You can check a reference implementation in our demo application (and we can also provide you with code samples from it). If you didn't see the demo, please contact us; we will grant you access so that you can check it.
Furthermore, we created an implementation guide for the segment tool.
\nThe highlights feature allows you to show your users where the similarity is in the resulting track. The response contains one or more segments (specified by the start point and duration) for each result. You should highlight those parts of the resulting track to show where the similarity is best. For example, if you're displaying waveforms in the results, you might \"just\" highlight the waveform's respective parts. If you don't have waveforms, you might want to start the playback at the first highlight segment's starting point. That way, the user starts listening to the track at the right point and can hear the similar part right away without skipping through the track. You can also check how we implemented highlights in our demo application.
\nSometimes, the user only wants results similar to the instrumental part of a vocal track. You should use the ignore vocals feature in such a case, which disregards the vocal part and searches according to the instrumental part. Then, on the back end, you only need to supply the suppress_vocals parameter. On the front end, adding a checkbox with appropriate text should be the most suitable option.
Sometimes, the user only wants results with BPM similar to the seed track. In such a case, you should use the prioritise BPM feature. On the back end, you only need to supply the prioritise_bpm parameter. On the front end, adding a checkbox with appropriate text should be the most suitable option.
Tag search can do a tag-based search even with no tags on your tracks. It would be best to display a select box or similar control on the front end to allow your users to choose from a list of supported tags. Apart from this extra control, there is no difference compared to the other search endpoints.
\nThe playlist generator functionality integration depends mainly on the use case for which you intend to use it. You can check the implementation in our demo application, and we can also set up a call to discuss the integration of the playlist generator for your specific needs.
\nSmart Projects functionality allows you to get recommendations of tracks to add to your projects based on music already present in the project.
\nImagine a scenario where a user is editing a cinema magazine. They're looking for an underscore. They already chose a few tracks that might fit and look for more. Instead of the user going back to search for more similar tracks, you can use projects functionality to suggest similar tracks to add to the project right away based on the tracks already present in the project.
\nPlaylists functionality allows you to
\nget recommendations of tracks to add to your playlist based on music already present in the playlist (Dynamic Playlists),
\nfind similar playlists,
\nget recommended playlists to add a seed track to (Playlist Plugging).
\n![\"CDM\"](\"https://storage.googleapis.com/aims-public-assets/docs/cdm-001.jpg\")
![\"Hudební](\"https://storage.googleapis.com/aims-public-assets/docs/hb-001.jpg\")
![\"Jaguarec\"](\"https://storage.googleapis.com/aims-public-assets/docs/jaguarec-001.jpg\")
![\"jaguarec\"](\"https://storage.googleapis.com/aims-public-assets/docs/jaguarec-002.jpg\")
![\"Sonoton\"](\"https://storage.googleapis.com/aims-public-assets/docs/sonoton-001.jpg\")
![\"Sonoton\"](\"https://storage.googleapis.com/aims-public-assets/docs/sonoton-002.jpg\")
![\"Sonoton\"](\"https://storage.googleapis.com/aims-public-assets/docs/sonoton-003.jpg\")
![\"UMPM\"](\"https://storage.googleapis.com/aims-public-assets/docs/umpm-001.jpg\")
![\"UMPM\"](\"https://storage.googleapis.com/aims-public-assets/docs/umpm-002.jpg\")
![\"UMPM\"](\"https://storage.googleapis.com/aims-public-assets/docs/umpm-003.jpg\")
https://api.aimsapi.com/v1/token/generate
\n{\n \"token\": \"aBcdeFGh1jpQlInBseI9jf5vNqfEPWj1PxK6YUYoVInyhpZntbBC7dVUpDCcSgb6\",\n \"expires\": \"2020-01-01T12:34:56+00:00\"\n}\nImportant: Token authentication is only available for endpoints within AIMS queries and Feedback. Other endpoints require full authentication using the API key.
\nSupply the token using X-Token header like this:
X-Token: aBcdeFGh1jpQlInBseI9jf5vNqfEPWj1PxK6YUYoVInyhpZntbBC7dVUpDCcSgb6\nDo not use Authorization header!
401 Unauthorized HTTP status code is returned in case of invalid token. The response body contains informative message such as:
{\n \"message\": \"Token has been used already\"\n}\nList of data types
\n","_postman_id":"1945f857-9319-48e0-b478-ed75924ffef4"},{"name":"Exceptions","item":[],"id":"e8777b84-37d5-45f6-b85a-9d1c67c442a7","description":"Several exceptions may occur when you use the API. The AIMS API returns all exceptions in the same JSON structure containing unique error code, short textual message and optional payload with more information.
\n{\n \"code\": 4102,\n \"message\": \"Time offset must be lesser than the duration!\",\n \"payload\": {\n \"offset\": 10000,\n \"duration\": 166.71\n }\n}\n\nThe HTTP status code indicates whether the client can solve the issue by correcting the request (4xx codes) or whether the issue needs to be solved on AIMS API servers (5xx codes).
\nPlease consult a list of possible exceptions with codes and explanations below.
\nPlease note that the table above is exapandable if your viewport is not large enough.
\n","event":[{"listen":"prerequest","script":{"id":"ef038d25-88e2-4ea7-8374-8ffd93363a79","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"0a406348-fdfe-4724-82e2-f249667856a5","type":"text/javascript","exec":[""]}}],"_postman_id":"e8777b84-37d5-45f6-b85a-9d1c67c442a7"},{"name":"Feedback","item":[{"name":"Conversion","id":"b11b498b-d1ed-40ab-9a5d-85fc42875f2a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_client\": \"SOME#ID\",\n \"type\": \"track_like\",\n\t\"query_id\": \"3db4162a-0346-4b9a-92d7-0a119763cbfd\"\n}"},"url":"https://api.aimsapi.com/v1/feedback/conversion","description":"This endpoint allows you to send feedback to the AIMS API. Response to each call to one of the \"AIMS queries\" endpoints (\"Search by URL\", \"Search by audio file\", \"Search by URL\") contains a field called query_id. You may use this ID to send feedback regarding the conversions of search results for the referenced query.
Please use one of these conversion types. Do you have more possible conversion types within your system? Please contact us via admin@aimsapi.com.
\nPlease note: Only use track_is_similar and track_is_not_similar types when the user is explicitly asked if the track is similar (e.g. in a modal window after the user interacts with a track in results). Prefer to use track_like and track_dislike for implicit UI controls (e.g. thumbs up/down, \"+\" or \"-\" buttons etc.).
https://api.aimsapi.com/v1/feedback/conversion
\n\"query_id\": {\n \"type\": \"uuid\",\n \"description\": \"The ID of a referenced query.\"\n},\n\"type\": {\n \"type\": \"enum\",\n \"description\": \"The type of conversion.\"\n},\n\"id_client\": {\n \"type\": \"uuid\",\n \"description\": \"The ID of the track from the search results that triggered the conversion.\"\n}\n\"required\": [\n \"query_id\",\n \"type\",\n \"id_client\"\n]\n{\n \"message\": \"Your feedback has been received. Thank you.\"\n}\nYou might need to handle multiple accounts with different tracks. Imagine serving several markets, and you can't use all of your tracks for some of them. If you had to maintain separate accounts in AIMS, and you needed to add a track that belongs into multiple accounts, you'd have to add this track numerous times (once for each account). This approach is tedious and unnecessary. There are two strategies how to handle this in AIMS. First, you'll need to have one \"main account\" in AIMS that will contain all your music for both scenarios.
\n1. Filtering
\nThis strategy is preferred since it has the lowest impact on your usage of AIMS and is more flexible than the second strategy. You can add all your music into the main (and only) account and filter the results on any search. This way, you can achieve having multiple separated sets of music within the same account. You can, e.g., filter based on territory, label code, release year or any other metadata field that is filled in your account. See filtering for more information.
\n2. Connected accounts
\nIf the above strategy doesn't work for you for some reason, you can also try using connected accounts. This way, you have multiple accounts - the main account into which you add all your tracks and one or more \"child\" accounts that receive the music from the main account based on some predefined criteria. If you want to connect multiple accounts this way, please contact us at admin@aimsapi.com. Please note that the criteria to share music from the main account to the child account(s) need to be much simpler than the filtering criteria from the first strategy (e.g. a list of label codes or territories that match exactly).
\n","_postman_id":"3161ad56-4d47-4330-8195-eaa9dacb34bd"}],"id":"5d9d8f00-df6f-44dc-99d4-23a2f9ed293b","_postman_id":"5d9d8f00-df6f-44dc-99d4-23a2f9ed293b","description":""},{"name":"Endpoints","item":[{"name":"AIMS queries","item":[{"name":"Search similar tracks by ID","item":[{"name":"Search by ID","id":"dbcc2cc8-20f9-4602-be1c-192036791ce5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"seeds\": [\n {\n \"type\": \"track\",\n \"value\": \"ID123\"\n }\n ],\n \"page\": 1,\n \"page_size\": 20\n}"},"url":"https://api.aimsapi.com/v1/search","description":"query_id to send feedback to the AIMS API. See the Conversion endpoint below.offset and limit request parameters. Please note that selecting a segment of the track only works if the Highlights functionality is enabled for your account. Also, please note that the segment must be at most 60 seconds long. See section Segment Tool.ignore_same_album request parameter. Please note that album_code field needs to be populated in your metadata for this feature to work.ignore_versions request parameter. Please note that version, album_code, track_number and master_track_number fields need to be populated and correct in your metadata for this feature to work.REQUEST SCHEMA
\n\ntype Seed = {\n type: \"track\"\n value: string // track ID (id_client)\n offset: int // min 1, within the bounds of the track duration\n limit: int // max 60, within the bounds of the track duration\n ignore_same_album: bool // default false\n ignore_versions: bool // default false\n prioritise_bpm: bool // default false\n}\ntype SearchRequest = {\n seeds: []Seed // required\n detailed?: bool // default false\n page?: int // default 1, min 1\n page_size?: int // default 20, min 1, max 1000\n highlights?: bool // default false\n filter?: Filter // see filtering\n}\n\nYou can use the returned query_id to send feedback to the AIMS API. See theConversionendpoint below.
Filtering is available for this endpoint. See theFilteringsection.
Highlights are available for this endpoint. See theHighlightssection.
time_offset and time_limit request parameters. Please note that selecting a segment of the track only works if theHighlightsfunctionality is enabled for your account. Also please note that the segment must be at most 60 seconds long. See section Segment Tool.You can avoid results from the same album using the ignore_same_album request parameter. Please note that album_code field needs to be populated in your metadata for this feature to work.
You can avoid other versions of the seed track in results using the ignore_versions request parameter. Please note that album_code, track_number and master_track_number fields need to be populated and correct in your metadata for this feature to work.
https://api.aimsapi.com/v1/query/by-id
\n\nREQUEST SCHEMA
\n\n\"track_id\": {\n \"type\": \"string\", //client_id\n \"type\": integer, //system_id\n \"description\": \"Track ID we want to searching by.\"\n},\n\"input_id_type\": {\n \"type\": \"string\",\n \"enum\": [\n \"system\",\n \"client\"\n ],\n \"default\": \"client\",\n \"description\": \"Track ID we want to searching by.\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"time_offset\": {\n \"type\": \"number\",\n \"description\": \"Number of seconds from the beginning of the track that should be skipped when searching. Only works if Highlights functionality is enabled!\"\n},\n\"time_limit\": {\n \"type\": \"number\",\n \"description\": \"Number of seconds starting from 'time_offset' that should be used for searching (1-60). Only works if Highlights functionality is enabled!\"\n},\n\"ignore_same_album\": {\n \"type\": \"bool\",\n \"description\": \"If true, no results from the same album are returned.\"\n},\n\"ignore_versions\": {\n \"type\": \"bool\",\n \"description\": \"If true, no other versions of the seed track are returned.\"\n},\n\"required\": [\n \"track_id\"\n]\n\nRESPONSE SCHEMA
\n\n\"query_id\": {\n \"type\": \"uuid\",\n \"description\": \"An ID to use to reference this query.\"\n},\n\"tracks\": {\n \"type\": \"array\",\n \"description\": \"A list of similar tracks.\"\n},\n\"required\": [\n \"query_id\",\n \"tracks\"\n]\n\nYou can use up to 100 IDs.
You can use the returned query_id to send feedback to the AIMS API. See theConversionendpoint below.
Filtering is available for this endpoint. See theFilteringsection.
https://api.aimsapi.com/v1/query/by-ids
\n\nREQUEST SCHEMA
\n\n\"track_ids\": {\n \"type\": \"string[]\", //client_id\n \"type\": \"integer[]\", //system_id\n \"description\": \"Track IDs to search by.\"\n},\n\"input_id_type\": {\n \"type\": \"string\",\n \"enum\": [\n \"system\",\n \"client\"\n ],\n \"default\": \"client\",\n \"description\": \"Type of the Track ID.\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"track_ids\"\n]\n\nRESPONSE SCHEMA
\n\n\"query_id\": {\n \"type\": \"uuid\",\n \"description\": \"An ID to use to reference this query.\"\n},\n\"tracks\": {\n \"type\": \"array\",\n \"description\": \"A list of similar tracks.\"\n},\n\"required\": [\n \"query_id\",\n \"tracks\"\n]\n\nOnly MP3, WAV and AIF(F) files are allowed.
File size limit is 120 MB.
Attribute \"track\" MUST be a file.
time_offset and time_limit request parameters. Please note that the segment must be at most 60 seconds long. See section Segment Tool.You can use the returned query_id to send feedback to the AIMS API. See theConversionendpoint below.
If you're using Angular or Ember (and possibly other JS FE frameworks) to upload files to AIMS, be aware of a need to set content-type header to undefined to allow the HTTP client to generate correct multipart boundary.
Filtering is available for this endpoint. See theFilteringsection.
Highlights are available for this endpoint. See theHighlightssection.
BPM priorotization is available for this enpoint. See thePrioritise BPMsection.
Ignore vocals is available for this endpoint. See theIgnore vocalssection.
https://api.aimsapi.com/v1/query/by-file
\n\nREQUEST SCHEMA
\n\n\"track\": {\n \"type\": \"file\",\n \"description\": \"Track file\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"time_offset\": {\n \"type\": \"number\",\n \"description\": \"Number of seconds from the beginning of the track that should be skipped when searching\"\n},\n\"time_limit\": {\n \"type\": \"number\",\n \"description\": \"Number of seconds starting from 'time_offset' that should be used for searching (1-60)\"\n}\n\"required\": [\n \"track\"\n]\n\nRESPONSE SCHEMA
\n\n\"query_id\": {\n \"type\": \"uuid\",\n \"description\": \"An ID to use to reference this query.\"\n},\n\"tracks\": {\n \"type\": \"array\",\n \"description\": \"A list of similar tracks.\"\n},\n\"required\": [\n \"query_id\",\n \"tracks\"\n]\n\nThis endpoint allows you to reuse a previously used file with the Search by audio file endpoint.
\nThe Search by audio file endpoint returns an X-Hash header. You can use this value for subsequent calls for the same file instead of reuploading the file. Please see the example next to this endpoint for details on submitting the hash.
The following services and URL patterns are supported (all mentioned URLs can also contain optional query parameters (e.g. ?list=my-youtube-list&some-other=parameter...) and fragment identifier (e.g. #t=1m22); if the identifier itself is one of the query parameters (e.g. ?v=aBcDe-FG1 in YouTube URL), the order of query parameters is not important):
YouTube:
\nhttps://gdata.youtube.com/feeds/api/videos/aBcDe-FG1/related
\nVimeo:
\nSoundcloud:
\n\nSpotify:
\n\nApple Music:
\n\nTikTok:
\n\nYou can define the exact part that should be used from the video. Use offset and limit request parameters. Please note that the segment must be at most 60 seconds long. See section Segment Tool.
You can use the returned query_id to send feedback to the AIMS API. See the Conversion endpoint below.
Please note that Spotify links only contain a 30-second preview of a track. You can not change which part of the track Spotify uses to generate the preview.
\nPlease note that Apple Music links only contain a 90-second preview of a track. You can not change which part of the track Apple Music uses to generate the preview.
\nFiltering is available for this endpoint. See the Filtering section.
\nHighlights are available for this endpoint. See the Highlights section.
\nREQUEST SCHEMA
\n\n![https://i.ytimg.com/vi/aBcDe-FG1/hqdefault.jpg](\"https://i.ytimg.com/vi/aBcDe-FG1/hqdefault.jpg\"){kind=link}
![https://img.youtube.com/vi/aBcDe-FG1/hqdefault.jpg](\"https://img.youtube.com/vi/aBcDe-FG1/hqdefault.jpg\"){kind=link}
![https://i.vimeocdn.com/video/123456789_500x123.webp](\"https://i.vimeocdn.com/video/123456789_500x123.webp\"){kind=link}
![https://i.vimeocdn.com/video/123456789_500.png](\"https://i.vimeocdn.com/video/123456789_500.png\"){kind=link}
type Seed = {\n type: \"url\"\n value: string // YouTube, Vimeo, Soundcloud, Spotify, Apple Music or TikTok link\n offset: int // default 30, min 1, within the bounds of the track duration\n limit: int // default 60, max 60, within the bounds of the track duration\n prioritise_bpm: bool // default false\n suppress_vocals: bool // default false\n}\ntype SearchRequest = {\n seeds: []Seed // required\n detailed?: bool // default false\n page?: int // default 1, min 1\n page_size?: int // default 20, min 1, max 1000\n highlights?: bool // default false\n filter?: Filter // see filtering\n}\n\nThis endpoint allows you to obtain mp3 audio to use with the Search by URL endpoint. You may play the audio to your users to allow them to select a segment of the track to search by (see See section Segment Tool or Search by URL documentation for more information about how to use time_offset and time_limit parameters).
{\n \"code\": 3002,\n \"message\": \"The requested media is too long!\",\n \"payload\": []\n}\n\nhttps://api.aimsapi.com/v1/download/by-url
\n\"link\": {\n \"type\": \"string\",\n \"description\": \"YouTube, Vimeo, or Soundcloud link.\"\n}\n\"required\": [\n \"link\"\n]\n\nThe response contains contents of a mp3 file with the audio of the linked resource.
\n...\nContent-Disposition: attachment; filename=linked-resource-identifier.mp3\n...\n\nThis endpoint was previously available as /v1/query/by-youtube - this variant has been deprecated in favor of the current /v1/query/by-url which better reflects the usage. The previous endpoint URL still works and will continue to work.
The following services and URL patterns are supported (all mentioned URLs can also contain optional query parameters (e.g. ?list=my-youtube-list&some-other=parameter...) and fragment identifier (e.g. #t=1m22); if the identifier itself is one of the query parameters (e.g. ?v=aBcDe-FG1 in YouTube URL), the order of query parameters is not important):
You can define the exact part that should be used from the video. Use time_offset and time_limit request parameters. Please note that the segment must be at most 60 seconds long. See section Segment Tool.
You can use the returned query_id to send feedback to the AIMS API. See the Conversion endpoint below.
Please note that Spotify links only contain a 30-second preview of a track. You can not change which part of the track Spotify uses to generate the preview.
\nPlease note that Apple Music links only contain a 90-second preview of a track. You can not change which part of the track Apple Music uses to generate the preview.
\nFiltering is available for this endpoint. See the Filtering section.
\nHighlights are available for this endpoint. See the Highlights section.
\nhttps://api.aimsapi.com/v1/query/by-url
\n\nREQUEST SCHEMA
\n\n\"link\": {\n \"type\": \"string\",\n \"description\": \"YouTube, Vimeo, Soundcloud, Spotify, Apple Music or TikTok link.\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"time_offset\": {\n \"type\": \"number\",\n \"description\": \"Number of seconds from the beginning of the track that should be skipped when searching\"\n},\n\"time_limit\": {\n \"type\": \"number\",\n \"description\": \"Number of seconds starting from 'time_offset' that should be used for searching (1-60)\"\n},\n\"required\": [\n \"link\"\n]\n\nRESPONSE SCHEMA
\n\n\"query_id\": {\n \"type\": \"uuid\",\n \"description\": \"An ID to use to reference this query.\"\n},\n\"tracks\": {\n \"type\": \"array\",\n \"description\": \"A list of similar tracks.\"\n},\n\"required\": [\n \"query_id\",\n \"tracks\"\n]\n\noffset and limit request parameters. Please note that the segment must be at most 60 seconds long. See section Segment Tool.query_id to send feedback to the AIMS API. See the Conversion endpoint below.REQUEST SCHEMA
\n\ntype Seed = {\n type: \"file-url\"\n value: string // track URL\n offset: int // default 30, min 1, within the bounds of the track duration\n limit: int // default 60, max 60, within the bounds of the track duration\n prioritise_bpm: bool // default false\n suppress_vocals: bool // default false\n}\ntype SearchRequest = {\n seeds: []Seed // required\n detailed?: bool // default false\n page?: int // default 1, min 1\n page_size?: int // default 20, min 1, max 1000\n highlights?: bool // default false\n filter?: Filter // see filtering\n}\n\nThe provided URL must be publicly accessible by GET method.
Only MP3 or WAV files are allowed. Correct extension must be included in the URL.
File size limit is 120 MB.
Attribute \"track\" MUST be a valid URL.
You can define the exact part that should be used from the track. Use time_offset and time_limit request parameters. Please note that the segment must be at most 60 seconds long. See section Segment Tool.
You can use the returned query_id to send feedback to the AIMS API. See theConversionendpoint below.
Filtering is available for this endpoint. See theFilteringsection.
Highlights are available for this endpoint. See theHighlightssection.
https://api.aimsapi.com/v1/query/by-file-url
\n\nREQUEST SCHEMA
\n\n\"track\": {\n \"type\": \"string<url>\",\n \"description\": \"Track URL\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"time_offset\": {\n \"type\": \"number\",\n \"description\": \"Number of seconds from the beginning of the track that should be skipped when searching\"\n},\n\"time_limit\": {\n \"type\": \"number\",\n \"description\": \"Number of seconds starting from 'time_offset' that should be used for searching (1-60)\"\n}\n\"required\": [\n \"track\"\n]\n\nRESPONSE SCHEMA
\n\n\"query_id\": {\n \"type\": \"uuid\",\n \"description\": \"An ID to use to reference this query.\"\n},\n\"tracks\": {\n \"type\": \"array\",\n \"description\": \"A list of similar tracks.\"\n},\n\"required\": [\n \"query_id\",\n \"tracks\"\n]\n\nTo improve the filtering experience on your site, you may need to display UI controls to allow your users to select from existing option(s). You can use this endpoint to retrieve the values that can be used for filtering. The list of values is getting refreshed daily and is available for the following metadata fields: tags, artists, composers, genres, instruments, moods, music_for, album_keywords. The respective metadata field must be populated to give a list of values.
Please replace the [metadata_field] with one of the fields listed above.
https://api.aimsapi.com/v1/tracks/system/1
\n\nidstring(required) Example: 1
System ID
\n\n\"track\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"number\"\n },\n \"id_client\": {\n \"type\": \"string\"\n },\n \"duration\": {\n \"type\": \"number\"\n },\n \"tags\": {\n \"type\": \"array\"\n },\n \"processed_at\": {\n \"type\": [\n \"object\",\n \"null\"\n ],\n \"properties\": {\n \"date\": {\n \"type\": \"string\",\n \"description\": \"09-18 10:00:00 (string)\"\n },\n \"timezone_type\": {\n \"type\": \"number\"\n },\n \"timezone\": {\n \"type\": \"string\"\n }\n }\n },\n \"process_input_error\": {\n \"type\": [\n \"string\",\n \"null\"\n ]\n },\n \"store_secret\": {\n \"type\": \"string\"\n }\n\nhttps://api.aimsapi.com/v1/tracks/client/1
\n\nidstring(required) Example: 1
Client ID
\n\n\"track\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"number\"\n },\n \"id_client\": {\n \"type\": \"string\"\n },\n \"duration\": {\n \"type\": \"number\"\n },\n \"tags\": {\n \"type\": \"array\"\n },\n \"processed_at\": {\n \"type\": [\n \"object\",\n \"null\"\n ],\n \"properties\": {\n \"date\": {\n \"type\": \"string\",\n \"description\": \"09-18 10:00:00 (string)\"\n },\n \"timezone_type\": {\n \"type\": \"number\"\n },\n \"timezone\": {\n \"type\": \"string\"\n }\n }\n },\n \"process_input_error\": {\n \"type\": [\n \"string\",\n \"null\"\n ]\n },\n \"store_secret\": {\n \"type\": \"string\"\n }\n }\n } \n\nThis endpoint allows you to add a new track to the index.
\nRequired fields can be adjusted based on your metadata template. If the defaults don't work for you, please, contact us at admin@aimsapi.com.
\nMP3, WAV and AIF(F) files are allowed. Or send a public URL for track (rather than sending file bytes), csend JSON instead of multipart/form-data.
File size limit is 120 MB.
\nAttribute \"track\" MUST be a file.
\nIf you're using Angular or Ember (and possibly other JS FE frameworks) to upload files to AIMS, be aware of a need to set the content-type header to undefined to allow the HTTP client to generate the correct multipart boundary.
\nWhen the audio file is changed, it needs to be re-added into AIMS by deleting the existing track and adding another with the same ID.
\nwhen you integrate the functionality on your end, you can use the track metadata fields any way that works for you; e.g. master_track_id to link tracks (in our app, it would point to id_client of the main track, whereas master_track_number would point to track_number of the main track on the same album
image attribute accepts JPEG, WEBP, PNG, GIF files and/or public URL as the track's artwork, it is then saved in track.thumbnails
The response returns HTTP status 201 Created on success, but the track is processed asynchronously.
There are two ways to tell if AIMS has successfully processed a track.
\nSpecify the hook_url field in the request. The processing pipeline will call this URL once it processes the track.
The hook URL must not require authentication.
\nThe content-type header for the request is always application/json.
Timeout for the hook request is 5 seconds long. The request is cancelled after this timeout. This does not have an impact on the processing status (the track will still be available even if calling the hook failed).
\nResponse from the server receiving the hook is not read, stored or processed (including its status code).
\nIf hook_url is specified and the track fails to process, it is deleted after the hook is called. If no hook_url is specified, failed tracks remain in the system to be available for status queries (see below).
The following payload (values are exemplary) is sent on success:
\n {\n \"id\": 123456789,\n \"id_client\": \"your-id\",\n \"processed_at\": \"2020-09-17T07:10:56.000000Z\",\n \"status\": \"success\"\n }\n\nIf auto-tagging is also enabled on your account, the payload also includes the tags like this:
\n {\n \"status\": \"success\",\n \"id\": 123456789,\n \"id_client\": \"your-id\",\n \"processed_at\": \"2020-09-17T07:10:56.000000Z\",\n \"auto_tagging_output\": {\n \"genres\": [\n \"rock\",\n \"nu metal\"\n ],\n \"instruments\": [\n \"electric guitar\",\n \"drums\",\n \"bass\"\n ],\n \"usages\": [\n \"sports\",\n \"action\",\n \"adventure\",\n \"trailer\"\n ],\n \"vocals\": [\n \"instrumental\"\n ],\n \"moods\": [\n \"driving\",\n \"energetic\",\n \"aggressive\",\n \"exciting\",\n \"propulsive\",\n \"dramatic\",\n \"restless\"\n ],\n \"decades\": [\n \"2010s\"\n ],\n \"key\": [\n \"D major\"\n ],\n \"tempo\": [\n \"fast\"\n ],\n \"bpm\": 160\n }\n }\n\nThe following payload (values are exemplary) is sent on failure:
\n {\n \"id\": 123456789,\n \"id_client\": \"your-id\",\n \"process_input_error\": \"The uploaded file is corrupted!\",\n \"process_input_error_details\": \"[mp3float @ 0x7f13235d2180] Header missing\\nError while decoding stream #0:0: Invalid data found when processing input\\n\",\n \"status\": \"failure\"\n }\n\nYou can call one of the get track metadata endpoints and check if process_input_error is null and processed_at contains a DateTime value. If processed_at and process_input_error are both null, the track is still pending processing.
https://api.aimsapi.com/v1/tracks
\nDefault:
\n{\n \"track\": {\n \"id\": int,\n \"id_client\": string,\n \"duration\": int,\n \"release_year\": int,\n \"track_name\": string,\n \"processed_at\": string | null,\n \"process_input_error\": string | null,\n \"store_secret\": string | null\n }\n}\n\nDetailed:
\n{\n \"track\": {\n \"id\": int,\n \"id_client\": string,\n \"duration\": int,\n \"release_year\": int,\n \"track_name\": string,\n \"processed_at\": string | null,\n \"process_input_error\": string | null,\n \"store_secret\": string | null,\n \"track_number\": string | null,\n \"track_code\": string | null,\n \"track_description\": string | null,\n \"version\": bool | null,\n \"version_tag\": string | null,\n \"version_name\": string | null,\n \"master_track_number\": string | null,\n \"isrc\": string | null,\n \"label_name\": string | null,\n \"label_code\": string | null,\n \"label_lc_name\": string | null,\n \"album_number\": string | null,\n \"album_code\": string | null,\n \"album_name\": string | null,\n \"album_description\": string | null,\n \"tempo\": string | null,\n \"bpm\": int | null,\n \"music_key\": string | null,\n \"music_meter\": string | null,\n \"lyrics\": string | null,\n \"lyrics_language\": string | null,\n \"artists\": array | null,\n \"composers\": array | null,\n \"publisher\": string | null,\n \"genres\": array | null,\n \"instruments\": array | null,\n \"moods\": array | null,\n \"music_for\": array | null,\n \"decades\": array | null,\n \"vocals\": array | null,\n \"album_keywords\": array | null,\n \"active\": bool | null,\n \"licensable\": bool | null,\n \"restricted\": bool | null,\n \"process_input_error_details\": string | null,\n \"explicit\": bool | null,\n \"profane\": bool | null,\n \"territories\": array | null,\n \"commercial\": bool | null,\n \"sync_history\": bool | null,\n \"recognisable\": bool | null,\n \"jam_sync\": bool | null,\n \"hit\": bool | null,\n \"top\": bool | null,\n \"publishing_partner_us\": array | null,\n \"publishing_partner\": array | null,\n \"share\": float | null,\n \"owner\": string | null,\n \"external_id\": string | null\n }\n}\n\nThis endpoint allows you to update metadata for existing track specified by ID.
\nYou only need to specify fields that you want to change. Other data will not be changed.
\nimage attribute accepts JPEG, WEBP, PNG, GIF files and/or public URL as the track's artwork, it is then saved in track.thumbnails
https://api.aimsapi.com/v1/tracks/system/{{id}}
\nAll fields are optional.
\nDefault:
\n{\n \"track\": {\n \"id\": int,\n \"id_client\": string,\n \"duration\": int,\n \"release_year\": int,\n \"track_name\": string,\n \"processed_at\": string | null,\n \"process_input_error\": string | null,\n \"store_secret\": string | null\n }\n}\n\nDetailed:
\n{\n \"track\": {\n \"id\": int,\n \"id_client\": string,\n \"duration\": int,\n \"release_year\": int,\n \"track_name\": string,\n \"processed_at\": string | null,\n \"process_input_error\": string | null,\n \"store_secret\": string | null,\n \"track_number\": string | null,\n \"track_code\": string | null,\n \"track_description\": string | null,\n \"version\": bool | null,\n \"version_tag\": string | null,\n \"version_name\": string | null,\n \"master_track_number\": string | null,\n \"isrc\": string | null,\n \"label_name\": string | null,\n \"label_code\": string | null,\n \"label_lc_name\": string | null,\n \"album_number\": string | null,\n \"album_code\": string | null,\n \"album_name\": string | null,\n \"album_description\": string | null,\n \"tempo\": string | null,\n \"bpm\": int | null,\n \"music_key\": string | null,\n \"music_meter\": string | null,\n \"lyrics\": string | null,\n \"lyrics_language\": string | null,\n \"artists\": array,\n \"composers\": array,\n \"publisher\": string | null,\n \"genres\": array,\n \"instruments\": array,\n \"moods\": array,\n \"music_for\": array,\n \"album_keywords\": array,\n \"active\": bool | null,\n \"licensable\": bool | null,\n \"restricted\": bool | null,\n \"commercial\": bool | null,\n \"process_input_error_details\": string | null,\n \"explicit\": bool | null,\n \"profane\": bool | null,\n \"territories\": array,\n \"decades\": array,\n \"vocals\" array\n }\n}\n\nThis endpoint allows you to update metadata for existing track specified by client ID (the ID you specify when adding a track).
\nYou only need to specify fields that you want to change. Other data will not be changed.
\nimage attribute accepts JPEG, WEBP, PNG, GIF files and/or public URL as the track's artwork, it is then saved in track.thumbnails
https://api.aimsapi.com/v1/tracks/client/{{id_client}}
\nAll fields are optional.
\nDefault:
\n{\n \"track\": {\n \"id\": int,\n \"id_client\": string,\n \"duration\": int,\n \"release_year\": int,\n \"track_name\": string,\n \"processed_at\": string | null,\n \"process_input_error\": string | null,\n \"store_secret\": string | null\n }\n}\n\nDetailed:
\n{\n \"track\": {\n \"id\": int,\n \"id_client\": string,\n \"duration\": int,\n \"release_year\": int,\n \"track_name\": string,\n \"processed_at\": string | null,\n \"process_input_error\": string | null,\n \"store_secret\": string | null,\n \"track_number\": string | null,\n \"track_code\": string | null,\n \"track_description\": string | null,\n \"version\": bool | null,\n \"version_tag\": string | null,\n \"version_name\": string | null,\n \"master_track_number\": string | null,\n \"isrc\": string | null,\n \"label_name\": string | null,\n \"label_code\": string | null,\n \"label_lc_name\": string | null,\n \"album_number\": string | null,\n \"album_code\": string | null,\n \"album_name\": string | null,\n \"album_description\": string | null,\n \"tempo\": string | null,\n \"bpm\": int | null,\n \"music_key\": string | null,\n \"music_meter\": string | null,\n \"lyrics\": string | null,\n \"lyrics_language\": string | null,\n \"artists\": array,\n \"composers\": array,\n \"publisher\": string | null,\n \"genres\": array,\n \"instruments\": array,\n \"moods\": array,\n \"music_for\": array,\n \"album_keywords\": array,\n \"active\": bool | null,\n \"licensable\": bool | null,\n \"restricted\": bool | null,\n \"commercial\": bool | null,\n \"process_input_error_details\": string | null,\n \"explicit\": bool | null,\n \"profane\": bool | null,\n \"territories\": array,\n \"decades\": array,\n \"vocals\" array\n }\n}\n\nhttps://api.aimsapi.com/v1/tracks/system/1
\n\nidstring(required) Example: 1
System ID
\n\nRESPONSE SCHEMA
\n\n\"message\": {\n \"type\": \"string\"\n }\n\nhttps://api.aimsapi.com/v1/tracks/client/1
\n\nidstring(required) Example: 1
Client ID
\n\nRESPONSE SCHEMA
\n\n \"message\": {\n \"type\": \"string\"\n}\n\nhttps://api.aimsapi.com/v1/tracks
\n{\n \"tracks\": [\n {\n \"id\": 12345,\n \"id_client\": \"CLIENT#ID\",\n \"duration\": 123,\n \"release_year\": 2019,\n \"track_name\": \"Itchy Fingers\",\n \"tags\": [\n \"T1\",\n \"T2\"\n ],\n \"processed_at\": \"2019-08-07T12:34:56.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n ...\n ],\n \"pagination\": {\n \"item_count\": 275012,\n \"page\": 1,\n \"page_size\": 100,\n \"page_count\": 2751\n }\n}\n\n...\nX-Previous-Page: https://api.aimsapi.com/v1/tracks?page=2&page_size=10\nX-Next-Page: https://api.aimsapi.com/v1/tracks?page=4&page_size=10\n...\n\nResponse contains pagination headers. Headers are only present when previous/next page is available (i.e. X-Previous-Page will not be available when listing first page of tracks and X-Next-Page will not be available when listing the last page).
https://api.aimsapi.com/v1/tracks/length
\n{\n \"length\": 275012\n}\n\nYou can now explore music catalogues using natural phrases, synch briefs, scene descriptions, or any other prompts you can think of.
\nImportant information
\nYou can use the returned query_id to send feedback to the AIMS API. See theConversionendpoint below.
Filtering is available for this endpoint. See theFilteringsection.
A 422 HTTP status code with an error message can occur if the prompt is not understood (e.g. \"Test\" or \"Nope\").
https://api.aimsapi.com/v1/query/by-text
\n\nREQUEST SCHEMA
\n\n\"text\": {\n \"type\": \"string\",\n \"description\": \"Text to search by\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"text\"\n]\n\nRESPONSE SCHEMA
\n\n\"query_id\": {\n \"type\": \"uuid\",\n \"description\": \"An ID to use to reference this query.\"\n},\n\"tracks\": {\n \"type\": \"array\",\n \"description\": \"A list of similar tracks.\"\n},\n\"required\": [\n \"query_id\",\n \"tracks\"\n]\n\nThis endpoint allows you to reuse a previously used prompt with the Prompt Search endpoint.
\nThe Prompt Serach endpoint returns an X-Hash header. You can use this value for subsequent calls for the same prompt instead of resending the prompt. Please see the example next to this endpoint for details on submitting the hash.
https://api.aimsapi.com/v1/query/by-text-hash
\n\nREQUEST SCHEMA
\n\n\"hash\": {\n \"type\": \"string\",\n \"description\": \"X-hash from previous prmpt search Header\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"text\"\n]\n\nRESPONSE SCHEMA
\n\n\"query_id\": {\n \"type\": \"uuid\",\n \"description\": \"An ID to use to reference this query.\"\n},\n\"tracks\": {\n \"type\": \"array\",\n \"description\": \"A list of similar tracks.\"\n},\n\"required\": [\n \"query_id\",\n \"tracks\"\n]\n\nYou can now explore music catalogues using natural phrases, synch briefs, scene descriptions, or any other prompts you can think of.
\nImportant information
\nquery_id to send feedback to the AIMS API. See the Conversion endpoint below.REQUEST SCHEMA
\n\ntype Seed = {\n type: \"prompt\"\n value: string // prompt to get results for\n}\ntype SearchRequest = {\n seeds: []Seed // required\n detailed?: bool // default false\n page?: int // default 1, min 1\n page_size?: int // default 20, min 1, max 1000\n highlights?: bool // default false\n filter?: Filter // see filtering\n}\n\nhttps://api.aimsapi.com/v1/searh
\n\nREQUEST SCHEMA
\n\n\"query\": {\n \"type\": \"string\",\n \"description\": \"Tag to search by\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"query\"\n]\n\nRESPONSE SCHEMA
\n\n\"action\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"search\"\n \"description\": \"Definition of the request type\"\n},\n\"aggregations\": {\n \"type\": [\"object\", \"null\"],\n \"description\": \"TBA\"\n},\n\"did_you_mean\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"tag\"\n },\n \"value\": {\n \"type\": \"string\",\n \"example\": \"electric guitar\"\n },\n \"included\": {\n \"type\": \"boolean\",\n \"example\": true\n \"description\": \"Suggestions based on the searched text\"\n},\n\"query_id\": {\n \"type\": \"string\",\n \"example\": \"9fdd4e6d-b656-42b5-a42f-79e83c6c0d49\"\n },\n\"totals\": {\n \"type\": \"object\",\n \"properties\": {\n \"tracks\": {\n \"type\": \"object\",\n \"properties\": {\n \"relation\": {\n \"type\": \"string\",\n \"example\": \"gte\"\n },\n \"value\": {\n \"type\": \"integer\",\n \"example\": 10000\n }\n\"tracks\": {\n \"type\": \"array\"\n\"required\": [\n \"action\",\n \"aggregations\"\n \"did_you_mean\",\n \"totals\",\n \"query_id\",\n \"tracks\"\n]\n\nhttps://api.aimsapi.com/v1/searh
\n\nREQUEST SCHEMA
\n\n\"query\": {\n \"type\": \"string\",\n \"description\": \"Full-text to search by\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"query\"\n]\n\nRESPONSE SCHEMA
\n\n\"action\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"search\"\n \"description\": \"Definition of the request type\"\n},\n\"aggregations\": {\n \"type\": [\"object\", \"null\"],\n \"description\": \"TBA\"\n},\n\"did_you_mean\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"tag\"\n },\n \"value\": {\n \"type\": \"string\",\n \"example\": \"electric guitar\"\n },\n \"included\": {\n \"type\": \"boolean\",\n \"example\": true\n \"description\": \"Suggestions based on the searched text\"\n},\n\"query_id\": {\n \"type\": \"string\",\n \"example\": \"9fdd4e6d-b656-42b5-a42f-79e83c6c0d49\"\n },\n\"totals\": {\n \"type\": \"object\",\n \"properties\": {\n \"tracks\": {\n \"type\": \"object\",\n \"properties\": {\n \"relation\": {\n \"type\": \"string\",\n \"example\": \"gte\"\n },\n \"value\": {\n \"type\": \"integer\",\n \"example\": 10000\n }\n\"tracks\": {\n \"type\": \"array\"\n\"required\": [\n \"action\",\n \"aggregations\"\n \"did_you_mean\",\n \"totals\",\n \"query_id\",\n \"tracks\"\n]\n\nhttps://api.aimsapi.com/v1/searh
\n\nREQUEST SCHEMA
\n\n\"query\": {\n \"type\": \"string\",\n \"description\": \"Keyword(s) to search by\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"query\"\n]\n\nRESPONSE SCHEMA
\n\n\"action\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"search\"\n \"description\": \"Definition of the request type\"\n},\n\"aggregations\": {\n \"type\": [\"object\", \"null\"],\n \"description\": \"TBA\"\n},\n\"did_you_mean\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"tag\"\n },\n \"value\": {\n \"type\": \"string\",\n \"example\": \"electric guitar\"\n },\n \"included\": {\n \"type\": \"boolean\",\n \"example\": true\n \"description\": \"Suggestions based on the searched text\"\n},\n\"query_id\": {\n \"type\": \"string\",\n \"example\": \"9fdd4e6d-b656-42b5-a42f-79e83c6c0d49\"\n },\n\"totals\": {\n \"type\": \"object\",\n \"properties\": {\n \"tracks\": {\n \"type\": \"object\",\n \"properties\": {\n \"relation\": {\n \"type\": \"string\",\n \"example\": \"gte\"\n },\n \"value\": {\n \"type\": \"integer\",\n \"example\": 10000\n }\n\"tracks\": {\n \"type\": \"array\"\n\"required\": [\n \"action\",\n \"aggregations\"\n \"did_you_mean\",\n \"totals\",\n \"query_id\",\n \"tracks\"\n]\n\nYou can use album code to search similar albums within your library.
\nhttps://api.aimsapi.com/v1/searh
\n\nREQUEST SCHEMA
\n\n\"query\": {\n \"type\": \"string\",\n \"description\": \"Album code to search by\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"query\"\n]\n\nRESPONSE SCHEMA
\n\n\"action\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"search\"\n \"description\": \"Definition of the request type\"\n},\n\"aggregations\": {\n \"type\": [\"object\", \"null\"],\n \"description\": \"TBA\"\n},\n\"did_you_mean\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"tag\"\n },\n \"value\": {\n \"type\": \"string\",\n \"example\": \"electric guitar\"\n },\n \"included\": {\n \"type\": \"boolean\",\n \"example\": true\n \"description\": \"Suggestions based on the searched text\"\n},\n\"query_id\": {\n \"type\": \"string\",\n \"example\": \"9fdd4e6d-b656-42b5-a42f-79e83c6c0d49\"\n },\n\"totals\": {\n \"type\": \"object\",\n \"properties\": {\n \"tracks\": {\n \"type\": \"object\",\n \"properties\": {\n \"relation\": {\n \"type\": \"string\",\n \"example\": \"gte\"\n },\n \"value\": {\n \"type\": \"integer\",\n \"example\": 10000\n }\n\"tracks\": {\n \"type\": \"array\"\n\"required\": [\n \"action\",\n \"aggregations\"\n \"did_you_mean\",\n \"totals\",\n \"query_id\",\n \"tracks\"\n]\n\nYou can use numeric value to search. E.g. release year (or range).
\nhttps://api.aimsapi.com/v1/searh
\n\nREQUEST SCHEMA
\n\n\"query\": {\n \"type\": \"string\",\n \"description\": \"Number to search by\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"query\"\n]\n\nRESPONSE SCHEMA
\n\n\"action\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"search\"\n \"description\": \"Definition of the request type\"\n},\n\"aggregations\": {\n \"type\": [\"object\", \"null\"],\n \"description\": \"TBA\"\n},\n\"did_you_mean\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"tag\"\n },\n \"value\": {\n \"type\": \"string\",\n \"example\": \"electric guitar\"\n },\n \"included\": {\n \"type\": \"boolean\",\n \"example\": true\n \"description\": \"Suggestions based on the searched text\"\n},\n\"query_id\": {\n \"type\": \"string\",\n \"example\": \"9fdd4e6d-b656-42b5-a42f-79e83c6c0d49\"\n },\n\"totals\": {\n \"type\": \"object\",\n \"properties\": {\n \"tracks\": {\n \"type\": \"object\",\n \"properties\": {\n \"relation\": {\n \"type\": \"string\",\n \"example\": \"gte\"\n },\n \"value\": {\n \"type\": \"integer\",\n \"example\": 10000\n }\n\"tracks\": {\n \"type\": \"array\"\n\"required\": [\n \"action\",\n \"aggregations\"\n \"did_you_mean\",\n \"totals\",\n \"query_id\",\n \"tracks\"\n]\n\nYou can use the exact track ID to search.
\nhttps://api.aimsapi.com/v1/searh
\n\nREQUEST SCHEMA
\n\n\"query\": {\n \"type\": \"string\",\n \"description\": \"Track ID to search by\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"query\"\n]\n\nRESPONSE SCHEMA
\n\n\"action\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"search\"\n \"description\": \"Definition of the request type\"\n},\n\"aggregations\": {\n \"type\": [\"object\", \"null\"],\n \"description\": \"TBA\"\n},\n\"did_you_mean\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"tag\"\n },\n \"value\": {\n \"type\": \"string\",\n \"example\": \"electric guitar\"\n },\n \"included\": {\n \"type\": \"boolean\",\n \"example\": true\n \"description\": \"Suggestions based on the searched text\"\n},\n\"query_id\": {\n \"type\": \"string\",\n \"example\": \"9fdd4e6d-b656-42b5-a42f-79e83c6c0d49\"\n },\n\"totals\": {\n \"type\": \"object\",\n \"properties\": {\n \"tracks\": {\n \"type\": \"object\",\n \"properties\": {\n \"relation\": {\n \"type\": \"string\",\n \"example\": \"gte\"\n },\n \"value\": {\n \"type\": \"integer\",\n \"example\": 10000\n }\n\"tracks\": {\n \"type\": \"array\"\n\"required\": [\n \"action\",\n \"aggregations\"\n \"did_you_mean\",\n \"totals\",\n \"query_id\",\n \"tracks\"\n]\n\nYou can use the exact track ID to search and also refine the search with your own words.
\nhttps://api.aimsapi.com/v1/searh
\n\nREQUEST SCHEMA
\n\n\"query\": {\n \"type\": \"string\",\n \"description\": \"Track ID + text to search by\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"query\"\n]\n\nRESPONSE SCHEMA
\n\n\"action\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"search\"\n \"description\": \"Definition of the request type\"\n},\n\"aggregations\": {\n \"type\": [\"object\", \"null\"],\n \"description\": \"TBA\"\n},\n\"did_you_mean\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"tag\"\n },\n \"value\": {\n \"type\": \"string\",\n \"example\": \"electric guitar\"\n },\n \"included\": {\n \"type\": \"boolean\",\n \"example\": true\n \"description\": \"Suggestions based on the searched text\"\n},\n\"query_id\": {\n \"type\": \"string\",\n \"example\": \"9fdd4e6d-b656-42b5-a42f-79e83c6c0d49\"\n },\n\"totals\": {\n \"type\": \"object\",\n \"properties\": {\n \"tracks\": {\n \"type\": \"object\",\n \"properties\": {\n \"relation\": {\n \"type\": \"string\",\n \"example\": \"gte\"\n },\n \"value\": {\n \"type\": \"integer\",\n \"example\": 10000\n }\n\"tracks\": {\n \"type\": \"array\"\n\"required\": [\n \"action\",\n \"aggregations\"\n \"did_you_mean\",\n \"totals\",\n \"query_id\",\n \"tracks\"\n]\n\nYou can use a prompt to search by.
\nhttps://api.aimsapi.com/v1/searh
\n\nREQUEST SCHEMA
\n\n\"query\": {\n \"type\": \"string\",\n \"description\": \"Text prompt to search by\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"query\"\n]\n\nRESPONSE SCHEMA
\n\n\"action\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"search\"\n \"description\": \"Definition of the request type\"\n},\n\"aggregations\": {\n \"type\": [\"object\", \"null\"],\n \"description\": \"TBA\"\n},\n\"did_you_mean\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"tag\"\n },\n \"value\": {\n \"type\": \"string\",\n \"example\": \"electric guitar\"\n },\n \"included\": {\n \"type\": \"boolean\",\n \"example\": true\n \"description\": \"Suggestions based on the searched text\"\n},\n\"query_id\": {\n \"type\": \"string\",\n \"example\": \"9fdd4e6d-b656-42b5-a42f-79e83c6c0d49\"\n },\n\"totals\": {\n \"type\": \"object\",\n \"properties\": {\n \"tracks\": {\n \"type\": \"object\",\n \"properties\": {\n \"relation\": {\n \"type\": \"string\",\n \"example\": \"gte\"\n },\n \"value\": {\n \"type\": \"integer\",\n \"example\": 10000\n }\n\"tracks\": {\n \"type\": \"array\"\n\"required\": [\n \"action\",\n \"aggregations\"\n \"did_you_mean\",\n \"totals\",\n \"query_id\",\n \"tracks\"\n]\n\nYou can use an URL to search by.
\nhttps://api.aimsapi.com/v1/searh
\n\nREQUEST SCHEMA
\n\n\"query\": {\n \"type\": \"string\",\n \"description\": \"URL to search by\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"query\"\n]\n\nRESPONSE SCHEMA
\n\n\"action\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"search\"\n \"description\": \"Definition of the request type\"\n},\n\"aggregations\": {\n \"type\": [\"object\", \"null\"],\n \"description\": \"TBA\"\n},\n\"did_you_mean\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"type\": {\n \"type\": \"string\",\n \"example\": \"tag\"\n },\n \"value\": {\n \"type\": \"string\",\n \"example\": \"electric guitar\"\n },\n \"included\": {\n \"type\": \"boolean\",\n \"example\": true\n \"description\": \"Suggestions based on the searched text\"\n},\n\"query_id\": {\n \"type\": \"string\",\n \"example\": \"9fdd4e6d-b656-42b5-a42f-79e83c6c0d49\"\n },\n\"totals\": {\n \"type\": \"object\",\n \"properties\": {\n \"tracks\": {\n \"type\": \"object\",\n \"properties\": {\n \"relation\": {\n \"type\": \"string\",\n \"example\": \"gte\"\n },\n \"value\": {\n \"type\": \"integer\",\n \"example\": 10000\n }\n\"tracks\": {\n \"type\": \"array\"\n\"required\": [\n \"action\",\n \"aggregations\"\n \"did_you_mean\",\n \"totals\",\n \"query_id\",\n \"tracks\"\n]\n\nThis endpoint is used to retrieve autocomplete suggestions based on the provided query.
\nhttps://api.aimsapi.com/v1/autocomplete
\n\nREQUEST SCHEMA
\n\n\"query\": {\n \"type\": \"string\",\n \"description\": \"Text input for autocomplete suggestions\"\n},\n\"required\": [\n \"query\"\n]\n\nRESPONSE SCHEMA
\n\n{\n \"type\": \"object\",\n \"properties\": {\n \"suggestions\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"value\": {\n \"type\": \"string\",\n \"description\": \"The value of the suggestion, representing a keyword or tag.\"\n },\n \"type\": {\n \"type\": \"string\",\n \"enum\": [\"tag\", \"track\", \"album\", \"other\"],\n \"description\": \"The type of the suggestion, indicating its nature or category.\"\n },\n \"field\": {\n \"type\": \"string\",\n \"description\": \"The field associated with the suggestion (e.g. track_name, album_name, etc). If none, the value is 'none'.\"\n },\n \"id\": {\n \"type\": \"string\",\n \"description\": \"A unique identifier for the suggestion.\"\n },\n \"multiple\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether multiple selections are allowed for this suggestion.\"\n }\n }\n }\n }\n },\n \"required\": [\"suggestions\"]\n}\n\nThis endpoint is used to retrieve prompt suggestions based on the provided query.
\nhttps://api.aimsapi.com/v1/autocomplete
\n\nREQUEST SCHEMA
\n\n\"query\": {\n \"type\": \"string\",\n \"description\": \"Text input for autocomplete suggestions\"\n},\n\"required\": [\n \"query\"\n]\n\nRESPONSE SCHEMA
\n\n{\n \"type\": \"object\",\n \"properties\": {\n \"suggestions\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"value\": {\n \"type\": \"string\",\n \"description\": \"The value of the suggestion, typically a prompt or descriptive phrase.\"\n },\n \"type\": {\n \"type\": \"string\",\n \"enum\": [\"prompt\"],\n \"description\": \"The type of the suggestion, indicating its nature. In this case, it is a prompt.\"\n },\n \"field\": {\n \"type\": \"string\",\n \"description\": \"The field associated with the suggestion. If none, the value is 'none'.\"\n },\n \"id\": {\n \"type\": \"string\",\n \"description\": \"A unique identifier for the suggestion. Can be an empty string if not provided. (in cas of prompt-suggestions)\"\n },\n \"multiple\": {\n \"type\": \"boolean\",\n \"description\": \"Indicates whether multiple selections are allowed for this suggestion.\"\n }\n },\n \"required\": [\"value\", \"type\", \"field\", \"id\", \"multiple\"]\n }\n },\n \"totals\": {\n \"type\": \"object\",\n \"description\": \"TBA\"\n }\n },\n \"required\": [\"suggestions\", \"totals\"]\n}\n\n\nThis endpoint allows you to upload a video file
\nRequest Body
\nThe request should be sent with form-data as the request body type. It must include a key \"file\" with the supported video file to be uploaded (MOV, MPEG, MP4, AVI).
\nResponse
\nThe response will include the status of the upload operation and a video hash that is used in the Search endpoint!
\n","urlObject":{"path":["v1","upload"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"07e6cb51-72f3-40e4-9ef9-b8fb1f9d9faf","name":"Upload a video file (not-cached yet)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"multipart/form-data"},{"key":"Authorization","value":"123abc"},{"key":"X-User-Id","value":"userId"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":"v7-pcrcHP/test.mp3"}]},"url":"https://api.aimsapi.com/v1/upload"},"_postman_previewlanguage":"json","header":[{"description":{"content":"","type":"text/plain"},"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"new\",\n \"message\": \"video has been processed and is ready\",\n \"hash\": \"7548e737cfb975669992c694edb086f9\"\n}"},{"id":"b4819e58-c820-41a1-8f4a-167fe23b1f5f","name":"Upload a video file (not-cached yet)","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":"v7-pcrcHP/test.mp3"}]},"url":"https://api.aimsapi.com/v1/upload"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"cached\",\n \"message\": \"video is already cached\",\n \"hash\": \"c09bbf7a42e063e2e1fd4b9b9eac89c4\"\n}"}],"_postman_id":"a68074ab-f58d-4314-b07b-53eaac6a2759"},{"name":"Search by video hash","id":"db99099f-3cb4-4b96-bf77-464d38ee6403","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"seeds\": [\n\t\t{\n\t\t\t\"type\": \"video\",\n\t\t\t\"value\": \"c09bbf7a42e063e2e1fd4b9b9eac89c4\"\n\t\t}\n\t],\n\t\"detailed\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/search","description":"The request body should be formatted as a JSON object with an array of \"seeds\", where the seed contains a \"type\" : \"video\" and a \"value\" : [video hash] that you must obtain from the previous API request to successfully execute the search.
Additionally, the \"detailed\" parameter can be set to true to request detailed information in the response.
The response of this request is in JSON format (see the example), and contains a list of track results (\"tracks\":[...] and additional response info: type of an API request action, search suggestions (\"did_you_mean\"), query_id which refers to a unique UUID of the search API request, etc.
The request body should be formatted as a JSON object with an array of \"seeds\", where the seed contains a \"type\" : \"video\" and a \"value\" : [Youtube URL].
\nAdditionally, the \"detailed\" parameter can be set to true to request detailed information in the response.
\nThe response of this request is in JSON format (see the example), and contains a list of track results (\"tracks\":[...] and additional response info: type of an API request action, search suggestions (\"did_you_mean\"), query_id which refers to a unique UUID of the search API request, etc.
For more information about filtering.
\nSee the API request example for the filtering structure.
\nThe same filtering structure applies for the Search by a Youtube link endpoint.
\n","urlObject":{"path":["v1","search"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"ea22a099-3ef8-4f46-b5ba-2e4b93d342f0","name":"Search by video hash (with filters)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"123abc"},{"key":"X-User-Id","value":"userId"}],"body":{"mode":"raw","raw":"{\n \"seeds\": [\n {\n \"type\": \"video\",\n \"value\": \"c09bbf7a42e063e2e1fd4b9b9eac89c4\"\n }\n ],\n \"detailed\": true,\n \"filter\": {\n \"logic\": \"and\",\n \"conditions\": [\n {\n \"field\": \"instruments\",\n \"operator\": \"contains\",\n \"value\": \"Gregorian Chant\"\n }\n ]\n },\n \"page\": 1,\n \"page_size\": 20\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/search"},"_postman_previewlanguage":"json","header":[{"description":{"content":"","type":"text/plain"},"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"action\": {\n \"type\": \"search\"\n },\n \"aggregations\": null,\n \"did_you_mean\": [\n {\n \"type\": \"video\",\n \"value\": \"c09bbf7a42e063e2e1gg4b9b9eac89c4\",\n \"included\": true\n }\n ],\n \"query_id\": \"efb75ffa-2754-443a-839a-5b5017aff802\",\n \"totals\": {\n \"tracks\": {\n \"relation\": \"gte\",\n \"value\": 10000\n }\n },\n \"tracks\": [\n {\n \"instruments\": [\n \"vocals\",\n \"gregorian chant\",\n \"woodwind\",\n \"flute\",\n \"synthesizer\"\n ],\n \"genres\": [\n \"world\",\n \"traditional\"\n ],\n \"auto_tagging_output\": {\n ...\n },\n ...\n },\n ...\n {\n ... \n }\n ],\n \"type\": \"seeds-only\"\n}"}],"_postman_id":"cc5f7b6a-19c4-4df5-8a58-c944044d7100"}],"id":"2fa8a5fc-faf3-4053-862e-742febae05b9","_postman_id":"2fa8a5fc-faf3-4053-862e-742febae05b9","description":""}],"id":"f2f7daea-543f-4192-a021-481325a2c30f","_postman_id":"f2f7daea-543f-4192-a021-481325a2c30f","description":""},{"name":"Spaces","item":[{"name":"Create a Workspace","id":"00ef137c-9b09-4f53-a8df-6e13ce15f8e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"prompt\": \"Daily Soap. Music designed to build tension towards a dramatic reveal, a shocking discovery, or a suspenseful cliffhanger ending a scene or episode. Keywords: building, suspenseful, tense, dramatic, ominous, unresolved, impactful, foreboding, urgent ,reveal\",\n\t\"collections\": 10,\n \"tracks_per_collection\": 10,\n \"filter\": {\n \"logic\": \"and\",\n \"conditions\": [\n { \n \"field\": \"genres\",\n \"operator\": \"in\",\n \"value\": [\"electronica\", \"rhythmic underscores\"]\n }\n ]\n },\n\t\"detailed\": false,\n \"show_filter\": true,\n \"show_tracks\": true\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/spaces","description":"This endpoint lets you create a Workspace using a natural-language text prompt. It returns projects — each containing a number of tracks — as specified by collections and tracks_per_collection in the request body. Other optional parameters that can be passed in the API request body are show_tracks(to control whether the API response contains tracks), show_filter (to control whether the API response contains filtering conditions) and filter (to control add filtering criteria); see the example below.
You can use the returned project IDs and keys in subsequent API requests.
\nREQUEST ACHEMA:
\n{\n \"prompt\": {\n \"type\": \"string\",\n \"minLength\": 1,\n \"description\": \"Natural-language text prompt describing the desired music.\"\n },\n \"collections\": {\n \"type\": \"integer\",\n \"description\": \"Number of project collections to create.\"\n },\n \"tracks_per_collection\": {\n \"type\": \"integer\",\n \"description\": \"Number of tracks per project collection.\"\n },\n \"detailed\": {\n \"type\": \"boolean\",\n \"default\": false,\n \"description\": \"When true, returns more verbose/detailed track metadata.\"\n },\n \"show_filter\": {\n \"type\": \"boolean\",\n \"default\": false,\n \"description\": \"When true, returns saved filtering criteria for each collection.\"\n },\n \"show_tracks\": {\n \"type\": \"boolean\",\n \"default\": false,\n \"description\": \"When true, returns tracks for each collection within the Space.\"\n }\n}\n\nRESPONSE SCHEMA:
\n{\n \"id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"description\": \"Unique identifier for the created Space.\"\n },\n \"prompt\": {\n \"type\": \"string\",\n \"description\": \"The original prompt used to generate the collections.\"\n },\n \"title\": {\n \"type\": \"string\",\n \"description\": \"Title derived from the prompt.\"\n },\n \"tracks_per_collection\": {\n \"type\": \"integer\",\n \"description\": \"Number of tracks included per collection.\"\n },\n \"created_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the Space was created.\"\n },\n \"updated_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the Space was last updated.\"\n },\n \"active\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the collection is currently active.\"\n },\n \"collections\": {\n \"type\": \"array\",\n \"description\": \"List of generated collections.\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"description\": \"Unique identifier for the collection.\"\n },\n \"key\": {\n \"type\": \"string\",\n \"description\": \"Unique identifier for the collection.\"\n },\n ...\n ...\n \"filter\": {\n \"type\": \"object\",\n \"description\": \"Filter criteria applied when sourcing tracks for this collection.\",\n \"properties\": {\n \"logic\": {\n \"type\": \"string\",\n \"description\": \"Logical operator applied across filter conditions (e.g. 'and').\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"description\": \"List of individual filter conditions.\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"field\": {\n \"type\": \"string\",\n \"description\": \"Track field to filter on (e.g. 'genres').\"\n },\n \"operator\": {\n \"type\": \"string\",\n \"description\": \"Filter operator (e.g. 'in').\"\n },\n \"value\": {\n \"type\": \"array\",\n \"description\": \"List of accepted values for the filter field.\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n }\n },\n ...\n ...\n \"tracks\": {\n \"type\": \"array\",\n \"description\": \"List of tracks included in this collection.\"\n }\n }\n }\n }\n}\n\nThis endpoint lets you update Workspace metadata and the order of collections in a Space (using collection_order; You can change the order of collections by changing their position in the array.).
Use Space ID obtained from the previous API request instead of the \"space.id\" placeholder in the URL path.
\nOptional parameters that can be passed in the API request body are detailed (to control whether the API response contains additional metadata), show_filter (to control whether the API response contains filtering conditions).
REQUEST ACHEMA:
\n{\n \"title\": {\n \"type\": \"string\",\n \"description\": \"Update title for the collection.\"\n },\n \"active\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the collection is active.\"\n },\n \"collection_order\": {\n \"type\": \"array\",\n \"description\": \"List of collections within the Space. You can change the order of collections by changing their position in the array.\"\n }\n}\n\nRESPONSE SCHEMA:
\n{\n \"id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"description\": \"Unique identifier for this Space\"\n },\n \"prompt\": {\n \"type\": \"string\",\n \"description\": \"The original prompt used to generate the collections.\"\n },\n \"title\": {\n \"type\": \"string\",\n \"description\": \"Display title for the Collection.\"\n },\n \"active\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the collection is currently active.\"\n },\n \"tracks_per_collection\": {\n \"type\": \"integer\",\n \"description\": \"Maximum number of tracks included per collection.\"\n },\n \"created_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the generation request was created.\"\n },\n \"updated_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the generation request was last updated.\"\n },\n \"collections\": {\n \"type\": \"array\",\n \"description\": \"Ordered list of collections associated with this Space.\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"description\": \"Unique identifier of the collection. Can be used in subsequent API requests.\"\n }\n }\n }\n }\n}\n\nThis endpoint retrieves Space data. Use your Space ID instead of the \"space.id\" placeholder in the URL path and the detailed query parameter to control the verbosity of metadata returned. The response includes tracks that belong to the collection with full metadata when show_tracks=true as well as filtering informtation when show_filter=true
REQUEST:
\nGET /v1/spaces/space.id?detailed={boolean}&show_filter={boolean}&show_tracks={boolean}
Headers
\nPath Parameters
\njson
\n{\n \"spaceId\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"required\": true,\n \"description\": \"The Space ID returned from the Create Workspace endpoint.\"\n }\n}\n\nRESPONSE SCHEMA:
\n{\n \"id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"description\": \"Unique identifier for the created Space.\"\n },\n \"prompt\": {\n \"type\": \"string\",\n \"description\": \"The original prompt used to generate the collections.\"\n },\n \"title\": {\n \"type\": \"string\",\n \"description\": \"Title derived from the prompt.\"\n },\n \"tracks_per_collection\": {\n \"type\": \"integer\",\n \"description\": \"Number of tracks included per collection.\"\n },\n \"created_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the Space was created.\"\n },\n \"updated_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the Space was last updated.\"\n },\n \"active\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the collection is currently active.\"\n },\n \"collections\": {\n \"type\": \"array\",\n \"description\": \"List of generated collections.\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"description\": \"Unique identifier for the collection.\"\n },\n \"key\": {\n \"type\": \"string\",\n \"description\": \"Unique identifier for the collection.\"\n },\n ...\n ...\n \"filter\": {\n \"type\": \"object\",\n \"description\": \"Filter criteria applied when sourcing tracks for this collection.\",\n \"properties\": {\n \"logic\": {\n \"type\": \"string\",\n \"description\": \"Logical operator applied across filter conditions (e.g. 'and').\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"description\": \"List of individual filter conditions.\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"field\": {\n \"type\": \"string\",\n \"description\": \"Track field to filter on (e.g. 'genres').\"\n },\n \"operator\": {\n \"type\": \"string\",\n \"description\": \"Filter operator (e.g. 'in').\"\n },\n \"value\": {\n \"type\": \"array\",\n \"description\": \"List of accepted values for the filter field.\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n }\n },\n ...\n ...\n \"tracks\": {\n \"type\": \"array\",\n \"description\": \"List of tracks included in this collection.\"\n }\n }\n }\n }\n}\n\nNote: The track object contains many additional metadata fields (genres, tags, territories, music_for, release_year, isrc, etc.) not fully listed here. Set detailed=false to receive a lighter response.
This endpoint retrieves all Spaces within an API account. Use the detailed query parameter to control the verbosity of metadata returned. The response includes pagination information and list of all Spaces as an array of JSON objects (see the response schema).
REQUEST:
\nGET /v1/spaces?page=1&page_size=999&detailed={boolean}
Headers
\nRESPONSE SCHEMA:
\n{\n \"pagination\": {\n \"type\": \"object\",\n \"description\": \"Pagination metadata for the response.\",\n \"properties\": {\n \"item_count\": {\n \"type\": \"integer\",\n \"description\": \"Total number of items across all pages.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Current page number.\"\n },\n \"page_count\": {\n \"type\": \"integer\",\n \"description\": \"Total number of pages available.\"\n },\n \"page_size\": {\n \"type\": \"integer\",\n \"description\": \"Maximum number of items returned per page.\"\n }\n }\n },\n \"spaces\": {\n \"type\": \"array\",\n \"description\": \"List of Saces matching the API accouont and query.\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"description\": \"Unique identifier for the space. Can be used in subsequent API requests.\"\n },\n \"prompt\": {\n \"type\": \"string\",\n \"description\": \"The original prompt used to generate the space's collections.\"\n },\n \"title\": {\n \"type\": \"string\",\n \"description\": \"Title for the space.\"\n },\n \"active\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the space is currently active.\"\n },\n \"tracks_per_collection\": {\n \"type\": \"integer\",\n \"description\": \"Maximum number of tracks included per collections within the space.\"\n },\n \"created_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the space was created.\"\n },\n \"updated_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the space was last updated.\"\n }\n }\n }\n }\n}\n\nThis endpoint retrieves tracks belonging to a specific project by its ID. The project ID is obtained from the response of the Create Workspace endpoint. Use the detailed query parameter to control the verbosity of track metadata returned. The response includes paginated track results with full metadata when detailed=true.
REQUEST:
\nGET /v1/project/get-tracks/by-id/{projectId}?detailed={boolean}
Headers
\nPath Parameters
\njson
\n{\n \"projectId\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"required\": true,\n \"description\": \"The project ID returned from the Create Workspace endpoint.\"\n }\n}\n\nRESPONSE SCHEMA:
\n{\n \"pagination\": {\n \"type\": \"object\",\n \"description\": \"Pagination metadata for the track results.\",\n \"properties\": {\n \"item_count\": {\n \"type\": \"integer\",\n \"description\": \"Total number of tracks in this page.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"description\": \"Current page number.\"\n },\n \"page_count\": {\n \"type\": \"integer\",\n \"description\": \"Total number of pages available.\"\n },\n \"page_size\": {\n \"type\": \"integer\",\n \"description\": \"Maximum number of tracks per page.\"\n }\n }\n },\n \"tracks\": {\n \"type\": \"array\",\n \"description\": \"List of tracks belonging to the project.\",\n \"items\": {\n \"type\": \"object\",\n \"description\": \"Track object. Contains extensive metadata when detailed=true. Key properties listed below.\",\n \"properties\": {\n \"id\": {\n \"type\": \"integer\",\n \"description\": \"Unique track identifier.\"\n },\n \"id_client\": {\n \"type\": \"string\",\n \"description\": \"Client-facing track identifier.\"\n },\n \"track_name\": {\n \"type\": \"string\",\n \"description\": \"Track title or filename.\"\n },\n \"track_description\": {\n \"type\": [\"string\", \"null\"],\n \"description\": \"Human-readable description of the track's sound and style.\"\n },\n \"duration\": {\n \"type\": \"integer\",\n \"description\": \"Track duration in seconds.\"\n },\n \"bpm\": {\n \"type\": [\"integer\", \"null\"],\n \"description\": \"Beats per minute.\"\n },\n \"artists\": {\n \"type\": \"array\",\n \"items\": { \"type\": \"string\" },\n \"description\": \"List of performing artists.\"\n },\n \"composers\": {\n \"type\": \"array\",\n \"items\": { \"type\": \"string\" },\n \"description\": \"List of composers.\"\n },\n \"moods\": {\n \"type\": \"array\",\n \"items\": { \"type\": \"string\" },\n \"description\": \"Mood tags (e.g. 'chill', 'ambient', 'romantic').\"\n },\n \"instruments\": {\n \"type\": \"array\",\n \"items\": { \"type\": \"string\" },\n \"description\": \"Instruments present in the track.\"\n },\n \"vocals\": {\n \"type\": \"array\",\n \"items\": { \"type\": \"string\" },\n \"description\": \"Vocal type (e.g. 'vocal', 'instrumental').\"\n },\n \"album_name\": {\n \"type\": [\"string\", \"null\"],\n \"description\": \"Parent album name.\"\n },\n \"album_code\": {\n \"type\": [\"string\", \"null\"],\n \"description\": \"Parent album code.\"\n },\n \"label_name\": {\n \"type\": [\"string\", \"null\"],\n \"description\": \"Music label name.\"\n },\n \"processed_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the track was processed.\"\n },\n \"net_duration\": {\n \"type\": [\"object\", \"null\"],\n \"description\": \"Detailed duration breakdown including fade-in/out points and net duration. Available when detailed=true.\"\n },\n \"thumbnails\": {\n \"type\": \"array\",\n \"description\": \"Artwork thumbnails in various sizes.\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"path\": { \"type\": \"string\", \"description\": \"CDN URL of the thumbnail.\" },\n \"size\": { \"type\": \"string\", \"description\": \"Dimensions (e.g. '80x80', '600x600').\" }\n }\n }\n }\n }\n }\n }\n}\n\nNote: The track object contains many additional metadata fields (genres, tags, territories, music_for, release_year, isrc, etc.) not fully listed here. Set detailed=false to receive a lighter response.
Same functionality as the GET Tracks in a Project by ID, but instead of project.id we must use project.key when referencing a collection.
Path Parameters
\njson
\n{\n \"projectKey\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"required\": true,\n \"description\": \"The project key returned from the Create Workspace endpoint.\"\n }\n}\n\nThis endpoint suggests tracks similar to an existing project, identified by its key. The project key is obtained from the response of the Create Workspace endpoint. Use this to discover additional tracks that match the sonic and stylistic profile of a given project. The response includes paginated track results. Use the detailed query parameter to control the verbosity of track metadata returned.
REQUEST SCHEMA:
\n{\n \"key\": {\n \"type\": \"string\",\n \"required\": true,\n \"description\": \"The project key returned from the Create Workspace endpoint.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"minimum\": 1,\n \"default\": 1,\n \"description\": \"Page number for paginated results.\"\n },\n \"page_size\": {\n \"type\": \"integer\",\n \"minimum\": 1,\n \"description\": \"Number of tracks to return per page.\"\n }\n}\n\nRESPONSE SCHEMA:
\n{\n \"query_id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"example\": \"queryId\",\n \"description\": \"Unique identifier for this suggestion query.\"\n },\n \"totals\": {\n \"type\": \"object\",\n \"description\": \"Total counts for returned result types.\",\n \"properties\": {\n \"tracks\": {\n \"type\": \"object\",\n \"properties\": {\n \"relation\": {\n \"type\": \"string\",\n \"description\": \"Relation operator for the total count (e.g. 'eq' for exact, 'gte' for at least).\"\n },\n \"value\": {\n \"type\": \"integer\",\n \"description\": \"Total number of matching tracks.\"\n }\n }\n }\n }\n },\n \"tracks\": {\n \"type\": \"array\",\n \"description\": \"List of suggested tracks similar to the project.\",\n \"items\": {\n \"type\": \"object\",\n \"description\": \"Track object with full metadata.\"\n }\n }\n}\n\nNote: The track object contains many additional metadata fields (tags, territories, music_for, release_year, isrc, etc.) not fully listed here. Set detailed=true to receive a lighter response.
Same as the previous endpoint this one suggests tracks similar to an existing project, identified by its ID. The project ID is obtained from the response of the Create Workspace endpoint. Use the detailed query parameter to control the verbosity of track metadata returned.
REQUEST SCHEMA:
\n{\n \"id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"required\": true,\n \"description\": \"The project ID returned from the Create Workspace endpoint.\"\n },\n \"page\": {\n \"type\": \"integer\",\n \"minimum\": 1,\n \"default\": 1,\n \"description\": \"Page number for paginated results.\"\n },\n \"page_size\": {\n \"type\": \"integer\",\n \"minimum\": 1,\n \"description\": \"Number of tracks to return per page.\"\n }\n}\n\nRESPONSE SCHEMA:
\n{\n \"query_id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"example\": \"queryId\",\n \"description\": \"Unique identifier for this suggestion query.\"\n },\n \"totals\": {\n \"type\": \"object\",\n \"description\": \"Total counts for returned result types.\",\n \"properties\": {\n \"tracks\": {\n \"type\": \"object\",\n \"properties\": {\n \"relation\": {\n \"type\": \"string\",\n \"description\": \"Relation operator for the total count (e.g. 'eq' for exact, 'gte' for at least).\"\n },\n \"value\": {\n \"type\": \"integer\",\n \"description\": \"Total number of matching tracks.\"\n }\n }\n }\n }\n },\n \"tracks\": {\n \"type\": \"array\",\n \"description\": \"List of suggested tracks similar to the project.\",\n \"items\": {\n \"type\": \"object\",\n \"description\": \"Track object with full metadata.\"\n }\n }\n}\n\nNote: The track object contains many additional metadata fields (tags, territories, music_for, release_year, isrc, etc.) not fully listed here. Set detailed=true to receive a lighter response.
This endpoint retrieves detailed information about multiple projects in a single request, identified by their IDs. Project IDs are obtained from the response of the Create Workspace endpoint. Each returned project includes metadata such as its title, description, keywords, and optionally its full list of tracks. Use show_tracks to control whether tracks are included, and detailed to control the verbosity of track metadata.
REQUEST SCHEMA:
\n{\n \"collection_ids\": {\n \"type\": \"array\",\n \"required\": true,\n \"items\": { \"type\": \"string\", \"format\": \"uuid\" },\n \"description\": \"Array of project IDs to retrieve. IDs are obtained from the Create Workspace endpoint.\"\n },\n \"detailed\": {\n \"type\": \"boolean\",\n \"default\": false,\n \"description\": \"When true, returns full track metadata for each project's tracks.\"\n },\n \"show_tracks\": {\n \"type\": \"boolean\",\n \"default\": false,\n \"description\": \"When true, includes the tracks array within each project.\"\n }\n}\n\nRESPONSE SCHEMA:
\n{\n \"collections\": {\n \"type\": \"array\",\n \"description\": \"List of requested projects with their metadata and optionally tracks.\",\n \"items\": {\n \"type\": \"object\",\n \"description\": \"Project object.\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"example\": \"projectId\",\n \"description\": \"Unique project identifier.\"\n },\n \"key\": {\n \"type\": \"string\",\n \"example\": \"projectKey\",\n \"description\": \"Project key composed of the query_id and a slugified project title.\"\n },\n \"title\": {\n \"type\": \"string\",\n \"description\": \"Generated project title.\"\n },\n \"description\": {\n \"type\": [\"string\", \"null\"],\n \"description\": \"AI-generated description of the project's musical theme and intended use.\"\n },\n \"keywords\": {\n \"type\": \"array\",\n \"items\": { \"type\": \"string\" },\n \"description\": \"Descriptive keywords for the project.\"\n },\n \"featuring\": {\n \"type\": \"array\",\n \"description\": \"The original prompt(s) used to generate this project.\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"space\": {\n \"type\": \"string\",\n \"description\": \"The original query text.\"\n }\n }\n }\n },\n \"number_of_tracks\": {\n \"type\": \"integer\",\n \"description\": \"Total number of tracks in the project.\"\n },\n \"processed_at\": {\n \"type\": [\"string\", \"null\"],\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the project was processed.\"\n },\n \"updated_at\": {\n \"type\": [\"string\", \"null\"],\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the project was last updated.\"\n }\n }\n }\n },\n \"pagination\": {\n \"type\": \"object\",\n \"description\": \"Pagination metadata.\",\n \"properties\": {\n \"item_count\": {\n \"type\": \"integer\",\n \"description\": \"Number of projects returned.\"\n }\n }\n }\n}\n\nNote: When show_tracks=true, each project includes a tracks array with the same track object structure documented in the Get Project Tracks endpoint. Set detailed=true for full track metadata or detailed=false for a lighter response.
This endpoint retrieves detailed information about multiple projects in a single request, identified by their Keys. Project Keys are obtained from the response of the Create Workspace endpoint. Each returned project includes metadata such as its title, description, keywords, and optionally its full list of tracks. Use show_tracks to control whether tracks are included, and detailed to control the verbosity of track metadata.
REQUEST SCHEMA:
\n{\n \"collection_keys\": {\n \"type\": \"array\",\n \"required\": true,\n \"items\": { \"type\": \"string\", \"format\": \"uuid\" },\n \"description\": \"Array of project keys to retrieve. IDs are obtained from the Create Workspace endpoint.\"\n },\n \"detailed\": {\n \"type\": \"boolean\",\n \"default\": false,\n \"description\": \"When true, returns full track metadata for each project's tracks.\"\n },\n \"show_tracks\": {\n \"type\": \"boolean\",\n \"default\": false,\n \"description\": \"When true, includes the tracks array within each project.\"\n }\n}\n\nRESPONSE SCHEMA:
\n{\n \"collections\": {\n \"type\": \"array\",\n \"description\": \"List of requested projects with their metadata and optionally tracks.\",\n \"items\": {\n \"type\": \"object\",\n \"description\": \"Project object.\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"example\": \"projectId\",\n \"description\": \"Unique project identifier.\"\n },\n \"key\": {\n \"type\": \"string\",\n \"example\": \"projectKey\",\n \"description\": \"Project key composed of the query_id and a slugified project title.\"\n },\n \"title\": {\n \"type\": \"string\",\n \"description\": \"Generated project title.\"\n },\n \"description\": {\n \"type\": [\"string\", \"null\"],\n \"description\": \"AI-generated description of the project's musical theme and intended use.\"\n },\n \"keywords\": {\n \"type\": \"array\",\n \"items\": { \"type\": \"string\" },\n \"description\": \"Descriptive keywords for the project.\"\n },\n \"featuring\": {\n \"type\": \"array\",\n \"description\": \"The original prompt(s) used to generate this project.\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"space\": {\n \"type\": \"string\",\n \"description\": \"The original query text.\"\n }\n }\n }\n },\n \"number_of_tracks\": {\n \"type\": \"integer\",\n \"description\": \"Total number of tracks in the project.\"\n },\n \"processed_at\": {\n \"type\": [\"string\", \"null\"],\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the project was processed.\"\n },\n \"updated_at\": {\n \"type\": [\"string\", \"null\"],\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the project was last updated.\"\n }\n }\n }\n },\n \"pagination\": {\n \"type\": \"object\",\n \"description\": \"Pagination metadata.\",\n \"properties\": {\n \"item_count\": {\n \"type\": \"integer\",\n \"description\": \"Number of projects returned.\"\n }\n }\n }\n}\n\nNote: When show_tracks=true, each project includes a tracks array with the same track object structure documented in the Get Project Tracks endpoint. Set detailed=true for full track metadata or detailed=false for a lighter response.
New POST endpoint that allow refining an existing collection (project, playlist, or custom-tag) by providing a natural language refinement instruction and/or a search filter. The system uses an LLM to produce a new prompt from the original collection description + the refinement, then performs a similarity search and replaces the collection's tracks with the new results. The collection description and keywords are also updated.
\nAt least one of refinement or filter must be provided.
refinement (optional string) — natural language instruction for how to change the collection
filter (optional object) — search filter in AIMS filter syntax (forwarded to search API)
Use your Space ID and Project ID (project must be a part of the Space) instead of the \"space.id\" and \"project.id\" placeholders in the URL path.
\nYou can also use the optional API request parameters detailed, show_filter, show_tracks to control the API request payload as mentioned in the previous API requests documentation.
{\n \"refinement\": {\n \"type\": \"string\",\n \"description\": \"Natural language instruction to refine or adjust the generated collection (e.g. adjusting mood, energy, or style).\"\n },\n \"filter\": {\n \"type\": \"object\",\n \"description\": \"Filter criteria to constrain track results within the refined collections.\",\n \"properties\": {\n \"logic\": {\n \"type\": \"string\",\n \"description\": \"Logical operator applied across all filter conditions (e.g. 'and').\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"description\": \"List of individual filter conditions.\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"field\": {\n \"type\": \"string\",\n \"description\": \"Track field to filter on (e.g. 'genres', 'moods', 'bpm').\"\n },\n \"operator\": {\n \"type\": \"string\",\n \"description\": \"Comparison operator to apply (e.g. 'eq' for exact match, 'in' for list membership).\"\n },\n \"value\": {\n \"type\": [\"string\", \"array\"],\n \"description\": \"Value or list of values to match against the specified field. Use a string for single-value operators (e.g. 'eq') and an array for multi-value operators (e.g. 'in').\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n }\n }\n}\n\n{\n \"collection\": {\n \"type\": \"object\",\n \"description\": \"The updated collection object returned after applying the refinement.\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"description\": \"Unique identifier for the collection.\"\n },\n \"key\": {\n \"type\": \"string\",\n \"description\": \"Unique identifier for the collection.\"\n },\n \"title\": {\n \"type\": \"string\",\n \"description\": \"Generated title for the collection.\"\n },\n \"description\": {\n \"type\": \"string\",\n \"description\": \"Narrative description of the dramatic scene or mood the collection is designed for.\"\n },\n \"keywords\": {\n \"type\": \"array\",\n \"description\": \"List of descriptive keyword tags characterising the collection's sound and mood.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"number_of_tracks\": {\n \"type\": \"integer\",\n \"description\": \"Number of tracks in the collection.\"\n },\n \"is_exported\": {\n \"type\": \"boolean\",\n \"description\": \"Whether the collection has been exported.\"\n },\n \"processed_at\": {\n \"type\": [\"string\", \"null\"],\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the collection was processed. Null if not yet processed.\"\n },\n \"updated_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the collection was last updated.\"\n },\n \"filter\": {\n \"type\": \"object\",\n \"description\": \"Filter criteria applied when sourcing tracks for this collection.\",\n \"properties\": {\n \"logic\": {\n \"type\": \"string\",\n \"description\": \"Logical operator applied across filter conditions (e.g. 'and').\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"description\": \"List of individual filter conditions.\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"field\": {\n \"type\": \"string\",\n \"description\": \"Track field to filter on (e.g. 'genres').\"\n },\n \"operator\": {\n \"type\": \"string\",\n \"description\": \"Comparison operator applied (e.g. 'in').\"\n },\n \"value\": {\n \"type\": [\"string\", \"array\"],\n \"description\": \"Value or list of values to match against the specified field.\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n }\n },\n \"tracks\": {\n \"type\": \"array\",\n \"description\": \"List of tracks included in this collection. Track object structure is identical to that returned in the generation response.\",\n \"items\": {\n \"type\": \"object\"\n }\n },\n \"contact\": {\n \"type\": [\"string\", \"null\"],\n \"description\": \"Contact information. Null when not set.\"\n },\n \"featuring\": {\n \"type\": [\"string\", \"null\"],\n \"description\": \"Featured artist or entity. Null when not set.\"\n },\n \"thumbnails\": {\n \"type\": [\"array\", \"null\"],\n \"description\": \"Thumbnail image references. Null when not set.\"\n }\n }\n }\n}\n\n// Single condition\n{\"logic\": \"and\", \"conditions\": [{\"field\": \"genres\", \"operator\": \"eq\", \"value\": \"rock\"}]}\n// Range\n{\"logic\": \"and\", \"conditions\": [{\"field\": \"release_year\", \"operator\": \"gte\", \"value\": 2020}]}\n// Multiple conditions\n{\"logic\": \"and\", \"conditions\": [\n {\"field\": \"genres\", \"operator\": \"eq\", \"value\": \"electronic\"},\n {\"field\": \"release_year\", \"operator\": \"gte\", \"value\": 2020},\n {\"field\": \"release_year\", \"operator\": \"lte\", \"value\": 2025}\n]}\n// OR logic\n{\"logic\": \"or\", \"conditions\": [\n {\"field\": \"genres\", \"operator\": \"eq\", \"value\": \"rock\"},\n {\"field\": \"genres\", \"operator\": \"eq\", \"value\": \"pop\"}\n]}\n\nNew POST endpoint that suggest three new collections that fit the overall vibe of a Space - it \"fills the gap\".
\ntitle, description, keywords) to Create a new collection inside a Space in the next API request.You can also use the optional API request parameter detailed to control the API request payload as mentioned in the previous API requests documentation.
{\n \"mode\": {\n \"type\": \"string\",\n \"description\": \"Type of a mode used to suggest new collections. So far there is only 'fill_the_gap' available.\"\n }\n}\n\n{\n \"type\": \"array\",\n \"description\": \"List of suggested collection concepts generated for the space.\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"title\": {\n \"type\": \"string\",\n \"description\": \"Generated title for the collection concept.\"\n },\n \"description\": {\n \"type\": \"string\",\n \"description\": \"Narrative description of the scene or mood the collection concept is designed for.\"\n },\n \"keywords\": {\n \"type\": \"array\",\n \"description\": \"List of descriptive keyword tags characterising the collection concept's sound and mood.\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n }\n}\n\nNew POST endpoint where you can use suggestions from the previous API request to create new collections that fit the overall vibe of a Space - it \"fills the gap\".
\nUse one of the JSON objects from the 'Suggest new collections for a Space' API response.
\nOr use a prompt to create a new collection inside a Space (see the next API request).
\nAdd filter to use filtering criteria when creating a collection (see the API request example).
You can also use the optional API request parameters detailed, show_tracks, show_filter to control the API request payload as mentioned in the previous API requests documentation.
{\n \"title\": {\n \"type\": \"string\",\n \"description\": \"Display title for the collection.\"\n },\n \"description\": {\n \"type\": \"string\",\n \"description\": \"Narrative description of the scene or mood the collection is designed for.\"\n },\n \"keywords\": {\n \"type\": \"array\",\n \"description\": \"List of descriptive keyword tags characterising the collection's sound and mood.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"filter\": {\n \"type\": \"object\",\n \"description\": \"Filter criteria to constrain track results within the collection.\",\n \"properties\": {\n \"logic\": {\n \"type\": \"string\",\n \"description\": \"Logical operator applied across all filter conditions (e.g. 'and').\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"description\": \"List of individual filter conditions.\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"field\": {\n \"type\": \"string\",\n \"description\": \"Track field to filter on (e.g. 'genres', 'moods', 'bpm').\"\n },\n \"operator\": {\n \"type\": \"string\",\n \"description\": \"Comparison operator to apply (e.g. 'eq' for exact match, 'in' for list membership).\"\n },\n \"value\": {\n \"type\": [\"string\", \"array\"],\n \"description\": \"Value or list of values to match against the specified field. Use a string for single-value operators (e.g. 'eq') and an array for multi-value operators (e.g. 'in').\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n }\n }\n}\n\n{\n \"collection\": {\n \"type\": \"object\",\n \"description\": \"The newly created collection object.\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"description\": \"Unique identifier for the collection. Can be used in subsequent API requests.\"\n },\n \"key\": {\n \"type\": \"string\",\n \"description\": \"URL-friendly slugified identifier for the collection.\"\n },\n \"title\": {\n \"type\": \"string\",\n \"description\": \"Display title for the collection.\"\n },\n \"description\": {\n \"type\": \"string\",\n \"description\": \"Narrative description of the scene or mood the collection is designed for.\"\n },\n \"keywords\": {\n \"type\": \"array\",\n \"description\": \"List of descriptive keyword tags characterising the collection's sound and mood.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"number_of_tracks\": {\n \"type\": \"integer\",\n \"description\": \"Number of tracks currently in the collection. Zero when freshly created.\"\n }\n \"processed_at\": {\n \"type\": [\"string\", \"null\"],\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the collection was processed. Null when not yet processed.\"\n },\n \"updated_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the collection was last updated.\"\n },\n \"filter\": {\n \"type\": \"object\",\n \"description\": \"Filter criteria applied when sourcing tracks for this collection. Empty object when no filter has been set.\"\n },\n \"tracks\": {\n \"type\": \"array\",\n \"description\": \"List of tracks included in this collection. Empty array when no tracks have been assigned.\",\n \"items\": {\n \"type\": \"object\"\n }\n },\n \"thumbnails\": {\n \"type\": [\"array\", \"null\"],\n \"description\": \"Thumbnail image references. Null when not set.\"\n }\n }\n }\n}\n\nUse a prompt to create a new collection inside a Space. This endpoint takes into consideration the overall Space vibe and combines it with the provided prompt in this API request. The created project reflects both teh original Space prompt and the prompt provided in the API request.
\nfilter to use filtering criteria when creating a collection, leave the attribute out or send it as null. (see the API request example).You can also use the optional API request parameters detailed, show_tracks, show_filter to control the API request payload as mentioned in the previous API requests documentation.
{\n \"title\": {\n \"type\": \"string\",\n \"description\": \"Display title for the collection.\"\n },\n \"description\": {\n \"type\": \"string\",\n \"description\": \"Narrative description of the scene or mood the collection is designed for.\"\n },\n \"keywords\": {\n \"type\": \"array\",\n \"description\": \"List of descriptive keyword tags characterising the collection's sound and mood.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"filter\": {\n \"type\": \"object\",\n \"description\": \"Filter criteria to constrain track results within the collection.\",\n \"properties\": {\n \"logic\": {\n \"type\": \"string\",\n \"description\": \"Logical operator applied across all filter conditions (e.g. 'and').\"\n },\n \"conditions\": {\n \"type\": \"array\",\n \"description\": \"List of individual filter conditions.\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"field\": {\n \"type\": \"string\",\n \"description\": \"Track field to filter on (e.g. 'genres', 'moods', 'bpm').\"\n },\n \"operator\": {\n \"type\": \"string\",\n \"description\": \"Comparison operator to apply (e.g. 'eq' for exact match, 'in' for list membership).\"\n },\n \"value\": {\n \"type\": [\"string\", \"array\"],\n \"description\": \"Value or list of values to match against the specified field. Use a string for single-value operators (e.g. 'eq') and an array for multi-value operators (e.g. 'in').\",\n \"items\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n }\n }\n}\n\n{\n \"collection\": {\n \"type\": \"object\",\n \"description\": \"The newly created collection object.\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\",\n \"format\": \"uuid\",\n \"description\": \"Unique identifier for the collection. Can be used in subsequent API requests.\"\n },\n \"key\": {\n \"type\": \"string\",\n \"description\": \"URL-friendly slugified identifier for the collection.\"\n },\n \"title\": {\n \"type\": \"string\",\n \"description\": \"Display title for the collection.\"\n },\n \"description\": {\n \"type\": \"string\",\n \"description\": \"Narrative description of the scene or mood the collection is designed for.\"\n },\n \"keywords\": {\n \"type\": \"array\",\n \"description\": \"List of descriptive keyword tags characterising the collection's sound and mood.\",\n \"items\": {\n \"type\": \"string\"\n }\n },\n \"number_of_tracks\": {\n \"type\": \"integer\",\n \"description\": \"Number of tracks currently in the collection. Zero when freshly created.\"\n }\n \"processed_at\": {\n \"type\": [\"string\", \"null\"],\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the collection was processed. Null when not yet processed.\"\n },\n \"updated_at\": {\n \"type\": \"string\",\n \"format\": \"date-time\",\n \"description\": \"Timestamp when the collection was last updated.\"\n },\n \"filter\": {\n \"type\": \"object\",\n \"description\": \"Filter criteria applied when sourcing tracks for this collection. Empty object when no filter has been set.\"\n },\n \"tracks\": {\n \"type\": \"array\",\n \"description\": \"List of tracks included in this collection. Empty array when no tracks have been assigned.\",\n \"items\": {\n \"type\": \"object\"\n }\n },\n \"thumbnails\": {\n \"type\": [\"array\", \"null\"],\n \"description\": \"Thumbnail image references. Null when not set.\"\n }\n }\n }\n}\n\nThis endpoint deletes a Space by ID you provide in the URL path.
\nThe DELETE request deletes only the Space, it does not delete the nested collections. (If you'd like to delete the nested collections use the 'Delete project by ID' endpoint.)
\nUse your desired Space ID instead of the \"space.id\" placeholder in the URL path.
\nIf successfull the API response status is 200 and the API response is:
{\n \"message\": \"Space has been deleted.\"\n}\n\nIf a Space ID does not exist, or a Space has been already deleted, the API response status is 404 and the API response is:
{\n \"code\": 5501,\n \"message\": \"Space has not been found!\",\n \"payload\": {}\n}\n\nSpaces builds and names playlists based on simple prompts. It understands what kind of music is suitable for different scenes in shows, and types of productions.
\nDescribe what you’re working on in any language, whether it’s a TV show, film, or ad campaign, and Spaces instantly creates multiple playlists that reflect the full production context not just a single scene.
\nEach playlist will have descriptions and keywords that you can review before you delve into the playlists and start listening to the tracks, which have been chosen based on the feel that each scene in the show needs to have.
\nWe see several applications for it, here are some of them:
\nFinding large number of tracks for briefs from long-form editors
\nOutbound pitching to new leads based on what types of music they’ll need
\nLanding pages for users that are tailored to the exact work that they do
\nThis is a great tool for your team to efficiently serve clients fast, and can also be implemented for clients to use themselves by just telling you what production they are working on today.
\nPlease note that this functionality needs to be enabled on your platform/site before you can use it.
\n","_postman_id":"29fbb448-bbf3-4042-80e2-828e6328e3ba"},{"name":"Search by tag","item":[{"name":"List tags","item":[{"name":"List tags","id":"65f33e24-7c55-4dd8-a0ad-0311b19e3e59","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/tags","description":"https://api.aimsapi.com/v1/tags
\n{\n \"tags\": {\n \"genre\": [\n {\n \"id\": 1,\n \"title\": \"60's pop\"\n },\n {\n \"id\": 2,\n \"title\": \"60's rock\"\n },\n ...\n {\n \"id\": 729,\n \"title\": \"worrying\"\n },\n {\n \"id\": 730,\n \"title\": \"zomb\"\n }\n ]\n }\n}\n\nhttps://api.aimsapi.com/v1/tags/length
\n{\n \"length\": 730\n}\n\nYou can use the returned query_id to send feedback to the AIMS API. See theConversionendpoint below.
Filtering is available for this endpoint. See theFilteringsection.
https://api.aimsapi.com/v1/query/by-tag
\n\nREQUEST SCHEMA
\n\n\"tag_id\": {\n \"type\": integer,\n \"description\": \"Tag ID to search by.\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"tag_id\"\n]\n\nRESPONSE SCHEMA
\n\n\"query_id\": {\n \"type\": \"uuid\",\n \"description\": \"An ID to use to reference this query.\"\n},\n\"tracks\": {\n \"type\": \"array\",\n \"description\": \"A list of similar tracks.\"\n},\n\"required\": [\n \"query_id\",\n \"tracks\"\n]\n\nquery_id to send feedback to the AIMS API. See theConversionendpoint below.https://api.aimsapi.com/v1/albums/search/by-tag
\n\nREQUEST SCHEMA
\n\n\"tag_id\": {\n \"type\": integer,\n \"description\": \"Tag ID to search by.\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"tag_id\"\n]\n\nRESPONSE SCHEMA
\n\n\"query_id\": {\n \"type\": \"uuid\",\n \"description\": \"An ID to use to reference this query.\"\n},\n\"collections\": {\n \"type\": \"array\",\n \"description\": \"A list of similar collections.\"\n},\n\"required\": [\n \"query_id\",\n \"collections\"\n]\n\nhttps://api.aimsapi.com/v1/query/by-tag
\n\nREQUEST SCHEMA
\n\n\"tag_id\": {\n \"type\": integer,\n \"description\": \"Tag ID to search by.\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"required\": [\n \"tag_id\"\n]\n\nRESPONSE SCHEMA
\n\n\"query_id\": {\n \"type\": \"uuid\",\n \"description\": \"An ID to use to reference this query.\"\n},\n\"tracks\": {\n \"type\": \"array\",\n \"description\": \"A list of similar tracks.\"\n},\n\"required\": [\n \"query_id\",\n \"tracks\"\n]\n\n[collectionType] is equal to chosen type of collection (e.g. \"albums\", \"project\", \"playlist\", \"artists\")
\n","urlObject":{"path":["v1","[collectionType]","search","by-tag"],"host":["https://api.aimsapi.com"],"query":[{"key":"detailed","value":"true"},{"key":"groups","value":"true"}],"variable":[]}},"response":[{"id":"9344a335-dce6-43f2-95f1-20426bea744b","name":"Search collections by Tag (with filters)","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"tag_id\": 199,\n \"page\": 1,\n \"page_size\": 50,\n \"filter\": {\n \"logic\": \"and\",\n \"conditions\": [\n {\n \"field\": \"title\",\n \"operator\": \"begins\",\n \"value\": \"A\"\n }\n ]\n }\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"https://api.aimsapi.com/v1/[collectionType]/search/by-tag?detailed=true&groups=true","host":["https://api.aimsapi.com"],"path":["v1","[collectionType]","search","by-tag"],"query":[{"key":"detailed","value":"true"},{"key":"groups","value":"true"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Mon, 04 Oct 2021 19:07:20 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"495"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"e627227d-65e7-42fd-9990-b617afba8321\",\n \"collections\": [\n {\n \"id\": \"a7c18f40-f3bd-4403-b3d6-448f73861cff\",\n \"key\": \"AB-CD116\",\n \"processed_at\": \"2021-08-11T17:18:27.000000Z\",\n \"title\": \"something\"\n },\n {\n \"id\": \"c8c740b3-633d-4de6-a7f4-ead4c5986f12\",\n \"key\": \"SFT188\",\n \"processed_at\": \"2021-08-11T17:22:08.000000Z\",\n \"title\": \"interesting\"\n },\n ...\n ]\n}"}],"_postman_id":"e0c7e3a0-c99a-4006-9c60-f75a707fc08d"}],"id":"46e190ec-df2b-4fe0-a6c7-5236979de8e2","_postman_id":"46e190ec-df2b-4fe0-a6c7-5236979de8e2","description":""}],"id":"70d43fb8-6439-44f7-a631-ed04c10540e5","event":[{"listen":"prerequest","script":{"id":"533359a7-3586-4be2-9c52-a35615d2f5fb","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"a8fb36c2-8434-4fba-bb7a-38b79fd4cbf0","type":"text/javascript","exec":[""]}}],"_postman_id":"70d43fb8-6439-44f7-a631-ed04c10540e5","description":""},{"name":"Playlist Generator","item":[{"name":"Playlist Generator","item":[{"name":"Single-seed playlist","id":"76dc5543-124c-4d1a-8688-80734743d024","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"description":"length of playlist
\n","key":"playlist_length","value":"20","type":"text"},{"description":"type of seed track
\n","key":"track[type]","value":"client","type":"text"},{"description":"identifier of seed track
\n","key":"track[value]","value":"foo-1","type":"text"}]},"url":"https://api.aimsapi.com/v1/playlist/single-seed","description":"This endpoint allows you to create a playlist of tracks similar to a single seed track.
\nquery_id to send feedback to the AIMS API. See the Conversion endpoint below.multipart/form-data content type.time_offset and time_limit parameters of Track type are only available for type url and file. For more details see section Segment Tool.https://api.aimsapi.com/v1/playlist/single-seed
\nDefault:
\n{\n \"query_id\": \"3db4162a-0346-4b9a-92d7-0a119763cbfd\",\n \"tracks\": [\n {\n \"id\": 1,\n \"id_client\": \"foo\",\n \"duration\": 240,\n \"tags\": [\n \"foo\",\n \"bar\"\n ],\n \"processed_at\": {\n \"date\": \"2018\",\n \"timezone_type\": 3,\n \"timezone\": \"UTC\"\n },\n \"process_input_error\": \"null\",\n \"store_secret\": \"12bj143bapie213\"\n }\n ],\n \"playlist\": {\n \"length\": 20,\n \"duration\": 2626\n }\n}\n\nsegment tool example
\n","key":"track[1][time_offset]","value":"22","type":"text"},{"description":"segment tool example
\n","key":"track[1][time_limit]","value":"34","type":"text"},{"key":"tracks[2][type]","value":"file","type":"text"},{"key":"tracks[2][value]","type":"file","src":"d18SESoUt/Test001.mp3"}]},"url":"https://api.aimsapi.com/v1/playlist/multiple-seeds","description":"This endpoint allows you to create a playlist of tracks similar to a group of tracks.
\nquery_id to send feedback to the AIMS API. See the Conversion endpoint below.multipart/form-data content type.time_offset and time_limit parameters of Track type are only available for type url and file. For more details see section Segment Tool.https://api.aimsapi.com/v1/playlist/multiple-seeds
\nDefault:
\n{\n \"query_id\": \"3db4162a-0346-4b9a-92d7-0a119763cbfd\",\n \"tracks\": [\n {\n \"id\": 1,\n \"id_client\": \"foo\",\n \"duration\": 240,\n \"tags\": [\n \"foo\",\n \"bar\"\n ],\n \"processed_at\": {\n \"date\": \"2018\",\n \"timezone_type\": 3,\n \"timezone\": \"UTC\"\n },\n \"process_input_error\": \"null\",\n \"store_secret\": \"12bj143bapie213\"\n }\n ],\n \"playlist\": {\n \"length\": 20,\n \"duration\": 2626\n }\n}\n\nsegment tool example
\n","key":"to_track[time_offset]","value":"13","type":"text"},{"description":"segment tool example
\n","key":"to_track[time_limit]","value":"43","type":"text"}]},"url":"https://api.aimsapi.com/v1/playlist/transition","description":"This endpoint allows you to create a playlist of tracks in a way that the first track in the playlist is similar to the first seed and tracks then gradually transition to be similar to the second seed.
\nquery_id to send feedback to the AIMS API. See the Conversion endpoint below.multipart/form-data content type.time_offset and time_limit parameters of Track type are only available for type url and file. For more details see section Segment Tool.https://api.aimsapi.com/v1/playlist/transition
\nDefault:
\n{\n \"query_id\": \"3db4162a-0346-4b9a-92d7-0a119763cbfd\",\n \"tracks\": [\n {\n \"id\": 1,\n \"id_client\": \"foo\",\n \"duration\": 240,\n \"tags\": [\n \"foo\",\n \"bar\"\n ],\n \"processed_at\": {\n \"date\": \"2018\",\n \"timezone_type\": 3,\n \"timezone\": \"UTC\"\n },\n \"process_input_error\": \"null\",\n \"store_secret\": \"12bj143bapie213\"\n }\n ],\n \"playlist\": {\n \"length\": 20,\n \"duration\": 2626\n }\n}\n\nlength of playlist
\n","key":"playlist_length","value":"30","type":"text"},{"description":"type of seed track
\n","key":"track[type]","value":"url","type":"text"},{"description":"identifier of seed track
\n","key":"track[value]","value":"https://www.youtube.com/watch?v=EdhoX1Xu6ZI","type":"text"},{"key":"filter[logic]","value":"and","type":"text"},{"key":"filter[conditions][0][field]","value":"duration","type":"text"},{"key":"filter[conditions][0][operator]","value":"gte","type":"text"},{"key":"filter[conditions][0][value]","value":"60","type":"text"},{"key":"filter[conditions][1][logic]","value":"or","type":"text"},{"key":"filter[conditions][1][conditions][0][field]","value":"instruments","type":"text"},{"key":"filter[conditions][1][conditions][0][operator]","value":"in","type":"text"},{"key":"filter[conditions][1][conditions][0][value][0]","value":"guitar","type":"text"},{"key":"filter[conditions][1][conditions][0][value][1]","value":"drums","type":"text"},{"key":"filter[conditions][1][conditions][0][value][2]","value":"piano","type":"text"},{"key":"filter[conditions][1][conditions][1][field]","value":"track_name","type":"text"},{"key":"filter[conditions][1][conditions][1][operator]","value":"begins","type":"text"},{"key":"filter[conditions][1][conditions][1][value]","value":"Play","type":"text"}]},"url":"https://api.aimsapi.com/v1/playlist/single-seed","description":"https://api.aimsapi.com/v1/playlist/single-seed
\nDefault:
\n{\n \"query_id\": \"3db4162a-0346-4b9a-92d7-0a119763cbfd\",\n \"tracks\": [\n {\n \"id\": 1,\n \"id_client\": \"foo\",\n \"duration\": 240,\n \"tags\": [\n \"foo\",\n \"bar\"\n ],\n \"processed_at\": {\n \"date\": \"2018\",\n \"timezone_type\": 3,\n \"timezone\": \"UTC\"\n },\n \"process_input_error\": \"null\",\n \"store_secret\": \"12bj143bapie213\"\n }\n ],\n \"playlist\": {\n \"length\": 20,\n \"duration\": 2626\n }\n}\n\nhttps://api.aimsapi.com/v1/playlist/multiple-seeds
\nDefault:
\n{\n \"query_id\": \"3db4162a-0346-4b9a-92d7-0a119763cbfd\",\n \"tracks\": [\n {\n \"id\": 1,\n \"id_client\": \"foo\",\n \"duration\": 240,\n \"tags\": [\n \"foo\",\n \"bar\"\n ],\n \"processed_at\": {\n \"date\": \"2018\",\n \"timezone_type\": 3,\n \"timezone\": \"UTC\"\n },\n \"process_input_error\": \"null\",\n \"store_secret\": \"12bj143bapie213\"\n }\n ],\n \"playlist\": {\n \"length\": 20,\n \"duration\": 2626\n }\n}\n\nThis endpoint allows you to create a playlist of tracks in a way that the first track in the playlist is similar to the first seed and tracks then gradually transition to be similar to the second seed.
\nquery_id to send feedback to the AIMS API. See the Conversion endpoint below.multipart/form-data content type.time_offset and time_limit parameters of Track type are only available for type url and file.https://api.aimsapi.com/v1/playlist/transition
\nDefault:
\n{\n \"query_id\": \"3db4162a-0346-4b9a-92d7-0a119763cbfd\",\n \"tracks\": [\n {\n \"id\": 1,\n \"id_client\": \"foo\",\n \"duration\": 240,\n \"tags\": [\n \"foo\",\n \"bar\"\n ],\n \"processed_at\": {\n \"date\": \"2018\",\n \"timezone_type\": 3,\n \"timezone\": \"UTC\"\n },\n \"process_input_error\": \"null\",\n \"store_secret\": \"12bj143bapie213\"\n }\n ],\n \"playlist\": {\n \"length\": 20,\n \"duration\": 2626\n }\n}\n\nHighlights functionality allows you to highlight parts of the track that are most similar to the seed track (or its part). You need to specify highlights: true in your request. The response then contains an array of track parts to highlight with the following structure:
\"highlights\": [\n {\n \"duration\": 15,\n \"offset\": 13.824\n },\n ...\n {\n \"duration\": 30.36,\n \"offset\": 30.208\n }\n]\n\nThe search returns one or more highlights for a single result.
\nHighlights work for search by ID, by file, by URL, Prompt Search and Video Search. Please see the examples below.
\nPlease note that this functionality needs to be enabled on your account before you can use it.
\n","event":[{"listen":"prerequest","script":{"id":"2c3f4516-7af7-4038-b85b-9b080333eb1f","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"7a86142e-574b-4627-8c89-b442d743a1ab","type":"text/javascript","exec":[""]}}],"_postman_id":"69ec476b-b9a6-4b49-b4bb-03c5e84538bf"},{"name":"Segment Tool","item":[{"name":"Search by ID","id":"f31b3ed1-b629-4bfb-9551-c905f70a6240","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"seeds\": [\n {\n \"type\": \"track\",\n \"value\": \"ID123\",\n \"offset\": 12,\n \"limit\": 52\n }\n ],\n \"page\": 1,\n \"page_size\": 20\n}"},"url":"https://api.aimsapi.com/v1/search","urlObject":{"path":["v1","search"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"2aa4f47e-c69f-412e-91d9-3b3faf3eaea6","name":"Search by ID","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"seeds\": [\n {\n \"type\": \"track\",\n \"value\": \"ID123\",\n \"offset\": 0,\n \"limit\": 28\n }\n ],\n \"page\": 1,\n \"page_size\": 20\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/search"},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"did_you_mean\": [\n {\n \"included\": true,\n \"type\": \"track\",\n \"value\": {\n ...\n \"id\": 2,\n \"id_client\": \"ID123\",\n ...\n }\n }\n ],\n \"query_id\": \"3db4162a-0346-4b9a-92d7-0a119763cbfd\",\n \"totals\": {\n \"tracks\": {\n \"relation\": \"gte\",\n \"value\": 10000\n }\n },\n \"tracks\": [\n {\n \"id\": 1,\n \"id_client\": \"foo\",\n \"duration\": 240,\n \"tags\": [\n \"foo\",\n \"bar\"\n ],\n \"processed_at\": {\n \"date\": \"2018\",\n \"timezone_type\": 3,\n \"timezone\": \"UTC\"\n },\n \"process_input_error\": \"null\",\n \"store_secret\": \"12bj143bapie213\"\n }\n ]\n}"}],"_postman_id":"f31b3ed1-b629-4bfb-9551-c905f70a6240"},{"name":"Search by audio file","id":"5c2141c2-88e3-489e-8255-83abd497c057","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"multipart/form-data"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"formdata","formdata":[{"key":"track","type":"file","src":"/Users/Shared/test.mp3"},{"key":"time_offset","value":"35","type":"text"},{"key":"time_limit","value":"30","type":"text"},{"key":"page","value":"1","type":"text"},{"key":"page_size","value":"50","type":"text"}]},"url":"https://api.aimsapi.com/v1/query/by-file","description":"https://api.aimsapi.com/v1/query/by-file
\n\nREQUEST SCHEMA
\n\n\"track\": {\n \"type\": \"file\",\n \"description\": \"Track file\"\n},\n\"page\": {\n \"type\": \"number\",\n \"description\": \"Page number.\"\n},\n\"page_size\": {\n \"type\": \"number\",\n \"description\": \"Page size - must be between 1 and 10000.\"\n},\n\"time_offset\": {\n \"type\": \"number\",\n \"description\": \"Number of seconds from the beginning of the track that should be skipped when searching\"\n},\n\"time_limit\": {\n \"type\": \"number\",\n \"description\": \"Number of seconds starting from 'time_offset' that should be used for searching (1-60)\"\n}\n\"required\": [\n \"track\"\n]\n\nRESPONSE SCHEMA
\n\n\"query_id\": {\n \"type\": \"uuid\",\n \"description\": \"An ID to use to reference this query.\"\n},\n\"tracks\": {\n \"type\": \"array\",\n \"description\": \"A list of similar tracks.\"\n},\n\"required\": [\n \"query_id\",\n \"tracks\"\n]\n\nThis endpoint allows you to reuse a previously used file with the Search by audio file endpoint.
\nThe Search by audio file endpoint returns an X-Hash header. You can use this value for subsequent calls for the same file instead of reuploading the file. Please see the example next to this endpoint for details on submitting the hash.
The segment tool helps you define the exact part of the track to use. Use offset and limit request parameters. Please note that the segment must be no longer than 60 seconds.
offset and limit parameters of Track type are available for type id, url and fileIgnore vocals functionality allows you to search only by the instrumental part of the track. You need to specify suppress_vocals: true in your request.
Ignore vocals work for search by file and by URL. Please see the examples below.
\n","event":[{"listen":"prerequest","script":{"id":"c809b54c-112a-497a-9f87-8e758968d2c7","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"bbe54a29-f27b-45b8-ab65-d7e9ace7c2ce","type":"text/javascript","exec":[""]}}],"_postman_id":"9275fd83-b2ce-482d-9143-437c9c5d497c"},{"name":"Prioritise BPM","item":[{"name":"Search by ID (prioritise BPM)","id":"94eb63e5-ff87-4751-9483-d3bab75779ad","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"seeds\": [\n {\n \"type\": \"track\",\n \"track_id\": \"foo10#5\",\n \"prioritise_bpm\": true,\n \"bpm_range\": 1\n }\n ],\n \"page\": 1,\n \"page_size\": 50\n}"},"url":"https://api.aimsapi.com/v1/search","urlObject":{"path":["v1","search"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"736fb8c3-9072-42fd-9dd3-9cf4b656b1be","name":"Search by ID","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"seeds\": [\n {\n \"type\": \"track\",\n \"value\": \"ID123\",\n \"prioritise_bpm\": true,\n \"bpm_range\": 1\n }\n ],\n \"page\": 1,\n \"page_size\": 20\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/search"},"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"did_you_mean\": [\n {\n \"included\": true,\n \"type\": \"track\",\n \"value\": {\n ...\n \"id\": 2,\n \"id_client\": \"ID123\",\n ...\n }\n }\n ],\n \"query_id\": \"3db4162a-0346-4b9a-92d7-0a119763cbfd\",\n \"totals\": {\n \"tracks\": {\n \"relation\": \"gte\",\n \"value\": 10000\n }\n },\n \"tracks\": [\n {\n \"id\": 1,\n \"id_client\": \"foo\",\n \"duration\": 240,\n \"tags\": [\n \"foo\",\n \"bar\"\n ],\n \"processed_at\": {\n \"date\": \"2018\",\n \"timezone_type\": 3,\n \"timezone\": \"UTC\"\n },\n \"process_input_error\": \"null\",\n \"store_secret\": \"12bj143bapie213\"\n }\n ]\n}"}],"_postman_id":"94eb63e5-ff87-4751-9483-d3bab75779ad"},{"name":"Search by audio file (prioritise BPM)","id":"b91ba770-ced9-472e-b82e-ef84bbdce53c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"multipart/form-data"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"formdata","formdata":[{"key":"track","type":"file","src":"iFTFli5VH/Test001.mp3"},{"key":"time_offset","value":"35","type":"text"},{"key":"time_limit","value":"30","type":"text"},{"key":"page","value":"1","type":"text"},{"key":"page_size","value":"50","type":"text"},{"key":"prioritise_bpm","value":"true","type":"text"},{"key":"bpm_range","value":"5","type":"text"}]},"url":"https://api.aimsapi.com/v1/query/by-file","urlObject":{"path":["v1","query","by-file"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"e1dd7224-be40-4a02-85ec-75391273eb98","name":"Search by audio file","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"multipart/form-data"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"formdata","formdata":[{"key":"track","type":"file","src":"NWyv0MbR2/Test001.mp3"},{"description":"searching begins at 35 seconds into the track","key":"time_offset","value":"35","type":"text"},{"description":"30 seconds from 0:35 (time_offset) are used","key":"time_limit","value":"30","type":"text"},{"key":"page","value":"1","type":"text"},{"key":"page_size","value":"20","type":"text"},{"key":"prioritise_bpm","value":"true","type":"text"}]},"url":"https://api.aimsapi.com/v1/query/by-file"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.12.2"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/7.2.12"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 22 Nov 2018 10:12:01 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"}],"cookie":[],"responseTime":null,"body":"{\r\n \"query_id\": \"3db4162a-0346-4b9a-92d7-0a119763cbfd\",\r\n \"tracks\": [\r\n {\r\n \"id\": 1,\r\n \"id_client\": \"foo\",\r\n \"duration\": 240,\r\n \"tags\": [\r\n \"foo\",\r\n \"bar\"\r\n ],\r\n \"processed_at\": {\r\n \"date\": \"2018\",\r\n \"timezone_type\": 3,\r\n \"timezone\": \"UTC\"\r\n },\r\n \"process_input_error\": \"null\",\r\n \"store_secret\": \"12bj143bapie213\"\r\n }\r\n ]\r\n}"}],"_postman_id":"b91ba770-ced9-472e-b82e-ef84bbdce53c"},{"name":"Search by URL (prioritise BPM)","id":"62364d26-32f1-4936-bc4f-ec3c4ad3d0a4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"seeds\": [\n {\n \"type\": \"url\",\n \"link\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\n \"offset\": 35,\n \"limit\": 30,\n \"prioritise_bpm\": true,\n \"bpm_range\": 2\n }\n ],\n \"page\": 1,\n \"page_size\": 20\n}"},"url":"https://api.aimsapi.com/v1/search","urlObject":{"path":["v1","search"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"5f6c2e89-cfd0-4872-b2c8-6b9e85b65624","name":"Search by URL","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\r\n \"seeds\": [\r\n {\r\n \"type\": \"url\",\r\n \"link\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\r\n \"offset\": 35,\r\n \"limit\": 30,\r\n \"prioritise_bpm\": true\r\n }\r\n ],\r\n \"page\": 1,\r\n \"page_size\": 20\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/search"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.12.2"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/7.2.12"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 22 Nov 2018 12:26:17 GMT"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"}],"cookie":[],"responseTime":null,"body":"{\r\n \"did_you_mean\": [\r\n {\r\n \"type\": \"url\",\r\n \"value\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\r\n \"included\": true\r\n }\r\n ],\r\n \"query_id\": \"3db4162a-0346-4b9a-92d7-0a119763cbfd\",\r\n \"totals\": {\r\n \"tracks\": {\r\n \"relation\": \"gte\",\r\n \"value\": 10000\r\n }\r\n },\r\n \"tracks\": [\r\n {\r\n \"id\": 1,\r\n \"id_client\": \"foo\",\r\n \"duration\": 240,\r\n \"tags\": [\r\n \"foo\",\r\n \"bar\"\r\n ],\r\n \"processed_at\": {\r\n \"date\": \"2018\",\r\n \"timezone_type\": 3,\r\n \"timezone\": \"UTC\"\r\n },\r\n \"process_input_error\": \"null\",\r\n \"store_secret\": \"12bj143bapie213\"\r\n }\r\n ]\r\n}"}],"_postman_id":"62364d26-32f1-4936-bc4f-ec3c4ad3d0a4"}],"id":"735c777b-dfc5-47ce-a648-c09442d2be6d","description":"Prioritise BPM functionality allows you to only retrieve results that are not only similar but also have similar BPM. You need to specify prioritise_bpm: true in your request.
Prioritise BPM work for search by ID, by file and by URL. Please see the examples below.
\nThe default range is 10 BPM. You can optionally specify the bpm_range parameter to set the range in which to look for similar tracks. The default range is 10 BPM.
Please note that this functionality needs to be enabled on your account before you can use it.
\n","event":[{"listen":"prerequest","script":{"id":"f5f5aad6-ed64-4e9a-98ca-5e94a3677371","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"9f2b7a72-0147-4546-b5a5-90cc012d5132","type":"text/javascript","exec":[""]}}],"_postman_id":"735c777b-dfc5-47ce-a648-c09442d2be6d"},{"name":"Similar Albums","item":[{"name":"Album Information","item":[{"name":"Get Album by Key","id":"1e1bb41a-d4ec-4200-b71f-503807caf702","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/albums/get/by-key/albumKey","description":"This endpoint allows you to get album information based on its key (album_code from your tracks metadata).
This endpoint allows you to search for similar albums based on a seed album specified by its key (album_code from your tracks metadata).
This endpoint allows you to search for an artist by their name/title. It helps you find the key of an artist before you search for similar artists. We can also get you an export of all the keys of all artists we extracted from your metadata.
\nThis is not a similarity search. Only the title field is considered.
This endpoint allows you to get artist information based on its key (key is generated from your tracks metadata by AIMS).
\n","urlObject":{"path":["v1","artists","get","by-key","artistKey"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"d43c1914-c973-4f6e-908b-b605c4e32ab8","name":"Get Artist by Key","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/artists/get/by-key/artistKey"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Mon, 04 Oct 2021 19:17:38 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"498","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"d912fa1b-18db-47e4-bd33-b898283d5351\",\n \"key\": \"damon-albarn\",\n \"processed_at\": \"2021-08-11T11:27:04.000000Z\",\n \"title\": \"Damon Albarn\"\n }\n}"}],"_postman_id":"af2fbb9c-13e2-4845-975f-286c4fd505a7"},{"name":"Get Artist by ID","id":"818ff959-69b2-42d4-9bd8-c0ca13379174","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/artists/get/by-id/artistId","urlObject":{"path":["v1","artists","get","by-id","artistId"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"eddfd78b-b771-4045-80b4-5549e162a100","name":"Get Artist by ID","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/artists/get/by-id/artistId"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Mon, 04 Oct 2021 19:17:43 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"497","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"d912fa1b-18db-47e4-bd33-b898283d5351\",\n \"key\": \"damon-albarn\",\n \"processed_at\": \"2021-08-11T11:27:04.000000Z\",\n \"title\": \"Damon Albarn\"\n }\n}"}],"_postman_id":"818ff959-69b2-42d4-9bd8-c0ca13379174"}],"id":"d88dee05-06c9-4773-8c62-1c1dbfb42e22","_postman_id":"d88dee05-06c9-4773-8c62-1c1dbfb42e22","description":""},{"name":"Similarity Search","item":[{"name":"Search Similar Artists by Key","id":"fd3096dc-cb3f-4ace-b67f-f5ba46445484","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"key\": \"artistKey\"\n}"},"url":"https://api.aimsapi.com/v1/artists/similar/by-key?page=1&page_size=10","description":"This endpoint allows you to search for similar artists based on a seed artist specified by its key (key is generated from your tracks metadata by AIMS).
\n","urlObject":{"path":["v1","artists","similar","by-key"],"host":["https://api.aimsapi.com"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}],"variable":[]}},"response":[{"id":"c4fa0bca-d434-48ea-97f5-43099747a50e","name":"Search Similar Artists by Key","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"key\": \"artistKey\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.aimsapi.com/v1/artists/similar/by-key?page=1&page_size=10","host":["https://api.aimsapi.com"],"path":["v1","artists","similar","by-key"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Mon, 04 Oct 2021 19:18:14 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"0398e245-6d99-4e3b-888e-63f2614e6c55\",\n \"collections\": [\n {\n \"id\": \"6d20198d-c759-45df-883d-7824af7e92a9\",\n \"key\": \"johnny-dowd\",\n \"processed_at\": \"2021-08-11T11:17:30.000000Z\",\n \"title\": \"Johnny Dowd\"\n },\n {\n \"id\": \"7220dbae-7ce1-40e8-b0a9-d756d15d2fbf\",\n \"key\": \"moondog-jr\",\n \"processed_at\": \"2021-08-11T11:17:53.000000Z\",\n \"title\": \"Moondog Jr\"\n },\n ...\n ]\n}"}],"_postman_id":"fd3096dc-cb3f-4ace-b67f-f5ba46445484"},{"name":"Search Similar Artists by ID","id":"99682549-8771-41f8-8b37-089627caa5dd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"artistId\"\n}"},"url":"https://api.aimsapi.com/v1/artists/similar/by-id?page=1&page_size=10","urlObject":{"path":["v1","artists","similar","by-id"],"host":["https://api.aimsapi.com"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}],"variable":[]}},"response":[{"id":"cdaea2d4-dabd-4def-a321-d1572a893f2f","name":"Search Similar Artists by ID","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"artistId\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.aimsapi.com/v1/artists/similar/by-id?page=1&page_size=10","host":["https://api.aimsapi.com"],"path":["v1","artists","similar","by-id"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Mon, 04 Oct 2021 19:18:19 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"498"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"0398e245-6d99-4e3b-888e-63f2614e6c55\",\n \"collections\": [\n {\n \"id\": \"6d20198d-c759-45df-883d-7824af7e92a9\",\n \"key\": \"johnny-dowd\",\n \"processed_at\": \"2021-08-11T11:17:30.000000Z\",\n \"title\": \"Johnny Dowd\"\n },\n {\n \"id\": \"7220dbae-7ce1-40e8-b0a9-d756d15d2fbf\",\n \"key\": \"moondog-jr\",\n \"processed_at\": \"2021-08-11T11:17:53.000000Z\",\n \"title\": \"Moondog Jr\"\n },\n ...\n ]\n}"}],"_postman_id":"99682549-8771-41f8-8b37-089627caa5dd"}],"id":"8d3087a0-e88c-4213-9acb-3fc94b9126f1","_postman_id":"8d3087a0-e88c-4213-9acb-3fc94b9126f1","description":""},{"name":"Filtering","item":[{"name":"Search Similar Artists by Key","id":"94567e21-4704-43dc-91e6-0b27fca37c62","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"key\": \"artistKey\",\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"title\",\n\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\"value\": \"Play\"\n\t\t\t}\n\t\t]\n\t}\n}"},"url":"https://api.aimsapi.com/v1/artists/similar/by-key?page=1&page_size=10","urlObject":{"path":["v1","artists","similar","by-key"],"host":["https://api.aimsapi.com"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}],"variable":[]}},"response":[{"id":"58ad42d1-abad-44ce-b5f2-9c90dd9b7529","name":"Search Similar Artists by Key","originalRequest":{"method":"POST","header":[{"name":"Content-Type","key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"key\": \"artistKey\",\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"title\",\n\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\"value\": \"Play\"\n\t\t\t}\n\t\t]\n\t}\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.aimsapi.com/v1/artists/similar/by-key?page=1&page_size=10","host":["https://api.aimsapi.com"],"path":["v1","artists","similar","by-key"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.19.10"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"X-Powered-By","value":"PHP/7.4.13"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Mon, 04 Oct 2021 19:18:14 GMT"},{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"499"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"0398e245-6d99-4e3b-888e-63f2614e6c55\",\n \"collections\": [\n {\n \"id\": \"6d20198d-c759-45df-883d-7824af7e92a9\",\n \"key\": \"johnny-dowd\",\n \"processed_at\": \"2021-08-11T11:17:30.000000Z\",\n \"title\": \"Johnny Dowd\"\n },\n {\n \"id\": \"7220dbae-7ce1-40e8-b0a9-d756d15d2fbf\",\n \"key\": \"moondog-jr\",\n \"processed_at\": \"2021-08-11T11:17:53.000000Z\",\n \"title\": \"Moondog Jr\"\n },\n ...\n ]\n}"}],"_postman_id":"94567e21-4704-43dc-91e6-0b27fca37c62"},{"name":"Search Similar Artists by ID","id":"c3c7ff52-b08f-4337-be72-05a1a08c9fd0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"id\": \"artistId\",\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"title\",\n\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\"value\": \"Play\"\n\t\t\t}\n\t\t]\n\t}\n}"},"url":"https://api.aimsapi.com/v1/artists/similar/by-id?page=1&page_size=10","urlObject":{"path":["v1","artists","similar","by-id"],"host":["https://api.aimsapi.com"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}],"variable":[]}},"response":[{"id":"ff33cacd-924b-4e5f-ad2f-963f5cc109c9","name":"Search Similar Artists by ID","originalRequest":{"method":"POST","header":[{"name":"Content-Type","key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"id\": \"artistId\",\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"title\",\n\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\"value\": \"Play\"\n\t\t\t}\n\t\t]\n\t}\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.aimsapi.com/v1/artists/similar/by-id?page=1&page_size=10","host":["https://api.aimsapi.com"],"path":["v1","artists","similar","by-id"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.19.10"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"X-Powered-By","value":"PHP/7.4.13"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Mon, 04 Oct 2021 19:18:19 GMT"},{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"498"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"0398e245-6d99-4e3b-888e-63f2614e6c55\",\n \"collections\": [\n {\n \"id\": \"6d20198d-c759-45df-883d-7824af7e92a9\",\n \"key\": \"johnny-dowd\",\n \"processed_at\": \"2021-08-11T11:17:30.000000Z\",\n \"title\": \"Johnny Dowd\"\n },\n {\n \"id\": \"7220dbae-7ce1-40e8-b0a9-d756d15d2fbf\",\n \"key\": \"moondog-jr\",\n \"processed_at\": \"2021-08-11T11:17:53.000000Z\",\n \"title\": \"Moondog Jr\"\n },\n ...\n ]\n}"}],"_postman_id":"c3c7ff52-b08f-4337-be72-05a1a08c9fd0"}],"id":"3210fddd-07d9-4c23-9d01-624c951c8758","_postman_id":"3210fddd-07d9-4c23-9d01-624c951c8758","description":""}],"id":"5b11db52-3113-43eb-b575-fc7aac30117c","_postman_id":"5b11db52-3113-43eb-b575-fc7aac30117c","description":""},{"name":"Smart Projects","item":[{"name":"Project management","item":[{"name":"Create Project","id":"4b79ebe3-5e92-4664-819a-0b933f090d16","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"title\": \"Cinema magazine 172\",\n\t\"key\": \"cinema-magazine-172\",\n \"track_ids\": [\n \"my-id-1\", \"my-id-2\", \"my-id-3\"\n ]\n}"},"url":"https://api.aimsapi.com/v1/project","description":"This endpoint allows you to create a new project. The key field needs to be unique and should not contain special characters.
You can create the project empty and add tracks later, or specify what tracks should be in the project directly when creating the project in the track_ids attribute (see the second example).
This endpoint allows you to list all projects in your account.
\n","urlObject":{"path":["v1","project"],"host":["https://api.aimsapi.com"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}],"variable":[]}},"response":[{"id":"79b15a92-5f0c-4a23-95a5-167b0f265b49","name":"List Projects","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.aimsapi.com/v1/project?page=1&page_size=10","host":["https://api.aimsapi.com"],"path":["v1","project"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 15:53:00 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"collections\": [\n {\n \"id\": \"4dc629e9-86d5-4aaa-994e-b3c6dbe2042a\",\n \"key\": \"cinema-magazine-172\",\n \"processed_at\": \"2022-01-04T19:37:11.000000Z\",\n \"title\": \"Cinema magazine 172\"\n },\n {\n \"id\": \"94cfd4b5-b48d-4149-a2a7-09287f199c89\",\n \"key\": \"any-key-you-like\",\n \"processed_at\": null,\n \"title\": \"Some new project\"\n }\n ],\n \"pagination\": {\n \"item_count\": 2,\n \"page\": 1,\n \"page_size\": 10,\n \"page_count\": 1\n }\n}"}],"_postman_id":"4e451dd8-d018-4aa1-ad80-4f062cbdc2e2"},{"name":"Get number of Projects","id":"818b8b77-0542-4308-a034-ef8e39c3bc1e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/project/length","description":"This endpoint allows you to obtain the total number of projects in your account.
\n","urlObject":{"path":["v1","project","length"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"4b67ebea-db77-490d-8bca-e4092c1dc9d1","name":"Get number of Projects","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/project/length"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 15:58:52 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"length\": 2\n}"}],"_postman_id":"818b8b77-0542-4308-a034-ef8e39c3bc1e"},{"name":"Get Project by Key","id":"1003c58e-7307-49eb-b7eb-8f3d829b99e0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/project/get/by-key/projectKey","description":"This endpoint allows you to get project information based on its key.
\n","urlObject":{"path":["v1","project","get","by-key","projectKey"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"786a65ef-df8d-4112-ae5f-26066313a130","name":"Get Project by Key","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/project/get/by-key/projectKey"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Thu, 06 Jan 2022 15:55:39 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"499","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Allow-Origin","value":"*","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"4dc629e9-86d5-4aaa-994e-b3c6dbe2042a\",\n \"key\": \"cinema-magazine-172\",\n \"processed_at\": null,\n \"title\": \"Cinema magazine 172\"\n }\n}"}],"_postman_id":"1003c58e-7307-49eb-b7eb-8f3d829b99e0"},{"name":"Get Project by ID","id":"dfa02ad0-7b88-42b6-96c7-3fa5200bd39a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/project/get/by-id/project.id","description":"This endpoint allows you to get project information based on its ID.
\n","urlObject":{"path":["v1","project","get","by-id","project.id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"cf147954-9050-4c7b-8647-d38c2f5a1656","name":"Get Project by ID","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/project/get/by-id/project.id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Thu, 06 Jan 2022 15:55:51 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"498","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Allow-Origin","value":"*","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"4dc629e9-86d5-4aaa-994e-b3c6dbe2042a\",\n \"key\": \"cinema-magazine-172\",\n \"processed_at\": null,\n \"title\": \"Cinema magazine 172\"\n }\n}"}],"_postman_id":"dfa02ad0-7b88-42b6-96c7-3fa5200bd39a"},{"name":"Get multiple Projects by ID","event":[{"listen":"test","script":{"id":"74c55210-b93b-432d-a758-b823d3cad241","type":"text/javascript","packages":{},"exec":[""]}}],"id":"fb3a04c5-ab25-4e24-9cb8-7a90d028ce3a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"collection_ids\": [\"project.id\", \"projectId2\", \"projectId3\"],\n \"groups\": true,\n \"detailed\": true,\n \"show_tracks\": true\n}"},"url":"https://api.aimsapi.com/v1/project/get/by-id","description":"Endpoint: POST https://api.aimsapi.com/v1/project/get/by-id
Description:
Retrieves detailed information about multiple projects (collections) by their IDs. This endpoint allows you to fetch project details, including group information and associated tracks, for a list of specified project IDs.
Request Body:
\nPlain Text
\n{\n\"collection_ids\": [\"{{projectId2}}\", \"{{projectId3}}\"],\n\"groups\": true,\n\"detailed\": true,\n\"show_tracks\": true\n}\n\ncollection_ids (array of strings): List of project IDs to retrieve.
groups (boolean): If true, includes group information.
detailed (boolean): If true, returns detailed project data.
show_tracks (boolean): If true, includes tracks associated with each project.
Headers:
\nContent-Type: application/json
X-Requested-With: XMLHttpRequest
Authorization: {{apiKey}}
Response:
\nid, title, and (if requested) tracks.Example Use Case:
Use this endpoint to fetch information about several projects at once, including their metadata and related tracks, for display in dashboards or bulk operations.
This endpoint allows you to update title of an existing project based on its key.
\n","urlObject":{"path":["v1","project","update","by-key","projectKey"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"5eb401e3-a234-4294-b5c1-28274eefbc49","name":"Update Project by Key","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"title\": \"Cinema magazine 172 - closed\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/project/update/by-key/projectKey"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Thu, 06 Jan 2022 16:03:36 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"499","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Allow-Origin","value":"*","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"4dc629e9-86d5-4aaa-994e-b3c6dbe2042a\",\n \"key\": \"cinema-magazine-172\",\n \"processed_at\": null,\n \"title\": \"Cinema magazine 172 - closed\"\n }\n}"}],"_postman_id":"700ee699-f1d3-4f81-baaa-604716f08648"},{"name":"Update Project by ID","id":"836adf2f-58d8-4598-b8cd-0c7502bc3260","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"title\": \"Cinema magazine 172 - closed\"\n}"},"url":"https://api.aimsapi.com/v1/project/update/by-id/project.id","description":"This endpoint allows you to update title of an existing project based on its ID (ID is generated automatically by AIMS when the project is craeted).
\n","urlObject":{"path":["v1","project","update","by-id","project.id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"587a595f-fa5d-4fc5-b8ea-fb166b61bc74","name":"Update Project by ID","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"title\": \"Cinema magazine 172 - closed\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/project/update/by-id/project.id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Thu, 06 Jan 2022 16:04:24 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"498","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Allow-Origin","value":"*","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"4dc629e9-86d5-4aaa-994e-b3c6dbe2042a\",\n \"key\": \"cinema-magazine-172\",\n \"processed_at\": null,\n \"title\": \"Cinema magazine 172 - closed\"\n }\n}"}],"_postman_id":"836adf2f-58d8-4598-b8cd-0c7502bc3260"},{"name":"Delete Project by Key","id":"c87153ab-eb73-46c8-856f-a2df1bd66865","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/project/delete/by-key/projectKey","description":"This endpoint allows you to delete a project based on its key.
\n","urlObject":{"path":["v1","project","delete","by-key","projectKey"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"7c00064b-4491-44a0-b5cb-67ecfbd86f82","name":"Delete Project by Key","originalRequest":{"method":"DELETE","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/project/delete/by-key/projectKey"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Thu, 06 Jan 2022 16:06:58 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"499","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Allow-Origin","value":"*","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Collection has been deleted.\"\n}"}],"_postman_id":"c87153ab-eb73-46c8-856f-a2df1bd66865"},{"name":"Delete Project by ID","id":"f980fa95-e4ff-4399-a1ef-021c89404fa3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/project/delete/by-id/project.id","description":"This endpoint allows you to delete a project based on its ID.
\n","urlObject":{"path":["v1","project","delete","by-id","project.id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"82a9941a-5553-4b1c-9efd-479ddcf4a587","name":"Delete Project by ID","originalRequest":{"method":"DELETE","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/project/delete/by-id/project.id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Thu, 06 Jan 2022 16:06:58 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"499","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Allow-Origin","value":"*","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Collection has been deleted.\"\n}"}],"_postman_id":"f980fa95-e4ff-4399-a1ef-021c89404fa3"}],"id":"2c70fc67-34d5-403c-81a2-8886521c01ff","_postman_id":"2c70fc67-34d5-403c-81a2-8886521c01ff","description":""},{"name":"Track management","item":[{"name":"Add Track to Project by ID","id":"fb199030-a40f-4952-82f9-273eb0e9575e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track_id\": \"my-id-1\",\n\t\"collection_key\": \"projectKey\",\n // add more tracks at once\n \"track_ids\": [\n \"my-id-1\", \"my-id-2\", \"my-id-2\"\n ]\n}"},"url":"https://api.aimsapi.com/v1/project/add-track/by-id","description":"This endpoint allows you to add an internal track (track already in your account) into the project. The track_id or track_ids only accept track client_id as a value!
You can add more than one track in a single request using the track_ids attribute. You can use either track_id or track_ids, or both.
This endpoint allows you to add track specified by a supported URL into the project. Please refer to Search similar tracks by URL for more information about supported services.
\nPlease note that adding a track from a link takes more time than adding an internal track. Similarly to the difference between internal search and search by URL. Please also note that only tracks up to 15 minutes are supported for performance reasons.
\n","urlObject":{"path":["v1","project","add-track","by-url"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"da94b119-1b32-4629-a8a4-533f77d85716","name":"Add Track to Project by URL","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"link\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\n\t\"collection_key\": \"projectKey\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/project/add-track/by-url"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 16:13:45 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Track successfully added\"\n}"}],"_postman_id":"659c4f7b-929c-40c1-b50e-33276b635bc9"},{"name":"Add Track to Project by file URL","id":"405b2ffe-954f-459e-b8c4-84c05f0be535","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n\t\"collection_key\": \"projectKey\"\n}"},"url":"https://api.aimsapi.com/v1/project/add-track/by-file-url","description":"This endpoint allows you to add track specified by a URL leading to a physical audio file into the project.
\n","urlObject":{"path":["v1","project","add-track","by-file-url"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"4266a658-2e47-475d-8bae-79b0549255bd","name":"Add Track to Project by file URL","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n\t\"collection_key\": \"projectKey\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/project/add-track/by-file-url"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 16:15:01 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Track successfully added\"\n}"}],"_postman_id":"405b2ffe-954f-459e-b8c4-84c05f0be535"},{"name":"Add Track to Project by file","id":"7357c13d-3e8d-4ee4-9c8a-a9d0c21f391f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"collection_key","value":"projectKey","type":"text"},{"key":"track","type":"file","src":"eva8WNxuR/Test001.mp3"}]},"url":"https://api.aimsapi.com/v1/project/add-track/by-file","description":"This endpoint allows you to add track specified by a physical audio file into the project.
\n","urlObject":{"path":["v1","project","add-track","by-file"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"d4ba8971-92cb-44bb-9244-f88f7c67aff5","name":"Add Track to Project by file","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"collection_key","value":"projectKey","type":"text"},{"key":"track","type":"file","src":"/Users/Shared/test.mp3"}]},"url":"https://api.aimsapi.com/v1/project/add-track/by-file"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 16:17:00 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Track successfully added\"\n}"}],"_postman_id":"7357c13d-3e8d-4ee4-9c8a-a9d0c21f391f"},{"name":"Get Tracks in Project by Key","id":"9e08f5f1-9751-4ff5-a488-4feacab00c61","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/project/get-tracks/by-key/projectKey","description":"This endpoint allows you to list all tracks currently present in the project specified by its key.
\n","urlObject":{"path":["v1","project","get-tracks","by-key","projectKey"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"810f4209-550f-4442-86b7-b7e7ad5df795","name":"Get Tracks in Project by Key","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/project/get-tracks/by-key/projectKey"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Thu, 06 Jan 2022 16:21:53 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"498","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Allow-Origin","value":"*","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"tracks\": [\n {\n \"id\": 142926076,\n \"id_client\": \"SPRT2#1\",\n \"duration\": 137,\n \"release_year\": 2007,\n \"track_name\": \"Beautiful You\",\n \"tags\": [\n \"SPRT\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null,\n \"artist_canonical\": \"olsanik-otakar\"\n },\n {\n \"id\": 153416810,\n \"id_client\": \"url:4c1971bb764b9b67d2fa93616dc30977\",\n \"duration\": 248,\n \"release_year\": null,\n \"track_name\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T16:13:59.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"NjZhNjc5ZDFmMDExMzUxNzU0MGJkZDE0NDM3Zjg0Mjk=\"\n },\n {\n \"id\": 153416812,\n \"id_client\": \"file-url:3b66521a25b139f18f6fd3c7bf2a05c0\",\n \"duration\": 27,\n \"release_year\": null,\n \"track_name\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T16:15:03.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"MTlmMTUwNmEzNWY4OTE5NTg5OTJkZGE1NDIzMWI2YWI=\"\n },\n {\n \"id\": 153416813,\n \"id_client\": \"file:0003b70cc761b60b32c9eab85845c961\",\n \"duration\": 61,\n \"release_year\": null,\n \"track_name\": \"0003b70cc761b60b32c9eab85845c961.mp3\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T16:17:05.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"Zjg3YTQ5MGI0OWNmMDZmMDQ5OTE5YzE5NGMzNGViNDA=\"\n }\n ],\n \"pagination\": {\n \"item_count\": 4,\n \"page\": 1,\n \"page_size\": 4,\n \"page_count\": 1\n }\n}"}],"_postman_id":"9e08f5f1-9751-4ff5-a488-4feacab00c61"},{"name":"Get Tracks in Project by ID","id":"e9edf505-cafa-46ab-b21c-793a643003e8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/project/get-tracks/by-id/project.id","description":"This endpoint allows you to list all tracks currently present in the project specified by its ID.
\n","urlObject":{"path":["v1","project","get-tracks","by-id","project.id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"42882dc8-8405-42ac-9470-2415f0dcc4f3","name":"Get Tracks in Project by ID","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/project/get-tracks/by-id/project.id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Thu, 06 Jan 2022 16:22:53 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"499","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Allow-Origin","value":"*","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"tracks\": [\n {\n \"id\": 142926076,\n \"id_client\": \"SPRT2#1\",\n \"duration\": 137,\n \"release_year\": 2007,\n \"track_name\": \"Beautiful You\",\n \"tags\": [\n \"SPRT\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null,\n \"artist_canonical\": \"olsanik-otakar\"\n },\n {\n \"id\": 153416810,\n \"id_client\": \"url:4c1971bb764b9b67d2fa93616dc30977\",\n \"duration\": 248,\n \"release_year\": null,\n \"track_name\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T16:13:59.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"NjZhNjc5ZDFmMDExMzUxNzU0MGJkZDE0NDM3Zjg0Mjk=\"\n },\n {\n \"id\": 153416812,\n \"id_client\": \"file-url:3b66521a25b139f18f6fd3c7bf2a05c0\",\n \"duration\": 27,\n \"release_year\": null,\n \"track_name\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T16:15:03.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"MTlmMTUwNmEzNWY4OTE5NTg5OTJkZGE1NDIzMWI2YWI=\"\n },\n {\n \"id\": 153416813,\n \"id_client\": \"file:0003b70cc761b60b32c9eab85845c961\",\n \"duration\": 61,\n \"release_year\": null,\n \"track_name\": \"0003b70cc761b60b32c9eab85845c961.mp3\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T16:17:05.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"Zjg3YTQ5MGI0OWNmMDZmMDQ5OTE5YzE5NGMzNGViNDA=\"\n }\n ],\n \"pagination\": {\n \"item_count\": 4,\n \"page\": 1,\n \"page_size\": 4,\n \"page_count\": 1\n }\n}"}],"_postman_id":"e9edf505-cafa-46ab-b21c-793a643003e8"},{"name":"Remove Track from Project","id":"a2156b66-f93f-483d-b569-3124cec0973b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track_id\": \"my-id-1\",\n\t\"collection_key\": \"projectKey\"\n}"},"url":"https://api.aimsapi.com/v1/project/remove-track/by-id","description":"This endpoint allows you to remove a track from a project. To remove external tracks (tracks added by URL, file URL or file), use the id_client value of respective track (e.g. url:9aacbc9479f4baf2684fc82536422808).
This endpoint allows you to obtain suggestions of tracks to add to the project specified by its key. The results are sorted from the most recommended tracks.
\n","urlObject":{"path":["v1","project","suggest","by-key"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"43a6a629-68eb-4ffe-8d02-016b47cbeff6","name":"Suggest Tracks into Project by Key","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"key\": \"projectKey\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/project/suggest/by-key"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 16:28:25 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"05a13f53-4048-4128-94c3-5f665abc7297\",\n \"tracks\": [\n {\n \"id\": 143405091,\n \"id_client\": \"ZIK386#14\",\n \"duration\": 210,\n \"release_year\": 2013,\n \"track_name\": \"Give Me (Instru)\",\n \"tags\": [\n \"ZIK\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n ...\n {\n \"id\": 142569672,\n \"id_client\": \"NSPS226#45\",\n \"duration\": 124,\n \"release_year\": 2016,\n \"track_name\": \"Siesta Sun\",\n \"tags\": [\n \"NSPS\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n }\n ]\n}"}],"_postman_id":"bc6c643d-4cd8-429a-89e8-c606cbcb70ca"},{"name":"Suggest Tracks into Project by ID","id":"f84c8ddd-f5c0-4206-8b93-a7d1466a6674","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"project.id\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}"},"url":"https://api.aimsapi.com/v1/project/suggest/by-id","description":"This endpoint allows you to obtain suggestions of tracks to add to the project specified by its ID. The results are sorted from the most recommended tracks.
\n","urlObject":{"path":["v1","project","suggest","by-id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"cb04417b-c97a-44b0-bb0a-71717c9ff1ed","name":"Suggest Tracks into Project by ID","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"project.id\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/project/suggest/by-id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 16:29:56 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"497"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"41f8d79f-b2f0-44ad-b1ba-898bebe1b05c\",\n \"tracks\": [\n {\n \"id\": 143405091,\n \"id_client\": \"ZIK386#14\",\n \"duration\": 210,\n \"release_year\": 2013,\n \"track_name\": \"Give Me (Instru)\",\n \"tags\": [\n \"ZIK\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n ...\n {\n \"id\": 142569672,\n \"id_client\": \"NSPS226#45\",\n \"duration\": 124,\n \"release_year\": 2016,\n \"track_name\": \"Siesta Sun\",\n \"tags\": [\n \"NSPS\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n }\n ]\n}"}],"_postman_id":"f84c8ddd-f5c0-4206-8b93-a7d1466a6674"}],"id":"1c87015a-7b03-48ac-8d23-8727defc125a","_postman_id":"1c87015a-7b03-48ac-8d23-8727defc125a","description":""},{"name":"Filtering","item":[{"name":"Suggest Tracks into Project by Key","id":"18cdcdb5-8c52-4bad-b035-51fe446bc81c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"key\": \"projectKey\",\n\t\"page\": 1,\n\t\"page_size\": 20,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 60\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"logic\": \"or\",\n\t\t\t\t\"conditions\": [\n\t\t\t\t\t{\n\t\t\t\t \"field\": \"tags\",\n\t\t\t\t \"operator\": \"in\",\n\t\t\t\t \"value\": [\n \"guitar\",\n \"drums\",\n \"piano\"\n ]\n\t\t\t },\n\t\t\t\t\t{\n\t\t\t\t\t\t\"field\": \"track_name\",\n\t\t\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\t\t\"value\": \"Play\"\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t}\n\t\t]\n\t}\n}"},"url":"https://api.aimsapi.com/v1/project/suggest/by-key","urlObject":{"path":["v1","project","suggest","by-key"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"4fbb11d7-ab6e-41d8-a7e4-784bbaf4531d","name":"Suggest Tracks into Project by Key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"key\": \"projectKey\",\n\t\"page\": 1,\n\t\"page_size\": 20,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 60\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"logic\": \"or\",\n\t\t\t\t\"conditions\": [\n\t\t\t\t\t{\n\t\t\t\t \"field\": \"tags\",\n\t\t\t\t \"operator\": \"in\",\n\t\t\t\t \"value\": [\n \"guitar\",\n \"drums\",\n \"piano\"\n ]\n\t\t\t },\n\t\t\t\t\t{\n\t\t\t\t\t\t\"field\": \"track_name\",\n\t\t\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\t\t\"value\": \"Play\"\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t}\n\t\t]\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/project/suggest/by-key"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.19.10"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"X-Powered-By","value":"PHP/7.4.13"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 06 Jan 2022 16:28:25 GMT"},{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"499"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"05a13f53-4048-4128-94c3-5f665abc7297\",\n \"tracks\": [\n {\n \"id\": 143405091,\n \"id_client\": \"ZIK386#14\",\n \"duration\": 210,\n \"release_year\": 2013,\n \"track_name\": \"Give Me (Instru)\",\n \"tags\": [\n \"ZIK\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n ...\n {\n \"id\": 142569672,\n \"id_client\": \"NSPS226#45\",\n \"duration\": 124,\n \"release_year\": 2016,\n \"track_name\": \"Siesta Sun\",\n \"tags\": [\n \"NSPS\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n }\n ]\n}"}],"_postman_id":"18cdcdb5-8c52-4bad-b035-51fe446bc81c"},{"name":"Suggest Tracks into Project by ID","id":"0247b403-a0f1-4bdc-b969-fcddcd36db3c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"project.id\",\n\t\"page\": 1,\n\t\"page_size\": 20,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 60\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"logic\": \"or\",\n\t\t\t\t\"conditions\": [\n\t\t\t\t\t{\n\t\t\t\t \"field\": \"tags\",\n\t\t\t\t \"operator\": \"in\",\n\t\t\t\t \"value\": [\n \"guitar\",\n \"drums\",\n \"piano\"\n ]\n\t\t\t },\n\t\t\t\t\t{\n\t\t\t\t\t\t\"field\": \"track_name\",\n\t\t\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\t\t\"value\": \"Play\"\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t}\n\t\t]\n\t}\n}"},"url":"https://api.aimsapi.com/v1/project/suggest/by-id","urlObject":{"path":["v1","project","suggest","by-id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"a9da99e4-e360-4308-8798-f9530a18654d","name":"Suggest Tracks into Project by ID","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"project.id\",\n\t\"page\": 1,\n\t\"page_size\": 20,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 60\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"logic\": \"or\",\n\t\t\t\t\"conditions\": [\n\t\t\t\t\t{\n\t\t\t\t \"field\": \"tags\",\n\t\t\t\t \"operator\": \"in\",\n\t\t\t\t \"value\": [\n \"guitar\",\n \"drums\",\n \"piano\"\n ]\n\t\t\t },\n\t\t\t\t\t{\n\t\t\t\t\t\t\"field\": \"track_name\",\n\t\t\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\t\t\"value\": \"Play\"\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t}\n\t\t]\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/project/suggest/by-id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.19.10"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"X-Powered-By","value":"PHP/7.4.13"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 06 Jan 2022 16:29:56 GMT"},{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"497"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"41f8d79f-b2f0-44ad-b1ba-898bebe1b05c\",\n \"tracks\": [\n {\n \"id\": 143405091,\n \"id_client\": \"ZIK386#14\",\n \"duration\": 210,\n \"release_year\": 2013,\n \"track_name\": \"Give Me (Instru)\",\n \"tags\": [\n \"ZIK\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n ...\n {\n \"id\": 142569672,\n \"id_client\": \"NSPS226#45\",\n \"duration\": 124,\n \"release_year\": 2016,\n \"track_name\": \"Siesta Sun\",\n \"tags\": [\n \"NSPS\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n }\n ]\n}"}],"_postman_id":"0247b403-a0f1-4bdc-b969-fcddcd36db3c"}],"id":"a2d59ba2-2315-475f-b7e0-b26e32aeb1cd","_postman_id":"a2d59ba2-2315-475f-b7e0-b26e32aeb1cd","description":""}],"id":"b1771f41-801c-436c-a76e-15e32d8893e7","_postman_id":"b1771f41-801c-436c-a76e-15e32d8893e7","description":""},{"name":"Playlists","item":[{"name":"Playlist management","item":[{"name":"Create Playlist","id":"67f9fad3-f9f6-40cb-bd9e-0d1d5349a465","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"title\": \"Car commercials\",\n\t\"key\": \"car-commercials\",\n \"track_ids\": [\n \"my-id-1\", \"my-id-2\", \"my-id-3\"\n ]\n}"},"url":"https://api.aimsapi.com/v1/playlist","description":"This endpoint allows you to create a new project. The key field needs to be unique and should not contain special characters.
You can create the playlist empty and add tracks later, or specify what tracks should be in the playlist directly when creating the playlist in the track_ids attribute (see the second example).
This endpoint allows you to list all projects in your account.
\n","urlObject":{"path":["v1","playlist"],"host":["https://api.aimsapi.com"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}],"variable":[]}},"response":[{"id":"835beaa8-f0fd-419a-a077-6c4f12dfdcfe","name":"List Playlists","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.aimsapi.com/v1/playlist?page=1&page_size=10","host":["https://api.aimsapi.com"],"path":["v1","playlist"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 15:53:00 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"collections\": [\n {\n \"id\": \"4dc629e9-86d5-4aaa-994e-b3c6dbe2042a\",\n \"key\": \"car-commercials\",\n \"processed_at\": \"2022-01-04T19:37:11.000000Z\",\n \"title\": \"Car commercials\"\n },\n {\n \"id\": \"94cfd4b5-b48d-4149-a2a7-09287f199c89\",\n \"key\": \"any-key-you-like\",\n \"processed_at\": null,\n \"title\": \"Some new playlist\"\n }\n ],\n \"pagination\": {\n \"item_count\": 2,\n \"page\": 1,\n \"page_size\": 10,\n \"page_count\": 1\n }\n}"}],"_postman_id":"496e6e0e-2abd-4336-b5d0-75b8cf386f5e"},{"name":"Get number of Playlists","id":"385b326c-8489-4097-abae-e438d01449dc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/playlist/length","description":"This endpoint allows you to obtain the total number of projects in your account.
\n","urlObject":{"path":["v1","playlist","length"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"9d23f7c1-10da-4729-9fc6-ddaabe1b1078","name":"Get number of Projects","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/playlist/length"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 15:58:52 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"length\": 2\n}"}],"_postman_id":"385b326c-8489-4097-abae-e438d01449dc"},{"name":"Get Playlist by Key","id":"4b5768ab-c582-4967-816a-e9ec94869bd4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/playlist/get/by-key/playlist.key","description":"This endpoint allows you to get project information based on its key.
\n","urlObject":{"path":["v1","playlist","get","by-key","playlist.key"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"5a5d0586-8b9c-4373-ac37-d40cbd3f49cd","name":"Get Playlist by Key","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/playlist/get/by-key/playlist.key"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Thu, 06 Jan 2022 15:55:39 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"499","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Allow-Origin","value":"*","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"4dc629e9-86d5-4aaa-994e-b3c6dbe2042a\",\n \"key\": \"car-commercials\",\n \"processed_at\": null,\n \"title\": \"Car commercials\"\n }\n}"}],"_postman_id":"4b5768ab-c582-4967-816a-e9ec94869bd4"},{"name":"Get Playlist by ID","id":"fc8967e4-960e-45c3-a29e-f2b20272a1f8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/playlist/get/by-id/playlistId","description":"This endpoint allows you to get project information based on its ID.
\n","urlObject":{"path":["v1","playlist","get","by-id","playlistId"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"c1f34f79-1fa6-4b0c-8128-6888794e2b23","name":"Get Playlist by ID","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/playlist/get/by-id/playlistId"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Thu, 06 Jan 2022 15:55:51 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"498","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Allow-Origin","value":"*","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"4dc629e9-86d5-4aaa-994e-b3c6dbe2042a\",\n \"key\": \"car-commercials\",\n \"processed_at\": null,\n \"title\": \"Car commercials\"\n }\n}"}],"_postman_id":"fc8967e4-960e-45c3-a29e-f2b20272a1f8"},{"name":"Update Playlist by Key","id":"4aff1822-99b9-4528-a409-cb3f25afb570","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"title\": \"Car commercials - Vintage\"\n}"},"url":"https://api.aimsapi.com/v1/playlist/update/by-key/playlist.key","description":"This endpoint allows you to update title of an existing project based on its key.
\n","urlObject":{"path":["v1","playlist","update","by-key","playlist.key"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"f1854729-3fc7-4ee3-97cd-e35fdf625159","name":"Update Playlist by Key","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"title\": \"Car commercials - Vintage\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/update/by-key/playlist.key"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Thu, 06 Jan 2022 16:03:36 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"499","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Allow-Origin","value":"*","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"4dc629e9-86d5-4aaa-994e-b3c6dbe2042a\",\n \"key\": \"car-commercials\",\n \"processed_at\": null,\n \"title\": \"Car commercials - Vintage\"\n }\n}"}],"_postman_id":"4aff1822-99b9-4528-a409-cb3f25afb570"},{"name":"Update Playlist by ID","id":"849edb8d-a9b9-41d0-bb1e-1c925ebfb455","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"title\": \"Car commercials - Vintage\"\n}"},"url":"https://api.aimsapi.com/v1/playlist/update/by-id/playlistId","description":"This endpoint allows you to update title of an existing project based on its ID (ID is generated automatically by AIMS when the project is craeted).
\n","urlObject":{"path":["v1","playlist","update","by-id","playlistId"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"cbac9ebf-60e2-495d-9fb4-593f7708364f","name":"Update Playlist by ID","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"title\": \"Car commercials - Vintage\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/update/by-id/playlistId"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Thu, 06 Jan 2022 16:04:24 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"498","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Allow-Origin","value":"*","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"4dc629e9-86d5-4aaa-994e-b3c6dbe2042a\",\n \"key\": \"car-commercials\",\n \"processed_at\": null,\n \"title\": \"Car commercials - Vintage\"\n }\n}"}],"_postman_id":"849edb8d-a9b9-41d0-bb1e-1c925ebfb455"},{"name":"Delete Playlist by Key","id":"f38c9612-bc91-45ce-877f-7e1da879d017","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/playlist/delete/by-key/playlist.key","description":"This endpoint allows you to delete a project based on its key.
\n","urlObject":{"path":["v1","playlist","delete","by-key","playlist.key"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"f5ad8f1a-e7ea-4be6-a333-8d68d6dfb383","name":"Delete Playlist by Key","originalRequest":{"method":"DELETE","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/playlist/delete/by-key/playlist.key"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Thu, 06 Jan 2022 16:06:58 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"499","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Allow-Origin","value":"*","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Collection has been deleted.\"\n}"}],"_postman_id":"f38c9612-bc91-45ce-877f-7e1da879d017"},{"name":"Delete Playlist by ID","id":"a43aa349-0380-4748-a5d2-0db2e518a9e2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/playlist/delete/by-id/playlistId","description":"This endpoint allows you to delete a project based on its ID.
\n","urlObject":{"path":["v1","playlist","delete","by-id","playlistId"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"22eb807c-6536-4488-b7e1-792c38c987b1","name":"Delete Playlist by ID","originalRequest":{"method":"DELETE","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/playlist/delete/by-id/playlistId"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Server","value":"nginx/1.19.10","description":{"content":"","type":"text/plain"}},{"key":"Transfer-Encoding","value":"chunked","description":{"content":"","type":"text/plain"}},{"key":"X-Powered-By","value":"PHP/7.4.13","description":{"content":"","type":"text/plain"}},{"key":"Cache-Control","value":"no-cache, private","description":{"content":"","type":"text/plain"}},{"key":"Date","value":"Thu, 06 Jan 2022 16:06:58 GMT","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Limit","value":"500","description":{"content":"","type":"text/plain"}},{"key":"X-RateLimit-Remaining","value":"499","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Allow-Origin","value":"*","description":{"content":"","type":"text/plain"}},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length","description":{"content":"","type":"text/plain"}},{"key":"Via","value":"1.1 google","description":{"content":"","type":"text/plain"}},{"key":"Alt-Svc","value":"clear","description":{"content":"","type":"text/plain"}}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Collection has been deleted.\"\n}"}],"_postman_id":"a43aa349-0380-4748-a5d2-0db2e518a9e2"}],"id":"5b48a890-801c-464a-a117-c9a498230cea","_postman_id":"5b48a890-801c-464a-a117-c9a498230cea","description":""},{"name":"Track management","item":[{"name":"Add Track to Playlist by ID","id":"b85772a2-99be-4e08-96d9-e3a7c522a9d3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track_id\": \"my-id-1\",\n\t\"collection_key\": \"playlist.key\",\n // add more tracks at once\n \"track_ids\": [\n \"my-id-1\", \"my-id-2\", \"my-id-2\"\n ]\n}"},"url":"https://api.aimsapi.com/v1/playlist/add-track/by-id","description":"This endpoint allows you to add an internal track (track already in your account) into the playlist.The track_id or track_ids only accept track client_id as a value!
You can add more than one track in a single request using the track_ids attribute. You can use either track_id or track_ids, or both.
This endpoint allows you to add track specified by a supported URL into the project. Please refer to Search similar tracks by URL for more information about supported services.
\nPlease note that adding a track from a link takes more time than adding an internal track. Similarly to the difference between internal search and search by URL. Please also note that only tracks up to 15 minutes are supported for performance reasons.
\n","urlObject":{"path":["v1","playlist","add-track","by-url"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"45ead4d1-45ac-4469-b050-bc5c0abaef31","name":"Add Track to Playlist by URL","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"link\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\n\t\"collection_key\": \"playlist.key\"\n}"},"url":"https://api.aimsapi.com/v1/playlist/add-track/by-url"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 16:13:45 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Track successfully added\"\n}"}],"_postman_id":"5efdf36f-5f95-418d-b2a7-789eee0680ef"},{"name":"Add Track to Playlist by file URL","id":"230e8a68-97a8-470e-ba37-34695bc3d15d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n\t\"collection_key\": \"playlist.key\"\n}"},"url":"https://api.aimsapi.com/v1/playlist/add-track/by-file-url","description":"This endpoint allows you to add track specified by a URL leading to a physical audio file into the project.
\n","urlObject":{"path":["v1","playlist","add-track","by-file-url"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"2051a3fe-a6f8-421a-a2ce-88e889e66902","name":"Add Track to Playlist by file URL","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n\t\"collection_key\": \"playlist.key\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/add-track/by-file-url"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 16:15:01 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Track successfully added\"\n}"}],"_postman_id":"230e8a68-97a8-470e-ba37-34695bc3d15d"},{"name":"Add Track to Playlist by file","id":"0af0a42e-f1c8-4bfa-a7a4-b98eb00be051","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"collection_key","value":"playlist.key","type":"text"},{"key":"track","type":"file","src":"odMvqwmS4/000197974f3cb1b8e98699903649c0c6.mp3"}]},"url":"https://api.aimsapi.com/v1/playlist/add-track/by-file","description":"This endpoint allows you to add track specified by a physical audio file into the project.
\n","urlObject":{"path":["v1","playlist","add-track","by-file"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"878d76a6-fea2-41e7-9595-c96a74c09642","name":"Add Track to Playlist by file","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"collection_key","value":"playlist.key","type":"text"},{"key":"track","type":"file","src":"/Users/Shared/test.mp3"}]},"url":"https://api.aimsapi.com/v1/playlist/add-track/by-file"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 16:17:00 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Track successfully added\"\n}"}],"_postman_id":"0af0a42e-f1c8-4bfa-a7a4-b98eb00be051"},{"name":"Get Tracks in Playlist by Key","id":"95df10c4-ae87-4947-aaff-54d7061a3f5b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/playlist/get-tracks/by-key/:playlist.key","description":"This endpoint allows you to list all tracks currently present in the project specified by its key.
\n","urlObject":{"path":["v1","playlist","get-tracks","by-key",":playlist.key"],"host":["https://api.aimsapi.com"],"query":[],"variable":[{"type":"any","key":"playlist"},{"type":"any","value":"playlist.key","key":"playlist.key"}]}},"response":[{"id":"99704566-7ecb-422a-bc2c-9cc88cd96b44","name":"Get Tracks in Playlist by Key","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.aimsapi.com/v1/playlist/get-tracks/by-key/:playlist.key","host":["https://api.aimsapi.com"],"path":["v1","playlist","get-tracks","by-key",":playlist.key"],"variable":[{"key":"playlist.key","value":"playlistKey"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 16:21:53 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"498"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"tracks\": [\n {\n \"id\": 142926076,\n \"id_client\": \"SPRT2#1\",\n \"duration\": 137,\n \"release_year\": 2007,\n \"track_name\": \"Beautiful You\",\n \"tags\": [\n \"SPRT\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null,\n \"artist_canonical\": \"olsanik-otakar\"\n },\n {\n \"id\": 153416810,\n \"id_client\": \"url:4c1971bb764b9b67d2fa93616dc30977\",\n \"duration\": 248,\n \"release_year\": null,\n \"track_name\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T16:13:59.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"NjZhNjc5ZDFmMDExMzUxNzU0MGJkZDE0NDM3Zjg0Mjk=\"\n },\n {\n \"id\": 153416812,\n \"id_client\": \"file-url:3b66521a25b139f18f6fd3c7bf2a05c0\",\n \"duration\": 27,\n \"release_year\": null,\n \"track_name\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T16:15:03.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"MTlmMTUwNmEzNWY4OTE5NTg5OTJkZGE1NDIzMWI2YWI=\"\n },\n {\n \"id\": 153416813,\n \"id_client\": \"file:0003b70cc761b60b32c9eab85845c961\",\n \"duration\": 61,\n \"release_year\": null,\n \"track_name\": \"0003b70cc761b60b32c9eab85845c961.mp3\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T16:17:05.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"Zjg3YTQ5MGI0OWNmMDZmMDQ5OTE5YzE5NGMzNGViNDA=\"\n }\n ],\n \"pagination\": {\n \"item_count\": 4,\n \"page\": 1,\n \"page_size\": 4,\n \"page_count\": 1\n }\n}"}],"_postman_id":"95df10c4-ae87-4947-aaff-54d7061a3f5b"},{"name":"Get Tracks in Playlist by ID","id":"bdd8ec48-e3f4-4450-ba05-e108e99f5dc2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/playlist/get-tracks/by-id/:playlist.id","description":"This endpoint allows you to list all tracks currently present in the project specified by its ID.
\n","urlObject":{"path":["v1","playlist","get-tracks","by-id",":playlist.id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[{"type":"any","key":"playlist"},{"type":"any","value":"playlistId","key":"playlist.id"}]}},"response":[{"id":"35a45eed-4f27-4ef2-845c-e34e8fe02688","name":"Get Tracks in Playlist by ID","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.aimsapi.com/v1/playlist/get-tracks/by-id/:playlist.id","host":["https://api.aimsapi.com"],"path":["v1","playlist","get-tracks","by-id",":playlist.id"],"variable":[{"key":"playlist.id","value":"playlistId"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 16:22:53 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"tracks\": [\n {\n \"id\": 142926076,\n \"id_client\": \"SPRT2#1\",\n \"duration\": 137,\n \"release_year\": 2007,\n \"track_name\": \"Beautiful You\",\n \"tags\": [\n \"SPRT\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null,\n \"artist_canonical\": \"olsanik-otakar\"\n },\n {\n \"id\": 153416810,\n \"id_client\": \"url:4c1971bb764b9b67d2fa93616dc30977\",\n \"duration\": 248,\n \"release_year\": null,\n \"track_name\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T16:13:59.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"NjZhNjc5ZDFmMDExMzUxNzU0MGJkZDE0NDM3Zjg0Mjk=\"\n },\n {\n \"id\": 153416812,\n \"id_client\": \"file-url:3b66521a25b139f18f6fd3c7bf2a05c0\",\n \"duration\": 27,\n \"release_year\": null,\n \"track_name\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T16:15:03.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"MTlmMTUwNmEzNWY4OTE5NTg5OTJkZGE1NDIzMWI2YWI=\"\n },\n {\n \"id\": 153416813,\n \"id_client\": \"file:0003b70cc761b60b32c9eab85845c961\",\n \"duration\": 61,\n \"release_year\": null,\n \"track_name\": \"0003b70cc761b60b32c9eab85845c961.mp3\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T16:17:05.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"Zjg3YTQ5MGI0OWNmMDZmMDQ5OTE5YzE5NGMzNGViNDA=\"\n }\n ],\n \"pagination\": {\n \"item_count\": 4,\n \"page\": 1,\n \"page_size\": 4,\n \"page_count\": 1\n }\n}"}],"_postman_id":"bdd8ec48-e3f4-4450-ba05-e108e99f5dc2"},{"name":"Remove Track from Playlist","id":"79901729-000a-4c40-8f8d-656d555fc7cb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track_id\": \"SPRT2#1\",\n\t\"collection_key\": \"playlist.key\"\n}"},"url":"https://api.aimsapi.com/v1/playlist/remove-track/by-id","description":"This endpoint allows you to remove a track from a project. To remove external tracks (tracks added by URL, file URL or file), use the id_client value of respective track (e.g. url:9aacbc9479f4baf2684fc82536422808).
This endpoint allows you to obtain suggestions of tracks to add to the project specified by its key. The results are sorted from the most recommended tracks.
\n","urlObject":{"path":["v1","playlist","suggest","by-key"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"731cfd87-4093-4bd0-8f68-06665476db65","name":"Suggest Tracks into Playlist by Key","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"key\": \"playlist.key\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/suggest/by-key"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 16:28:25 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"05a13f53-4048-4128-94c3-5f665abc7297\",\n \"tracks\": [\n {\n \"id\": 143405091,\n \"id_client\": \"ZIK386#14\",\n \"duration\": 210,\n \"release_year\": 2013,\n \"track_name\": \"Give Me (Instru)\",\n \"tags\": [\n \"ZIK\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n ...\n {\n \"id\": 142569672,\n \"id_client\": \"NSPS226#45\",\n \"duration\": 124,\n \"release_year\": 2016,\n \"track_name\": \"Siesta Sun\",\n \"tags\": [\n \"NSPS\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n }\n ]\n}"}],"_postman_id":"eefad39b-9493-4658-9101-aecd5cfaedda"},{"name":"Suggest Tracks into Playlist by ID","id":"8ee1b5a7-4595-469f-bcdc-97e90c1a158b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"playlistId\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}"},"url":"https://api.aimsapi.com/v1/playlist/suggest/by-id","description":"This endpoint allows you to obtain suggestions of tracks to add to the project specified by its ID. The results are sorted from the most recommended tracks.
\n","urlObject":{"path":["v1","playlist","suggest","by-id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"2d7029b2-93ea-4334-99d7-cc30f1d19bda","name":"Suggest Tracks into Playlist by ID","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"playlistId\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/suggest/by-id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 16:29:56 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"497"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"41f8d79f-b2f0-44ad-b1ba-898bebe1b05c\",\n \"tracks\": [\n {\n \"id\": 143405091,\n \"id_client\": \"ZIK386#14\",\n \"duration\": 210,\n \"release_year\": 2013,\n \"track_name\": \"Give Me (Instru)\",\n \"tags\": [\n \"ZIK\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n ...\n {\n \"id\": 142569672,\n \"id_client\": \"NSPS226#45\",\n \"duration\": 124,\n \"release_year\": 2016,\n \"track_name\": \"Siesta Sun\",\n \"tags\": [\n \"NSPS\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n }\n ]\n}"}],"_postman_id":"8ee1b5a7-4595-469f-bcdc-97e90c1a158b"}],"id":"0b75428f-bfa0-4c1f-83b2-e137de929509","_postman_id":"0b75428f-bfa0-4c1f-83b2-e137de929509","description":""},{"name":"Similarity Search","item":[{"name":"Search Similar Playlists by Key","id":"6a33c82b-b79d-4be8-86af-c94291c5f922","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"key\": \"playlist.key\"\n}"},"url":"https://api.aimsapi.com/v1/playlist/similar/by-key?page=1&page_size=10","description":"This endpoint allows you to search for similar artists based on a seed artist specified by its key (key is generated from your tracks metadata by AIMS).
\n","urlObject":{"path":["v1","playlist","similar","by-key"],"host":["https://api.aimsapi.com"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}],"variable":[]}},"response":[{"id":"caefb7e0-b644-4651-8094-1f2861d33015","name":"Search Similar Playlist by Key","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"key\": \"playlist.key\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.aimsapi.com/v1/playlist/similar/by-key?page=1&page_size=10","host":["https://api.aimsapi.com"],"path":["v1","playlist","similar","by-key"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Mon, 04 Oct 2021 19:18:14 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"0398e245-6d99-4e3b-888e-63f2614e6c55\",\n \"collections\": [\n {\n \"id\": \"6d20198d-c759-45df-883d-7824af7e92a9\",\n \"key\": \"luxury-commercials\",\n \"processed_at\": \"2021-08-11T11:17:30.000000Z\",\n \"title\": \"Luxury Commercials\"\n },\n {\n \"id\": \"7220dbae-7ce1-40e8-b0a9-d756d15d2fbf\",\n \"key\": \"action-trailers\",\n \"processed_at\": \"2021-08-11T11:17:53.000000Z\",\n \"title\": \"Action Trailers\"\n },\n ...\n ]\n}"}],"_postman_id":"6a33c82b-b79d-4be8-86af-c94291c5f922"},{"name":"Search Similar Playlists by ID","id":"f8d7c421-35ac-49d1-9b1e-1edf2190f494","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"playlistId\"\n}"},"url":"https://api.aimsapi.com/v1/playlist/similar/by-id?page=1&page_size=10","urlObject":{"path":["v1","playlist","similar","by-id"],"host":["https://api.aimsapi.com"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}],"variable":[]}},"response":[{"id":"bda276dc-6bf3-49e1-830c-f0a27c522959","name":"Search Similar Playlists by ID","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id\": \"playlistId\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.aimsapi.com/v1/playlist/similar/by-id?page=1&page_size=10","host":["https://api.aimsapi.com"],"path":["v1","playlist","similar","by-id"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Mon, 04 Oct 2021 19:18:19 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"498"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"0398e245-6d99-4e3b-888e-63f2614e6c55\",\n \"collections\": [\n {\n \"id\": \"6d20198d-c759-45df-883d-7824af7e92a9\",\n \"key\": \"luxury-commercials\",\n \"processed_at\": \"2021-08-11T11:17:30.000000Z\",\n \"title\": \"Luxury Commercials\"\n },\n {\n \"id\": \"7220dbae-7ce1-40e8-b0a9-d756d15d2fbf\",\n \"key\": \"action-trailers\",\n \"processed_at\": \"2021-08-11T11:17:53.000000Z\",\n \"title\": \"Action Trailers\"\n },\n ...\n ]\n}"}],"_postman_id":"f8d7c421-35ac-49d1-9b1e-1edf2190f494"}],"id":"c2094ee2-9589-43dd-a535-93f675f1af4c","_postman_id":"c2094ee2-9589-43dd-a535-93f675f1af4c","description":""},{"name":"Playlist Plugging","item":[{"name":"Search for Playlists to Plug a Track into by ID","id":"4f9d6fd1-1565-43c8-bf36-f99e363355aa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track_id\": \"{{track.id}}\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}"},"url":"https://api.aimsapi.com/v1/playlist/plug/by-id","description":"This endpoint allows you to obtain suggestions of playlists to plug your track into by the ID of the track. The results are sorted from the most suitable playlists.
\n","urlObject":{"path":["v1","playlist","plug","by-id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"53675ed4-e901-48e3-ae0f-141137357b73","name":"Search for Playlists to Plug a Track into by ID","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track_id\": \"{{track.id}}\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/plug/by-id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length, X-Hash"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Fri, 28 Jul 2023 20:49:17 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-Ratelimit-Limit","value":"10000"},{"description":{"content":"","type":"text/plain"},"key":"X-Ratelimit-Remaining","value":"9998"},{"description":{"content":"","type":"text/plain"},"key":"X-Remaining-Monthly-Credits","value":"5506"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"a0c39de8-3113-4e37-96af-90d67f8a1b39\",\n \"collections\": [\n {\n \"id\": \"4a6eee17-649c-4dbd-95b8-93037fe7d191\",\n \"key\": \"1A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-03T22:55:49.000000Z\",\n \"updated_at\": \"2023-06-02T09:29:13.000000Z\",\n \"title\": \"The Playlist\"\n },\n ...\n {\n \"id\": \"3c594889-d24a-4656-86c3-9ef776738eb6\",\n \"key\": \"0A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-09T03:55:50.000000Z\",\n \"updated_at\": \"2023-03-10T13:51:54.000000Z\",\n \"title\": \"The Playlist, just better\"\n }\n ]\n}"}],"_postman_id":"4f9d6fd1-1565-43c8-bf36-f99e363355aa"},{"name":"Search for Playlists to Plug a Track into by URL","id":"3f8b7c54-8220-4877-9fd2-cd65d76b317d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"link\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}"},"url":"https://api.aimsapi.com/v1/playlist/plug/by-url","description":"This endpoint allows you to obtain suggestions of playlists to plug your track into by a URL. Please refer to Search similar tracks by URL for more information about supported services. The results are sorted from the most suitable playlists.
\n","urlObject":{"path":["v1","playlist","plug","by-url"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"b1526c97-0a06-4342-b66a-d9cc8835a18c","name":"Search for Playlists to Plug a Track into by ID","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"link\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/plug/by-url"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length, X-Hash"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Fri, 28 Jul 2023 20:49:17 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-Ratelimit-Limit","value":"10000"},{"description":{"content":"","type":"text/plain"},"key":"X-Ratelimit-Remaining","value":"9998"},{"description":{"content":"","type":"text/plain"},"key":"X-Remaining-Monthly-Credits","value":"5506"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"a0c39de8-3113-4e37-96af-90d67f8a1b39\",\n \"collections\": [\n {\n \"id\": \"4a6eee17-649c-4dbd-95b8-93037fe7d191\",\n \"key\": \"1A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-03T22:55:49.000000Z\",\n \"updated_at\": \"2023-06-02T09:29:13.000000Z\",\n \"title\": \"The Playlist\"\n },\n ...\n {\n \"id\": \"3c594889-d24a-4656-86c3-9ef776738eb6\",\n \"key\": \"0A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-09T03:55:50.000000Z\",\n \"updated_at\": \"2023-03-10T13:51:54.000000Z\",\n \"title\": \"The Playlist, just better\"\n }\n ]\n}"}],"_postman_id":"3f8b7c54-8220-4877-9fd2-cd65d76b317d"},{"name":"Search for Playlists to Plug a Track into by File URL","id":"59e5d643-dec0-42e6-8ae0-436f797f2cf3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}"},"url":"https://api.aimsapi.com/v1/playlist/plug/by-file-url","description":"This endpoint allows you to obtain suggestions of playlists to plug your track into by a publicly accessible URL leading to a supported audio file. The results are sorted from the most suitable playlists.
\n","urlObject":{"path":["v1","playlist","plug","by-file-url"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"966ad94e-3026-4f88-98ef-832b58d27e8c","name":"Search for Playlists to Plug a Track into by File URL","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/plug/by-file-url"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length, X-Hash"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Fri, 28 Jul 2023 20:49:17 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-Ratelimit-Limit","value":"10000"},{"description":{"content":"","type":"text/plain"},"key":"X-Ratelimit-Remaining","value":"9998"},{"description":{"content":"","type":"text/plain"},"key":"X-Remaining-Monthly-Credits","value":"5506"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"a0c39de8-3113-4e37-96af-90d67f8a1b39\",\n \"collections\": [\n {\n \"id\": \"4a6eee17-649c-4dbd-95b8-93037fe7d191\",\n \"key\": \"1A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-03T22:55:49.000000Z\",\n \"updated_at\": \"2023-06-02T09:29:13.000000Z\",\n \"title\": \"The Playlist\"\n },\n ...\n {\n \"id\": \"3c594889-d24a-4656-86c3-9ef776738eb6\",\n \"key\": \"0A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-09T03:55:50.000000Z\",\n \"updated_at\": \"2023-03-10T13:51:54.000000Z\",\n \"title\": \"The Playlist, just better\"\n }\n ]\n}"}],"_postman_id":"59e5d643-dec0-42e6-8ae0-436f797f2cf3"},{"name":"Search for Playlists to Plug a Track into by File","id":"d105f99f-bc84-4248-ab30-6bf9ef384ca6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"track","type":"file","src":"/Users/Shared/test.mp3"}]},"url":"https://api.aimsapi.com/v1/playlist/plug/by-file","description":"This endpoint allows you to obtain suggestions of playlists to plug your track into by a physical audio file. The results are sorted from the most suitable playlists.
\n","urlObject":{"path":["v1","playlist","plug","by-file"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"6b483cff-76c5-4cfd-a184-c8e7cfd754e7","name":"Search for Playlists to Plug a Track into by ID","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"track","type":"file","src":"/Users/Shared/test.mp3"}],"options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/plug/by-file"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length, X-Hash"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Fri, 28 Jul 2023 20:49:17 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-Ratelimit-Limit","value":"10000"},{"description":{"content":"","type":"text/plain"},"key":"X-Ratelimit-Remaining","value":"9998"},{"description":{"content":"","type":"text/plain"},"key":"X-Remaining-Monthly-Credits","value":"5506"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"a0c39de8-3113-4e37-96af-90d67f8a1b39\",\n \"collections\": [\n {\n \"id\": \"4a6eee17-649c-4dbd-95b8-93037fe7d191\",\n \"key\": \"1A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-03T22:55:49.000000Z\",\n \"updated_at\": \"2023-06-02T09:29:13.000000Z\",\n \"title\": \"The Playlist\"\n },\n ...\n {\n \"id\": \"3c594889-d24a-4656-86c3-9ef776738eb6\",\n \"key\": \"0A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-09T03:55:50.000000Z\",\n \"updated_at\": \"2023-03-10T13:51:54.000000Z\",\n \"title\": \"The Playlist, just better\"\n }\n ]\n}"}],"_postman_id":"d105f99f-bc84-4248-ab30-6bf9ef384ca6"},{"name":"Search for Playlists to Plug a Track into by File Hash","id":"621ed892-aee3-4563-97b9-9466c20014a1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"hash","value":"123abcd","type":"text"},{"key":"page","value":"1","type":"text"},{"key":"page_size","value":"20","type":"text"}]},"url":"https://api.aimsapi.com/v1/playlist/plug/by-file-hash","description":"This endpoint allows you to obtain suggestions of playlists to plug your track into by an audio hash of previously used audio file. The results are sorted from the most suitable playlists.
\n","urlObject":{"path":["v1","playlist","plug","by-file-hash"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"a92965e1-8963-444d-b679-d12ada64be48","name":"Search for Playlists to Plug a Track into by ID","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"name":"Content-Type","key":"Content-Type","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"track","type":"file","src":"/Users/Shared/test.mp3"}],"options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/plug/by-file-hash"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length, X-Hash"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Fri, 28 Jul 2023 20:49:17 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-Ratelimit-Limit","value":"10000"},{"description":{"content":"","type":"text/plain"},"key":"X-Ratelimit-Remaining","value":"9998"},{"description":{"content":"","type":"text/plain"},"key":"X-Remaining-Monthly-Credits","value":"5506"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"a0c39de8-3113-4e37-96af-90d67f8a1b39\",\n \"collections\": [\n {\n \"id\": \"4a6eee17-649c-4dbd-95b8-93037fe7d191\",\n \"key\": \"1A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-03T22:55:49.000000Z\",\n \"updated_at\": \"2023-06-02T09:29:13.000000Z\",\n \"title\": \"The Playlist\"\n },\n ...\n {\n \"id\": \"3c594889-d24a-4656-86c3-9ef776738eb6\",\n \"key\": \"0A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-09T03:55:50.000000Z\",\n \"updated_at\": \"2023-03-10T13:51:54.000000Z\",\n \"title\": \"The Playlist, just better\"\n }\n ]\n}"}],"_postman_id":"621ed892-aee3-4563-97b9-9466c20014a1"}],"id":"068b22fd-6c7a-4d13-b9c2-3cb824230be8","_postman_id":"068b22fd-6c7a-4d13-b9c2-3cb824230be8","description":""},{"name":"Filtering","item":[{"name":"Recommendations","item":[{"name":"Suggest Tracks into Playlist by Key","id":"c68f94fe-0303-4f3c-b163-e70e177ef4de","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"key\": \"playlist.key\",\n\t\"page\": 1,\n\t\"page_size\": 20,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 60\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"logic\": \"or\",\n\t\t\t\t\"conditions\": [\n\t\t\t\t\t{\n\t\t\t\t \"field\": \"tags\",\n\t\t\t\t \"operator\": \"in\",\n\t\t\t\t \"value\": [\n \"guitar\",\n \"drums\",\n \"piano\"\n ]\n\t\t\t },\n\t\t\t\t\t{\n\t\t\t\t\t\t\"field\": \"track_name\",\n\t\t\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\t\t\"value\": \"Play\"\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t}\n\t\t]\n\t}\n}"},"url":"https://api.aimsapi.com/v1/playlist/suggest/by-key","description":"Filter suggested tracks.
\n","urlObject":{"path":["v1","playlist","suggest","by-key"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"25a7fd85-1894-43ad-8558-cee809485cd9","name":"Suggest Tracks into Playlist by Key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"key\": \"playlist.key\",\n\t\"page\": 1,\n\t\"page_size\": 20,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 60\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"logic\": \"or\",\n\t\t\t\t\"conditions\": [\n\t\t\t\t\t{\n\t\t\t\t \"field\": \"tags\",\n\t\t\t\t \"operator\": \"in\",\n\t\t\t\t \"value\": [\n \"guitar\",\n \"drums\",\n \"piano\"\n ]\n\t\t\t },\n\t\t\t\t\t{\n\t\t\t\t\t\t\"field\": \"track_name\",\n\t\t\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\t\t\"value\": \"Play\"\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t}\n\t\t]\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/suggest/by-key"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.19.10"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"X-Powered-By","value":"PHP/7.4.13"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 06 Jan 2022 16:28:25 GMT"},{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"499"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"05a13f53-4048-4128-94c3-5f665abc7297\",\n \"tracks\": [\n {\n \"id\": 143405091,\n \"id_client\": \"ZIK386#14\",\n \"duration\": 210,\n \"release_year\": 2013,\n \"track_name\": \"Give Me (Instru)\",\n \"tags\": [\n \"ZIK\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n ...\n {\n \"id\": 142569672,\n \"id_client\": \"NSPS226#45\",\n \"duration\": 124,\n \"release_year\": 2016,\n \"track_name\": \"Siesta Sun\",\n \"tags\": [\n \"NSPS\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n }\n ]\n}"}],"_postman_id":"c68f94fe-0303-4f3c-b163-e70e177ef4de"},{"name":"Suggest Tracks into Playlist by ID","id":"3a081774-242c-4042-8000-7530bb80c685","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"playlistId\",\n\t\"page\": 1,\n\t\"page_size\": 20,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 60\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"logic\": \"or\",\n\t\t\t\t\"conditions\": [\n\t\t\t\t\t{\n\t\t\t\t \"field\": \"tags\",\n\t\t\t\t \"operator\": \"in\",\n\t\t\t\t \"value\": [\n \"guitar\",\n \"drums\",\n \"piano\"\n ]\n\t\t\t },\n\t\t\t\t\t{\n\t\t\t\t\t\t\"field\": \"track_name\",\n\t\t\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\t\t\"value\": \"Play\"\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t}\n\t\t]\n\t}\n}"},"url":"https://api.aimsapi.com/v1/playlist/suggest/by-id","description":"Filter suggested tracks.
\n","urlObject":{"path":["v1","playlist","suggest","by-id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"70bc2fb6-4bf4-4368-b439-2b7e4364bd24","name":"Suggest Tracks into Playlist by ID","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"playlistId\",\n\t\"page\": 1,\n\t\"page_size\": 20,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 60\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"logic\": \"or\",\n\t\t\t\t\"conditions\": [\n\t\t\t\t\t{\n\t\t\t\t \"field\": \"tags\",\n\t\t\t\t \"operator\": \"in\",\n\t\t\t\t \"value\": [\n \"guitar\",\n \"drums\",\n \"piano\"\n ]\n\t\t\t },\n\t\t\t\t\t{\n\t\t\t\t\t\t\"field\": \"track_name\",\n\t\t\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\t\t\"value\": \"Play\"\n\t\t\t\t\t}\n\t\t\t\t]\n\t\t\t}\n\t\t]\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/suggest/by-id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.19.10"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"X-Powered-By","value":"PHP/7.4.13"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 06 Jan 2022 16:29:56 GMT"},{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"497"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"41f8d79f-b2f0-44ad-b1ba-898bebe1b05c\",\n \"tracks\": [\n {\n \"id\": 143405091,\n \"id_client\": \"ZIK386#14\",\n \"duration\": 210,\n \"release_year\": 2013,\n \"track_name\": \"Give Me (Instru)\",\n \"tags\": [\n \"ZIK\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n ...\n {\n \"id\": 142569672,\n \"id_client\": \"NSPS226#45\",\n \"duration\": 124,\n \"release_year\": 2016,\n \"track_name\": \"Siesta Sun\",\n \"tags\": [\n \"NSPS\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n }\n ]\n}"}],"_postman_id":"3a081774-242c-4042-8000-7530bb80c685"}],"id":"55e1f689-fe01-4857-a62e-c8209b477a50","_postman_id":"55e1f689-fe01-4857-a62e-c8209b477a50","description":""},{"name":"Similar Playlists","item":[{"name":"Search Similar Playlists by Key","id":"c91155c2-6058-49b0-99b7-43fef9ba4b56","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"key\": \"playlist.key\",\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"title\",\n\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\"value\": \"Play\"\n\t\t\t}\n\t\t]\n\t}\n}"},"url":"https://api.aimsapi.com/v1/playlist/similar/by-key?page=1&page_size=10","description":"Filter similar playlists.
\n","urlObject":{"path":["v1","playlist","similar","by-key"],"host":["https://api.aimsapi.com"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}],"variable":[]}},"response":[{"id":"c395d673-1cdb-46f9-8163-4c2f859597cc","name":"Search Similar Playlist by Key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"key\": \"playlist.key\",\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"title\",\n\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\"value\": \"Play\"\n\t\t\t}\n\t\t]\n\t}\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.aimsapi.com/v1/playlist/similar/by-key?page=1&page_size=10","host":["https://api.aimsapi.com"],"path":["v1","playlist","similar","by-key"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.19.10"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"X-Powered-By","value":"PHP/7.4.13"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Mon, 04 Oct 2021 19:18:14 GMT"},{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"499"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"0398e245-6d99-4e3b-888e-63f2614e6c55\",\n \"collections\": [\n {\n \"id\": \"6d20198d-c759-45df-883d-7824af7e92a9\",\n \"key\": \"luxury-commercials\",\n \"processed_at\": \"2021-08-11T11:17:30.000000Z\",\n \"title\": \"Luxury Commercials\"\n },\n {\n \"id\": \"7220dbae-7ce1-40e8-b0a9-d756d15d2fbf\",\n \"key\": \"action-trailers\",\n \"processed_at\": \"2021-08-11T11:17:53.000000Z\",\n \"title\": \"Action Trailers\"\n },\n ...\n ]\n}"}],"_postman_id":"c91155c2-6058-49b0-99b7-43fef9ba4b56"},{"name":"Search Similar Playlists by ID","id":"6469a8e9-a5d8-4159-9a4d-255c4f36b702","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"id\": \"playlistId\",\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"title\",\n\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\"value\": \"Play\"\n\t\t\t}\n\t\t]\n\t}\n}"},"url":"https://api.aimsapi.com/v1/playlist/similar/by-id?page=1&page_size=10","description":"Filter similar playlists.
\n","urlObject":{"path":["v1","playlist","similar","by-id"],"host":["https://api.aimsapi.com"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}],"variable":[]}},"response":[{"id":"a49b4825-f8ab-46d2-aba1-4ffac2f87ced","name":"Search Similar Playlists by ID","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n \"id\": \"playlistId\",\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n\t\t\t{\n\t\t\t\t\"field\": \"title\",\n\t\t\t\t\"operator\": \"begins\",\n\t\t\t\t\"value\": \"Play\"\n\t\t\t}\n\t\t]\n\t}\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.aimsapi.com/v1/playlist/similar/by-id?page=1&page_size=10","host":["https://api.aimsapi.com"],"path":["v1","playlist","similar","by-id"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.19.10"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"X-Powered-By","value":"PHP/7.4.13"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Mon, 04 Oct 2021 19:18:19 GMT"},{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"498"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"0398e245-6d99-4e3b-888e-63f2614e6c55\",\n \"collections\": [\n {\n \"id\": \"6d20198d-c759-45df-883d-7824af7e92a9\",\n \"key\": \"luxury-commercials\",\n \"processed_at\": \"2021-08-11T11:17:30.000000Z\",\n \"title\": \"Luxury Commercials\"\n },\n {\n \"id\": \"7220dbae-7ce1-40e8-b0a9-d756d15d2fbf\",\n \"key\": \"action-trailers\",\n \"processed_at\": \"2021-08-11T11:17:53.000000Z\",\n \"title\": \"Action Trailers\"\n },\n ...\n ]\n}"}],"_postman_id":"6469a8e9-a5d8-4159-9a4d-255c4f36b702"}],"id":"79cb1552-f06b-4916-b7d7-35e8cf22ba9e","_postman_id":"79cb1552-f06b-4916-b7d7-35e8cf22ba9e","description":""},{"name":"Playlist Plugging","item":[{"name":"Search for Playlists to Plug a Track into by ID","id":"826bd424-318e-44e1-9949-af6d43ae5596","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"track_id\": \"{{track.id}}\",\n\t\"page\": 1,\n\t\"page_size\": 20,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n {\n\t\t\t\t\"field\": \"title\",\n\t\t\t\t\"operator\": \"begins\",\n\t \t\t\"value\": \"A\"\n\t\t\t},\n {\n\t\t\t\t\"field\": \"followers\",\n\t\t\t\t\"operator\": \"gte\",\n\t \t\t\"value\": 1000\n\t\t\t},\n {\n\t\t\t\t\"field\": \"number_of_tracks\",\n\t\t\t\t\"operator\": \"gte\",\n\t \t\t\"value\": 50\n\t\t\t}\n\t\t]\n\t}\n}"},"url":"https://api.aimsapi.com/v1/playlist/plug/by-id","description":"Filter playlists.
\n","urlObject":{"path":["v1","playlist","plug","by-id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"7e72352d-9914-41e4-9d8f-6ce630b17dcb","name":"Search for Playlists to Plug a Track into by ID","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"track_id\": \"{{track.id}}\",\n\t\"page\": 1,\n\t\"page_size\": 20,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n {\n\t\t\t\t\"field\": \"title\",\n\t\t\t\t\"operator\": \"begins\",\n\t \t\t\"value\": \"A\"\n\t\t\t},\n {\n\t\t\t\t\"field\": \"followers\",\n\t\t\t\t\"operator\": \"gte\",\n\t \t\t\"value\": 1000\n\t\t\t},\n {\n\t\t\t\t\"field\": \"number_of_tracks\",\n\t\t\t\t\"operator\": \"gte\",\n\t \t\t\"value\": 50\n\t\t\t}\n\t\t]\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/plug/by-id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length, X-Hash"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 28 Jul 2023 20:49:17 GMT"},{"key":"X-Ratelimit-Limit","value":"10000"},{"key":"X-Ratelimit-Remaining","value":"9998"},{"key":"X-Remaining-Monthly-Credits","value":"5506"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"a0c39de8-3113-4e37-96af-90d67f8a1b39\",\n \"collections\": [\n {\n \"id\": \"4a6eee17-649c-4dbd-95b8-93037fe7d191\",\n \"key\": \"1A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-03T22:55:49.000000Z\",\n \"updated_at\": \"2023-06-02T09:29:13.000000Z\",\n \"title\": \"The Playlist\"\n },\n ...\n {\n \"id\": \"3c594889-d24a-4656-86c3-9ef776738eb6\",\n \"key\": \"0A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-09T03:55:50.000000Z\",\n \"updated_at\": \"2023-03-10T13:51:54.000000Z\",\n \"title\": \"The Playlist, just better\"\n }\n ]\n}"}],"_postman_id":"826bd424-318e-44e1-9949-af6d43ae5596"},{"name":"Search for Playlists to Plug a Track into by URL","id":"769c2b56-514b-49cc-8edd-354120a60616","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"link\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\n\t\"page\": 1,\n\t\"page_size\": 20,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n {\n\t\t\t\t\"field\": \"title\",\n\t\t\t\t\"operator\": \"begins\",\n\t \t\t\"value\": \"A\"\n\t\t\t},\n {\n\t\t\t\t\"field\": \"followers\",\n\t\t\t\t\"operator\": \"gte\",\n\t \t\t\"value\": 1000\n\t\t\t},\n {\n\t\t\t\t\"field\": \"number_of_tracks\",\n\t\t\t\t\"operator\": \"gte\",\n\t \t\t\"value\": 50\n\t\t\t}\n\t\t]\n\t}\n}"},"url":"https://api.aimsapi.com/v1/playlist/plug/by-url","description":"Filter playlists.
\n","urlObject":{"path":["v1","playlist","plug","by-url"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"bbe4e731-73d9-46a1-90c2-89e7e85d2554","name":"Search for Playlists to Plug a Track into by ID","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"api-secret"}],"body":{"mode":"raw","raw":"{\n\t\"link\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\n\t\"page\": 1,\n\t\"page_size\": 20,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n {\n\t\t\t\t\"field\": \"title\",\n\t\t\t\t\"operator\": \"begins\",\n\t \t\t\"value\": \"A\"\n\t\t\t},\n {\n\t\t\t\t\"field\": \"followers\",\n\t\t\t\t\"operator\": \"gte\",\n\t \t\t\"value\": 1000\n\t\t\t},\n {\n\t\t\t\t\"field\": \"number_of_tracks\",\n\t\t\t\t\"operator\": \"gte\",\n\t \t\t\"value\": 50\n\t\t\t}\n\t\t]\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/plug/by-url"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length, X-Hash"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 28 Jul 2023 20:49:17 GMT"},{"key":"X-Ratelimit-Limit","value":"10000"},{"key":"X-Ratelimit-Remaining","value":"9998"},{"key":"X-Remaining-Monthly-Credits","value":"5506"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"a0c39de8-3113-4e37-96af-90d67f8a1b39\",\n \"collections\": [\n {\n \"id\": \"4a6eee17-649c-4dbd-95b8-93037fe7d191\",\n \"key\": \"1A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-03T22:55:49.000000Z\",\n \"updated_at\": \"2023-06-02T09:29:13.000000Z\",\n \"title\": \"The Playlist\"\n },\n ...\n {\n \"id\": \"3c594889-d24a-4656-86c3-9ef776738eb6\",\n \"key\": \"0A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-09T03:55:50.000000Z\",\n \"updated_at\": \"2023-03-10T13:51:54.000000Z\",\n \"title\": \"The Playlist, just better\"\n }\n ]\n}"}],"_postman_id":"769c2b56-514b-49cc-8edd-354120a60616"},{"name":"Search for Playlists to Plug a Track into by File URL","id":"3a01004a-bb6f-41c8-8ec5-686f46db52c0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"track\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n\t\"page\": 1,\n\t\"page_size\": 20,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n {\n\t\t\t\t\"field\": \"title\",\n\t\t\t\t\"operator\": \"begins\",\n\t \t\t\"value\": \"A\"\n\t\t\t},\n {\n\t\t\t\t\"field\": \"followers\",\n\t\t\t\t\"operator\": \"gte\",\n\t \t\t\"value\": 1000\n\t\t\t},\n {\n\t\t\t\t\"field\": \"number_of_tracks\",\n\t\t\t\t\"operator\": \"gte\",\n\t \t\t\"value\": 50\n\t\t\t}\n\t\t]\n\t}\n}"},"url":"https://api.aimsapi.com/v1/playlist/plug/by-file-url","description":"Filter playlists.
\n","urlObject":{"path":["v1","playlist","plug","by-file-url"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"a46a6367-6c8b-45a1-a281-a56b64f77b76","name":"Search for Playlists to Plug a Track into by File URL","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"track\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n\t\"page\": 1,\n\t\"page_size\": 20,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n {\n\t\t\t\t\"field\": \"title\",\n\t\t\t\t\"operator\": \"begins\",\n\t \t\t\"value\": \"A\"\n\t\t\t},\n {\n\t\t\t\t\"field\": \"followers\",\n\t\t\t\t\"operator\": \"gte\",\n\t \t\t\"value\": 1000\n\t\t\t},\n {\n\t\t\t\t\"field\": \"number_of_tracks\",\n\t\t\t\t\"operator\": \"gte\",\n\t \t\t\"value\": 50\n\t\t\t}\n\t\t]\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/plug/by-file-url"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length, X-Hash"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 28 Jul 2023 20:49:17 GMT"},{"key":"X-Ratelimit-Limit","value":"10000"},{"key":"X-Ratelimit-Remaining","value":"9998"},{"key":"X-Remaining-Monthly-Credits","value":"5506"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"a0c39de8-3113-4e37-96af-90d67f8a1b39\",\n \"collections\": [\n {\n \"id\": \"4a6eee17-649c-4dbd-95b8-93037fe7d191\",\n \"key\": \"1A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-03T22:55:49.000000Z\",\n \"updated_at\": \"2023-06-02T09:29:13.000000Z\",\n \"title\": \"The Playlist\"\n },\n ...\n {\n \"id\": \"3c594889-d24a-4656-86c3-9ef776738eb6\",\n \"key\": \"0A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-09T03:55:50.000000Z\",\n \"updated_at\": \"2023-03-10T13:51:54.000000Z\",\n \"title\": \"The Playlist, just better\"\n }\n ]\n}"}],"_postman_id":"3a01004a-bb6f-41c8-8ec5-686f46db52c0"},{"name":"Search for Playlists to Plug a Track into by File","id":"998138a6-e8b3-466b-8aa6-949ebde3b030","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"formdata","formdata":[{"key":"track","type":"file","src":"/Users/Shared/test.mp3"},{"key":"page","value":"1","type":"text"},{"key":"page_size","value":"40","type":"text"},{"key":"filter[logic]","value":"and","type":"text"},{"key":"filter[conditions][0][field]","value":"title","type":"text"},{"key":"filter[conditions][0][operator]","value":"begins","type":"text"},{"key":"filter[conditions][0][value]","value":"A","type":"text"}]},"url":"https://api.aimsapi.com/v1/playlist/plug/by-file","description":"Filter playlists.
\n","urlObject":{"path":["v1","playlist","plug","by-file"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"1b9f5808-bc2a-4988-92c5-ae894efb8180","name":"Search for Playlists to Plug a Track into by ID","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"api-secret"}],"body":{"mode":"formdata","formdata":[{"key":"track","type":"file","src":"/Users/Shared/test.mp3"},{"key":"page","value":"1","type":"text"},{"key":"page_size","value":"40","type":"text"},{"key":"filter[logic]","value":"and","type":"text"},{"key":"filter[conditions][0][field]","value":"title","type":"text"},{"key":"filter[conditions][0][operator]","value":"begins","type":"text"},{"key":"filter[conditions][0][value]","value":"A","type":"text"}],"options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/playlist/plug/by-file"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length, X-Hash"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 28 Jul 2023 20:49:17 GMT"},{"key":"X-Ratelimit-Limit","value":"10000"},{"key":"X-Ratelimit-Remaining","value":"9998"},{"key":"X-Remaining-Monthly-Credits","value":"5506"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"a0c39de8-3113-4e37-96af-90d67f8a1b39\",\n \"collections\": [\n {\n \"id\": \"4a6eee17-649c-4dbd-95b8-93037fe7d191\",\n \"key\": \"1A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-03T22:55:49.000000Z\",\n \"updated_at\": \"2023-06-02T09:29:13.000000Z\",\n \"title\": \"The Playlist\"\n },\n ...\n {\n \"id\": \"3c594889-d24a-4656-86c3-9ef776738eb6\",\n \"key\": \"0A2BCDE3fg4hiJ5kLMnoP6\",\n \"processed_at\": \"2023-06-09T03:55:50.000000Z\",\n \"updated_at\": \"2023-03-10T13:51:54.000000Z\",\n \"title\": \"The Playlist, just better\"\n }\n ]\n}"}],"_postman_id":"998138a6-e8b3-466b-8aa6-949ebde3b030"}],"id":"34a08591-e4a9-4de0-ac41-d4d91459d9d4","_postman_id":"34a08591-e4a9-4de0-ac41-d4d91459d9d4","description":""}],"id":"5f41f8e9-c7ad-490e-b116-b9abff0185e3","_postman_id":"5f41f8e9-c7ad-490e-b116-b9abff0185e3","description":""}],"id":"125c3196-a541-41f4-ab75-3680996a664e","_postman_id":"125c3196-a541-41f4-ab75-3680996a664e","description":""},{"name":"Custom tags","item":[{"name":"Custom tag management","item":[{"name":"Create Custom Tag","id":"e7b9e88a-de0f-4a75-8747-37ed743e45f4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"title\": \"Footbal results underscore\",\n\t\"key\": \"footbal-results-underscore\",\n \"track_ids\": [\n \"my-id-1\", \"my-id-2\", \"my-id-3\"\n ]\n}"},"url":"https://api.aimsapi.com/v1/custom-tag","description":"This endpoint allows you to create a new custom tag. The key field needs to be unique and should not contain special characters.
You can create the custom tag empty and add tracks later, or specify what tracks should be in the custom tag directly when creating the custom tag in the track_ids attribute (see the second example).
This endpoint allows you to list all custom tags in your account.
\n","urlObject":{"path":["v1","custom-tag"],"host":["https://api.aimsapi.com"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}],"variable":[]}},"response":[{"id":"7d298f3a-0d00-4eb4-b011-dae611262b3b","name":"List Custom Tags","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.aimsapi.com/v1/custom-tag?page=1&page_size=10","host":["https://api.aimsapi.com"],"path":["v1","custom-tag"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:09:58 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"497"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"collections\": [\n {\n \"id\": \"fc2d3609-56bd-4d3a-89ce-70d83c4a4b16\",\n \"key\": \"footbal-results-underscore\",\n \"processed_at\": null,\n \"title\": \"Footbal results underscore\"\n }\n ],\n \"pagination\": {\n \"item_count\": 1,\n \"page\": 1,\n \"page_size\": 10,\n \"page_count\": 1\n }\n}"}],"_postman_id":"d1226897-3df6-46fd-9f99-10b086f4a1f5"},{"name":"Get number of Custom Tags","id":"5206747e-eb3c-4e90-b457-933965a2d828","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/custom-tag/length","description":"This endpoint allows you to obtain the total number of custom tags in your account.
\n","urlObject":{"path":["v1","custom-tag","length"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"8489448d-a6df-4e3c-8f66-c57cdfd6fc1d","name":"Get number of Custom Tags","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/custom-tag/length"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:10:13 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"496"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"length\": 1\n}"}],"_postman_id":"5206747e-eb3c-4e90-b457-933965a2d828"},{"name":"Get Custom Tag by Key","id":"5a05ad70-f8e9-46ee-b724-d807d626b29d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/custom-tag/get/by-key/:customTag.key","description":"This endpoint allows you to get custom tag information based on its key.
\n","urlObject":{"path":["v1","custom-tag","get","by-key",":customTag.key"],"host":["https://api.aimsapi.com"],"query":[],"variable":[{"type":"any","key":"customTag"},{"type":"any","value":"{{customTag.key}}","key":"customTag.key"}]}},"response":[{"id":"4ec9953c-0acb-4e9b-ac60-a96cbd5583f8","name":"Get Custom Tag by Key","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.aimsapi.com/v1/custom-tag/get/by-key/:customTag.key","host":["https://api.aimsapi.com"],"path":["v1","custom-tag","get","by-key",":customTag.key"],"variable":[{"key":"customTag.key","value":"{{customTag.key}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:10:25 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"fc2d3609-56bd-4d3a-89ce-70d83c4a4b16\",\n \"key\": \"footbal-results-underscore\",\n \"processed_at\": null,\n \"title\": \"Footbal results underscore\"\n }\n}"}],"_postman_id":"5a05ad70-f8e9-46ee-b724-d807d626b29d"},{"name":"Get Custom Tag by ID","id":"7a126bfe-14b8-48b6-bffa-b36a70d90af1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/custom-tag/get/by-id/:customTag.id","description":"This endpoint allows you to get custom tag information based on its ID.
\n","urlObject":{"path":["v1","custom-tag","get","by-id",":customTag.id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[{"type":"any","key":"customTag"},{"type":"any","value":"{{customTag.id}}","key":"customTag.id"}]}},"response":[{"id":"3998c767-7eb9-4d06-babf-794de4b1aece","name":"Get Custom Tag by ID","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.aimsapi.com/v1/custom-tag/get/by-id/:customTag.id","host":["https://api.aimsapi.com"],"path":["v1","custom-tag","get","by-id",":customTag.id"],"variable":[{"key":"customTag.id","value":"{{customTag.id}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:11:10 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"498"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"fc2d3609-56bd-4d3a-89ce-70d83c4a4b16\",\n \"key\": \"footbal-results-underscore\",\n \"processed_at\": null,\n \"title\": \"Footbal results underscore\"\n }\n}"}],"_postman_id":"7a126bfe-14b8-48b6-bffa-b36a70d90af1"},{"name":"Update Custom Tag by Key","id":"4b832995-a084-4f97-a5ae-ee5f24c25ecf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"title\": \"Footbal results underscore - domestic\"\n}"},"url":"https://api.aimsapi.com/v1/custom-tag/update/by-key/:customTag.key","description":"This endpoint allows you to update title of an existing custom tag based on its key.
\n","urlObject":{"path":["v1","custom-tag","update","by-key",":customTag.key"],"host":["https://api.aimsapi.com"],"query":[],"variable":[{"type":"any","key":"customTag"},{"type":"any","value":"{{customTag.key}}","key":"customTag.key"}]}},"response":[{"id":"018338b5-116a-48c0-bea4-20474fdcf995","name":"Update Custom Tag by Key","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"title\": \"Footbal results underscore - domestic\"\n}"},"url":{"raw":"https://api.aimsapi.com/v1/custom-tag/update/by-key/:customTag.key","host":["https://api.aimsapi.com"],"path":["v1","custom-tag","update","by-key",":customTag.key"],"variable":[{"key":"customTag.key","value":"{{customTag.key}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:11:46 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"fc2d3609-56bd-4d3a-89ce-70d83c4a4b16\",\n \"key\": \"footbal-results-underscore\",\n \"processed_at\": null,\n \"title\": \"Footbal results underscore - domestic\"\n }\n}"}],"_postman_id":"4b832995-a084-4f97-a5ae-ee5f24c25ecf"},{"name":"Update Custom Tag by ID","id":"347a3fe5-bdca-4522-9389-7944bb008318","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"title\": \"Footbal results underscore - domestic\"\n}"},"url":"https://api.aimsapi.com/v1/custom-tag/update/by-id/:customTag.id","description":"This endpoint allows you to update title of an existing custom tag based on its ID (ID is generated automatically by AIMS when the custom tag is created).
\n","urlObject":{"path":["v1","custom-tag","update","by-id",":customTag.id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[{"type":"any","key":"customTag"},{"type":"any","value":"{{customTag.id}}","key":"customTag.id"}]}},"response":[{"id":"2f550927-c432-45a6-826f-936df46e1d8d","name":"Update Custom Tag by ID","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"title\": \"Footbal results underscore - domestic\"\n}"},"url":{"raw":"https://api.aimsapi.com/v1/custom-tag/update/by-id/:customTag.id","host":["https://api.aimsapi.com"],"path":["v1","custom-tag","update","by-id",":customTag.id"],"variable":[{"key":"customTag.id","value":"{{customTag.id}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:12:08 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"497"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"fc2d3609-56bd-4d3a-89ce-70d83c4a4b16\",\n \"key\": \"footbal-results-underscore\",\n \"processed_at\": null,\n \"title\": \"Footbal results underscore - domestic\"\n }\n}"}],"_postman_id":"347a3fe5-bdca-4522-9389-7944bb008318"},{"name":"Delete Custom Tag by Key","id":"f3826cd5-785f-4063-a040-c96b4d831dde","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/custom-tag/delete/by-key/:customTag.key","description":"This endpoint allows you to delete a custom tag based on its key.
\n","urlObject":{"path":["v1","custom-tag","delete","by-key",":customTag.key"],"host":["https://api.aimsapi.com"],"query":[],"variable":[{"type":"any","key":"customTag"},{"type":"any","value":"{{customTag.key}}","key":"customTag.key"}]}},"response":[{"id":"08b83ef0-160d-4ad6-84a4-ae30ed7dd557","name":"Delete Custom Tag by Key","originalRequest":{"method":"DELETE","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.aimsapi.com/v1/custom-tag/delete/by-key/:customTag.key","host":["https://api.aimsapi.com"],"path":["v1","custom-tag","delete","by-key",":customTag.key"],"variable":[{"key":"customTag.key","value":"{{customTag.key}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:14:52 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"496"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Collection has been deleted.\"\n}"}],"_postman_id":"f3826cd5-785f-4063-a040-c96b4d831dde"},{"name":"Delete Custom Tag by ID","id":"96225452-8a0b-48a8-b98a-ac930ee5391b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/custom-tag/delete/by-id/:customTag.id","description":"This endpoint allows you to delete a custom tag based on its ID.
\n","urlObject":{"path":["v1","custom-tag","delete","by-id",":customTag.id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[{"type":"any","key":"customTag"},{"type":"any","value":"{{customTag.id}}","key":"customTag.id"}]}},"response":[{"id":"71264f97-0c0f-482a-a7ae-91dab091147d","name":"Delete Custom Tag by ID","originalRequest":{"method":"DELETE","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.aimsapi.com/v1/custom-tag/delete/by-id/:customTag.id","host":["https://api.aimsapi.com"],"path":["v1","custom-tag","delete","by-id",":customTag.id"],"variable":[{"key":"customTag.id","value":"{{customTag.id}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:14:52 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"496"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Collection has been deleted.\"\n}"}],"_postman_id":"96225452-8a0b-48a8-b98a-ac930ee5391b"}],"id":"66eb29ae-5709-4d7b-9c7a-e94bd7d42085","_postman_id":"66eb29ae-5709-4d7b-9c7a-e94bd7d42085","description":""},{"name":"Track management","item":[{"name":"Add Track to Custom Tag by ID","id":"202a4e8a-727b-4ff3-98f9-f95b723e1d9e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track_id\": \"SPRT2#1\",\n\t\"collection_key\": \"{{customTag.key}}\",\n // add more tracks at once\n \"track_ids\": [\n \"my-id-1\", \"my-id-2\", \"my-id-2\"\n ]\n}"},"url":"https://api.aimsapi.com/v1/custom-tag/add-track/by-id","description":"This endpoint allows you to add an internal track (track already in your account) into the custom tag. The track_id or track_ids only accept track client_id as a value!
You can add more than one track in a single request using the track_ids attribute. You can use either track_id or track_ids, or both.
This endpoint allows you to add track specified by a supported URL into the custom tag. Please refer to Search similar tracks by URL for more information about supported services.
\nPlease note that adding a track from a link takes more time than adding an internal track. Similarly to the difference between internal search and search by URL. Please also note that only tracks up to 15 minutes are supported for performance reasons.
\n","urlObject":{"path":["v1","custom-tag","add-track","by-url"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"70c04c17-2e25-4298-8c5d-da4a2e11eb99","name":"Add Track to Custom Tag by URL","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"link\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\n\t\"collection_key\": \"{{customTag.key}}\"\n}"},"url":"https://api.aimsapi.com/v1/custom-tag/add-track/by-url"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:12:56 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Track successfully added\"\n}"}],"_postman_id":"23d0e7ee-b256-4b32-89df-03621356bc82"},{"name":"Add Track to Custom Tag by file URL","id":"7e068622-6cb2-4831-bd63-1f5c59bfd970","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n\t\"collection_key\": \"{{customTag.key}}\"\n}"},"url":"https://api.aimsapi.com/v1/custom-tag/add-track/by-file-url","description":"This endpoint allows you to add track specified by a URL leading to a physical audio file into the custom tag.
\n","urlObject":{"path":["v1","custom-tag","add-track","by-file-url"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"4b358afb-6eb4-4df7-a9aa-8a773dd25b99","name":"Add Track to Custom Tag by file URL","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n\t\"collection_key\": \"{{customTag.key}}\"\n}"},"url":"https://api.aimsapi.com/v1/custom-tag/add-track/by-file-url"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:13:11 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"499"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Track successfully added\"\n}"}],"_postman_id":"7e068622-6cb2-4831-bd63-1f5c59bfd970"},{"name":"Add Track to Custom Tag by file","id":"997f5bb7-e889-4865-8e12-2fed8ac53edf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"collection_key","value":"{{customTag.key}}","type":"text"},{"key":"track","type":"file","src":"/Users/jannovotny/projects/StudioFontana/aimsapi.com/data/test-tracks/pairing/0003b70cc761b60b32c9eab85845c961.mp3"}]},"url":"https://api.aimsapi.com/v1/custom-tag/add-track/by-file","description":"This endpoint allows you to add track specified by a physical audio file into the custom tag.
\n","urlObject":{"path":["v1","custom-tag","add-track","by-file"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"0d6f6892-36e1-4a45-9484-968451693780","name":"Add Track to Custom Tag by file","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"collection_key","value":"{{customTag.key}}","type":"text"},{"key":"track","type":"file","src":"/Users/Shared/test.mp3"}]},"url":"https://api.aimsapi.com/v1/custom-tag/add-track/by-file"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:13:25 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"498"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Track successfully added\"\n}"}],"_postman_id":"997f5bb7-e889-4865-8e12-2fed8ac53edf"},{"name":"Get Tracks defining the Custom Tag by Key","id":"86fb7d78-6d16-479d-9e40-dfddfd196814","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/custom-tag/get-tracks/by-key/:customTag.key","description":"This endpoint allows you to list all tracks currently defining the custom tag specified by its key.
\n","urlObject":{"path":["v1","custom-tag","get-tracks","by-key",":customTag.key"],"host":["https://api.aimsapi.com"],"query":[],"variable":[{"type":"any","key":"customTag"},{"type":"any","value":"{{customTag.key}}","key":"customTag.key"}]}},"response":[{"id":"b447c566-96d6-4033-99cf-83fd600f3059","name":"Get Tracks defining the Custom Tag by Key","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.aimsapi.com/v1/custom-tag/get-tracks/by-key/:customTag.key","host":["https://api.aimsapi.com"],"path":["v1","custom-tag","get-tracks","by-key",":customTag.key"],"variable":[{"key":"customTag.key","value":"{{customTag.key}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:13:50 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"497"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"tracks\": [\n {\n \"id\": 142926076,\n \"id_client\": \"SPRT2#1\",\n \"duration\": 137,\n \"release_year\": 2007,\n \"track_name\": \"Beautiful You\",\n \"tags\": [\n \"SPRT\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null,\n \"artist_canonical\": \"olsanik-otakar\"\n },\n {\n \"id\": 153416864,\n \"id_client\": \"url:4c1971bb764b9b67d2fa93616dc30977\",\n \"duration\": 248,\n \"release_year\": null,\n \"track_name\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T18:13:10.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"YTEyMTg0M2FkMDZiNTRiNDhjZWRiN2Y1MDgwOTY3MDU=\"\n },\n {\n \"id\": 153416865,\n \"id_client\": \"file-url:3b66521a25b139f18f6fd3c7bf2a05c0\",\n \"duration\": 27,\n \"release_year\": null,\n \"track_name\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T18:13:15.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"OWUyMjJiZDY1ZTk2NzA5MTVjMmNjYjczZTczODU4MzM=\"\n },\n {\n \"id\": 153416866,\n \"id_client\": \"file:0003b70cc761b60b32c9eab85845c961\",\n \"duration\": 61,\n \"release_year\": null,\n \"track_name\": \"0003b70cc761b60b32c9eab85845c961.mp3\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T18:13:29.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"YWY4ZDI0YmIwOTI5Y2YzOWQ1NGYwYjFiOTVlNmNkNzk=\"\n }\n ],\n \"pagination\": {\n \"item_count\": 4,\n \"page\": 1,\n \"page_size\": 4,\n \"page_count\": 1\n }\n}"}],"_postman_id":"86fb7d78-6d16-479d-9e40-dfddfd196814"},{"name":"Get Tracks defining the Custom Tag by ID","id":"eb139e6d-ccbc-49f0-8de1-6efa844b43fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":"https://api.aimsapi.com/v1/custom-tag/get-tracks/by-id/:customTag.id","description":"This endpoint allows you to list all tracks currently defining the custom tag specified by its ID.
\n","urlObject":{"path":["v1","custom-tag","get-tracks","by-id",":customTag.id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[{"type":"any","key":"customTag"},{"type":"any","value":"{{customTag.id}}","key":"customTag.id"}]}},"response":[{"id":"c6c7d47b-070f-45c9-8b73-0c8fe5d9cccc","name":"Get Tracks defining the Custom Tag by ID","originalRequest":{"method":"GET","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.aimsapi.com/v1/custom-tag/get-tracks/by-id/:customTag.id","host":["https://api.aimsapi.com"],"path":["v1","custom-tag","get-tracks","by-id",":customTag.id"],"variable":[{"key":"customTag.id","value":"{{customTag.id}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:14:00 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"496"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"tracks\": [\n {\n \"id\": 142926076,\n \"id_client\": \"SPRT2#1\",\n \"duration\": 137,\n \"release_year\": 2007,\n \"track_name\": \"Beautiful You\",\n \"tags\": [\n \"SPRT\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null,\n \"artist_canonical\": \"olsanik-otakar\"\n },\n {\n \"id\": 153416864,\n \"id_client\": \"url:4c1971bb764b9b67d2fa93616dc30977\",\n \"duration\": 248,\n \"release_year\": null,\n \"track_name\": \"https://www.youtube.com/watch?v=I2sRc3j7IU0\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T18:13:10.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"YTEyMTg0M2FkMDZiNTRiNDhjZWRiN2Y1MDgwOTY3MDU=\"\n },\n {\n \"id\": 153416865,\n \"id_client\": \"file-url:3b66521a25b139f18f6fd3c7bf2a05c0\",\n \"duration\": 27,\n \"release_year\": null,\n \"track_name\": \"https://file-examples-com.github.io/uploads/2017/11/file_example_MP3_700KB.mp3\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T18:13:15.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"OWUyMjJiZDY1ZTk2NzA5MTVjMmNjYjczZTczODU4MzM=\"\n },\n {\n \"id\": 153416866,\n \"id_client\": \"file:0003b70cc761b60b32c9eab85845c961\",\n \"duration\": 61,\n \"release_year\": null,\n \"track_name\": \"0003b70cc761b60b32c9eab85845c961.mp3\",\n \"tags\": [],\n \"processed_at\": \"2022-01-06T18:13:29.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"YWY4ZDI0YmIwOTI5Y2YzOWQ1NGYwYjFiOTVlNmNkNzk=\"\n }\n ],\n \"pagination\": {\n \"item_count\": 4,\n \"page\": 1,\n \"page_size\": 4,\n \"page_count\": 1\n }\n}"}],"_postman_id":"eb139e6d-ccbc-49f0-8de1-6efa844b43fd"},{"name":"Remove Track from Custom Tag","id":"0438f6b8-6479-4ea6-95fd-1340a53d6286","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"track_id\": \"SPRT2#1\",\n\t\"collection_key\": \"{{customTag.key}}\"\n}"},"url":"https://api.aimsapi.com/v1/custom-tag/remove-track/by-id","description":"This endpoint allows you to remove a track from a custom tag. To remove external tracks (tracks added by URL, file URL or file), use the id_client value of respective track (e.g. url:9aacbc9479f4baf2684fc82536422808).
This endpoint allows you to obtain suggestions of tracks that are similar to the custom tag specified by its key. The results are sorted from the most similar tracks.
\n","urlObject":{"path":["v1","custom-tag","suggest","by-key"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"f0d94de4-caa3-4254-aaec-7671007225c7","name":"Suggest Tracks based on the Custom Tag by Key","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"key\": \"{{customTag.key}}\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}"},"url":"https://api.aimsapi.com/v1/custom-tag/suggest/by-key"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:14:24 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"498"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"de8c22b6-239b-48c0-ba45-2aaf44b882e7\",\n \"tracks\": [\n {\n \"id\": 141907771,\n \"id_client\": \"RVR60#5\",\n \"duration\": 324,\n \"release_year\": 2019,\n \"track_name\": \"Lines\",\n \"tags\": [\n \"RVR\"\n ],\n \"processed_at\": \"2021-03-18T17:26:04.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ZjBkY2FlZGI1MTQ4ZjI0ZGI2NWViZjNiYTA2NTE3NmQ=\"\n },\n {\n \"id\": 141885892,\n \"id_client\": \"DEN28#9\",\n \"duration\": 212,\n \"release_year\": 2018,\n \"track_name\": \"Better With You\",\n \"tags\": [\n \"DEN\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 141641839,\n \"id_client\": \"SUPI22#35\",\n \"duration\": 217,\n \"release_year\": 2017,\n \"track_name\": \"Constellations\",\n \"tags\": [\n \"SUPI\"\n ],\n \"processed_at\": \"2021-02-18T10:25:42.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"Y2QwNjcwMzY4ODQ0ZGVmY2Q5MzQyODE5MTY0ODEzM2Q=\"\n },\n {\n \"id\": 141907464,\n \"id_client\": \"RVR60#18\",\n \"duration\": 322,\n \"release_year\": 2019,\n \"track_name\": \"Lines\",\n \"tags\": [\n \"RVR\"\n ],\n \"processed_at\": \"2021-03-18T17:15:52.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ODgxYzJjNDZiYjcwZjE5OTM4MTE3NThjY2ZhNjg5NzA=\"\n },\n {\n \"id\": 141885542,\n \"id_client\": \"DED164#12\",\n \"duration\": 244,\n \"release_year\": 2015,\n \"track_name\": \"Goodnight Sweet Dreams (a)\",\n \"tags\": [\n \"DED\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 141652702,\n \"id_client\": \"BAM-AL112#18\",\n \"duration\": 167,\n \"release_year\": 2018,\n \"track_name\": \"Shame\",\n \"tags\": [\n \"BAM-AL\"\n ],\n \"processed_at\": \"2021-03-09T11:23:47.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"YjJjYzcxYmNjZjlmOTNlNDE4ZjI2MGZhNGZlZjFmYmE=\"\n },\n {\n \"id\": 141856748,\n \"id_client\": \"DCD129#35\",\n \"duration\": 220,\n \"release_year\": 2016,\n \"track_name\": \"The Tide Can Turn\",\n \"tags\": [\n \"DCD\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 143709686,\n \"id_client\": \"AR20#106\",\n \"duration\": 228,\n \"release_year\": 2020,\n \"track_name\": \"Landslide\",\n \"tags\": [\n \"AR\"\n ],\n \"processed_at\": \"2020-05-15T11:58:48.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJFZIenhWOHhCdU10RTFCNjhvTklFai5Bb0RJVHc3bDdjdTBGZkgxdkJLMGx5QXZTMkNWTERT\"\n },\n {\n \"id\": 143807881,\n \"id_client\": \"MH222#35\",\n \"duration\": 178,\n \"release_year\": 2020,\n \"track_name\": \"Faded\",\n \"tags\": [\n \"MH\"\n ],\n \"processed_at\": \"2020-08-09T08:48:15.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJDg2bWRtR21GQmxEclA1a3BwaC9qemVBMkYuenBSRy84cTRCZERsMDVEZjBMUWR6L1JaUjEu\"\n },\n {\n \"id\": 141762817,\n \"id_client\": \"CAVCD348#41\",\n \"duration\": 179,\n \"release_year\": 2013,\n \"track_name\": \"METAPHYSICAL\",\n \"tags\": [\n \"CAVCD\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 141923225,\n \"id_client\": \"WSR513#66\",\n \"duration\": 147,\n \"release_year\": 2020,\n \"track_name\": \"Cybercrime\",\n \"tags\": [\n \"WSR\"\n ],\n \"processed_at\": \"2021-03-25T08:51:11.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"YzZjOTQ0YWZlZGI5ZDRkNGJiMGNlNjk2NzQ0Mzg3YmQ=\"\n },\n {\n \"id\": 143808126,\n \"id_client\": \"MH222#52\",\n \"duration\": 177,\n \"release_year\": 2020,\n \"track_name\": \"Faded\",\n \"tags\": [\n \"MH\"\n ],\n \"processed_at\": \"2020-08-09T09:06:37.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJHRCYXVxRlpBcGU5V2UyRzlYSXprTmUvWHJwOGNIcUgvL1NhUmhJdFlQazRFRGh3MHZQcTlH\"\n },\n {\n \"id\": 143256965,\n \"id_client\": \"GA72#19\",\n \"duration\": 182,\n \"release_year\": 2020,\n \"track_name\": \"Build An Empire\",\n \"tags\": [\n \"GA\"\n ],\n \"processed_at\": \"2020-11-08T21:07:10.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ZmQ4Yzg0NmVlY2ViMmUyZjdmZGUzOWJmMDQxNzY0YTI=\"\n },\n {\n \"id\": 143142327,\n \"id_client\": \"XMT266#176\",\n \"duration\": 216,\n \"release_year\": 2016,\n \"track_name\": \"Stay Down\",\n \"tags\": [\n \"XMT\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 143700977,\n \"id_client\": \"DEM241#19\",\n \"duration\": 191,\n \"release_year\": 2019,\n \"track_name\": \"Waves Of Blue\",\n \"tags\": [\n \"DEM\"\n ],\n \"processed_at\": \"2020-04-21T18:48:32.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJHllLjBHZGM4RmdLanJZQlZxcUJ4OS5zSVM3clFFcWdrNjEvSHQzdGdlWVI2aVZSdVZGR1pP\"\n },\n {\n \"id\": 142204903,\n \"id_client\": \"GA72#18\",\n \"duration\": 182,\n \"release_year\": 2020,\n \"track_name\": \"Build An Empire\",\n \"tags\": [\n \"GA\"\n ],\n \"processed_at\": \"2020-11-04T08:04:21.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"NjQ4ODdlNDAyYTY1ZDEwZGI3MDNiZGNiZmU2NDJhNGE=\"\n },\n {\n \"id\": 142144687,\n \"id_client\": \"JM155#11\",\n \"duration\": 176,\n \"release_year\": 2017,\n \"track_name\": \"Straight Like That (a)\",\n \"tags\": [\n \"JM\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 143284454,\n \"id_client\": \"JM267#8\",\n \"duration\": 135,\n \"release_year\": 2020,\n \"track_name\": \"Think It Over\",\n \"tags\": [\n \"JM\"\n ],\n \"processed_at\": \"2020-11-20T22:14:02.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ZjRhNjBiMGViY2I3MDJhMDIxMWM5MjQ2NTM1NTc1ODM=\"\n },\n {\n \"id\": 141938265,\n \"id_client\": \"EM5300#26\",\n \"duration\": 154,\n \"release_year\": 2017,\n \"track_name\": \"Post Modern Witchcraft\",\n \"tags\": [\n \"EM\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 142757198,\n \"id_client\": \"NTPM666#1\",\n \"duration\": 388,\n \"release_year\": 2016,\n \"track_name\": \"Ninja Tune Production Music Audio Reel\",\n \"tags\": [\n \"NTPM\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n }\n ]\n}"}],"_postman_id":"79e7fb0d-0166-4c9d-91ca-db0339900c01"},{"name":"Suggest Tracks based on the Custom Tag by ID","id":"2a84a60e-71ab-437f-8fc3-807e47f5298c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"{{customTag.id}}\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}"},"url":"https://api.aimsapi.com/v1/custom-tag/suggest/by-id","description":"This endpoint allows you to obtain suggestions of tracks that are similar to the custom tag specified by its ID. The results are sorted from the most similar tracks.
\n","urlObject":{"path":["v1","custom-tag","suggest","by-id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"e5a5e366-bf85-4d75-8865-a99d0dc5a081","name":"Suggest Tracks based on the Custom Tag by ID","originalRequest":{"method":"POST","header":[{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Accept","value":"application/json"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"{{customTag.id}}\",\n\t\"page\": 1,\n\t\"page_size\": 20\n}"},"url":"https://api.aimsapi.com/v1/custom-tag/suggest/by-id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"description":{"content":"","type":"text/plain"},"key":"Server","value":"nginx/1.19.10"},{"description":{"content":"","type":"text/plain"},"key":"Transfer-Encoding","value":"chunked"},{"description":{"content":"","type":"text/plain"},"key":"X-Powered-By","value":"PHP/7.4.13"},{"description":{"content":"","type":"text/plain"},"key":"Cache-Control","value":"no-cache, private"},{"description":{"content":"","type":"text/plain"},"key":"Date","value":"Thu, 06 Jan 2022 18:14:38 GMT"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Limit","value":"500"},{"description":{"content":"","type":"text/plain"},"key":"X-RateLimit-Remaining","value":"497"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Allow-Origin","value":"*"},{"description":{"content":"","type":"text/plain"},"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"description":{"content":"","type":"text/plain"},"key":"Via","value":"1.1 google"},{"description":{"content":"","type":"text/plain"},"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"3618a9dc-b092-4853-a521-a65297638a2e\",\n \"tracks\": [\n {\n \"id\": 141907771,\n \"id_client\": \"RVR60#5\",\n \"duration\": 324,\n \"release_year\": 2019,\n \"track_name\": \"Lines\",\n \"tags\": [\n \"RVR\"\n ],\n \"processed_at\": \"2021-03-18T17:26:04.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ZjBkY2FlZGI1MTQ4ZjI0ZGI2NWViZjNiYTA2NTE3NmQ=\"\n },\n {\n \"id\": 141885892,\n \"id_client\": \"DEN28#9\",\n \"duration\": 212,\n \"release_year\": 2018,\n \"track_name\": \"Better With You\",\n \"tags\": [\n \"DEN\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 141641839,\n \"id_client\": \"SUPI22#35\",\n \"duration\": 217,\n \"release_year\": 2017,\n \"track_name\": \"Constellations\",\n \"tags\": [\n \"SUPI\"\n ],\n \"processed_at\": \"2021-02-18T10:25:42.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"Y2QwNjcwMzY4ODQ0ZGVmY2Q5MzQyODE5MTY0ODEzM2Q=\"\n },\n {\n \"id\": 141907464,\n \"id_client\": \"RVR60#18\",\n \"duration\": 322,\n \"release_year\": 2019,\n \"track_name\": \"Lines\",\n \"tags\": [\n \"RVR\"\n ],\n \"processed_at\": \"2021-03-18T17:15:52.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ODgxYzJjNDZiYjcwZjE5OTM4MTE3NThjY2ZhNjg5NzA=\"\n },\n {\n \"id\": 141885542,\n \"id_client\": \"DED164#12\",\n \"duration\": 244,\n \"release_year\": 2015,\n \"track_name\": \"Goodnight Sweet Dreams (a)\",\n \"tags\": [\n \"DED\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 141652702,\n \"id_client\": \"BAM-AL112#18\",\n \"duration\": 167,\n \"release_year\": 2018,\n \"track_name\": \"Shame\",\n \"tags\": [\n \"BAM-AL\"\n ],\n \"processed_at\": \"2021-03-09T11:23:47.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"YjJjYzcxYmNjZjlmOTNlNDE4ZjI2MGZhNGZlZjFmYmE=\"\n },\n {\n \"id\": 141856748,\n \"id_client\": \"DCD129#35\",\n \"duration\": 220,\n \"release_year\": 2016,\n \"track_name\": \"The Tide Can Turn\",\n \"tags\": [\n \"DCD\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 143709686,\n \"id_client\": \"AR20#106\",\n \"duration\": 228,\n \"release_year\": 2020,\n \"track_name\": \"Landslide\",\n \"tags\": [\n \"AR\"\n ],\n \"processed_at\": \"2020-05-15T11:58:48.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJFZIenhWOHhCdU10RTFCNjhvTklFai5Bb0RJVHc3bDdjdTBGZkgxdkJLMGx5QXZTMkNWTERT\"\n },\n {\n \"id\": 143807881,\n \"id_client\": \"MH222#35\",\n \"duration\": 178,\n \"release_year\": 2020,\n \"track_name\": \"Faded\",\n \"tags\": [\n \"MH\"\n ],\n \"processed_at\": \"2020-08-09T08:48:15.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJDg2bWRtR21GQmxEclA1a3BwaC9qemVBMkYuenBSRy84cTRCZERsMDVEZjBMUWR6L1JaUjEu\"\n },\n {\n \"id\": 141762817,\n \"id_client\": \"CAVCD348#41\",\n \"duration\": 179,\n \"release_year\": 2013,\n \"track_name\": \"METAPHYSICAL\",\n \"tags\": [\n \"CAVCD\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 141923225,\n \"id_client\": \"WSR513#66\",\n \"duration\": 147,\n \"release_year\": 2020,\n \"track_name\": \"Cybercrime\",\n \"tags\": [\n \"WSR\"\n ],\n \"processed_at\": \"2021-03-25T08:51:11.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"YzZjOTQ0YWZlZGI5ZDRkNGJiMGNlNjk2NzQ0Mzg3YmQ=\"\n },\n {\n \"id\": 143808126,\n \"id_client\": \"MH222#52\",\n \"duration\": 177,\n \"release_year\": 2020,\n \"track_name\": \"Faded\",\n \"tags\": [\n \"MH\"\n ],\n \"processed_at\": \"2020-08-09T09:06:37.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJHRCYXVxRlpBcGU5V2UyRzlYSXprTmUvWHJwOGNIcUgvL1NhUmhJdFlQazRFRGh3MHZQcTlH\"\n },\n {\n \"id\": 143256965,\n \"id_client\": \"GA72#19\",\n \"duration\": 182,\n \"release_year\": 2020,\n \"track_name\": \"Build An Empire\",\n \"tags\": [\n \"GA\"\n ],\n \"processed_at\": \"2020-11-08T21:07:10.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ZmQ4Yzg0NmVlY2ViMmUyZjdmZGUzOWJmMDQxNzY0YTI=\"\n },\n {\n \"id\": 143142327,\n \"id_client\": \"XMT266#176\",\n \"duration\": 216,\n \"release_year\": 2016,\n \"track_name\": \"Stay Down\",\n \"tags\": [\n \"XMT\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 143700977,\n \"id_client\": \"DEM241#19\",\n \"duration\": 191,\n \"release_year\": 2019,\n \"track_name\": \"Waves Of Blue\",\n \"tags\": [\n \"DEM\"\n ],\n \"processed_at\": \"2020-04-21T18:48:32.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJHllLjBHZGM4RmdLanJZQlZxcUJ4OS5zSVM3clFFcWdrNjEvSHQzdGdlWVI2aVZSdVZGR1pP\"\n },\n {\n \"id\": 142204903,\n \"id_client\": \"GA72#18\",\n \"duration\": 182,\n \"release_year\": 2020,\n \"track_name\": \"Build An Empire\",\n \"tags\": [\n \"GA\"\n ],\n \"processed_at\": \"2020-11-04T08:04:21.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"NjQ4ODdlNDAyYTY1ZDEwZGI3MDNiZGNiZmU2NDJhNGE=\"\n },\n {\n \"id\": 142144687,\n \"id_client\": \"JM155#11\",\n \"duration\": 176,\n \"release_year\": 2017,\n \"track_name\": \"Straight Like That (a)\",\n \"tags\": [\n \"JM\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 143284454,\n \"id_client\": \"JM267#8\",\n \"duration\": 135,\n \"release_year\": 2020,\n \"track_name\": \"Think It Over\",\n \"tags\": [\n \"JM\"\n ],\n \"processed_at\": \"2020-11-20T22:14:02.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ZjRhNjBiMGViY2I3MDJhMDIxMWM5MjQ2NTM1NTc1ODM=\"\n },\n {\n \"id\": 141938265,\n \"id_client\": \"EM5300#26\",\n \"duration\": 154,\n \"release_year\": 2017,\n \"track_name\": \"Post Modern Witchcraft\",\n \"tags\": [\n \"EM\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 142757198,\n \"id_client\": \"NTPM666#1\",\n \"duration\": 388,\n \"release_year\": 2016,\n \"track_name\": \"Ninja Tune Production Music Audio Reel\",\n \"tags\": [\n \"NTPM\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n }\n ]\n}"}],"_postman_id":"2a84a60e-71ab-437f-8fc3-807e47f5298c"}],"id":"55fb4b47-8ded-4a63-b008-e8909aac03c1","_postman_id":"55fb4b47-8ded-4a63-b008-e8909aac03c1","description":""},{"name":"Filtering","item":[{"name":"Filter suggested Tracks by Key","id":"67e9d1da-ca31-4822-bec9-052fb85807e1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"key\": \"{{customTagKey}}\",\n\t\"page\": 1,\n\t\"page_size\": 100,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n {\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 60\n\t\t\t},\n {\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"lte\",\n\t\t\t\t\"value\": 265\n\t\t\t},\n {\n\t\t\t\t\"field\": \"release_year\",\n\t\t\t\t\"operator\": \"neq\",\n\t\t\t\t\"value\": 2016\n\t\t\t},\n {\n\t\t\t\t\"field\": \"release_year\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 1992\n\t\t\t},\n {\n\t\t\t\t\"field\": \"release_year\",\n\t\t\t\t\"operator\": \"lte\",\n\t\t\t\t\"value\": 2022\n\t\t\t},\n {\n\t\t\t\t\"field\": \"genres\",\n\t\t\t\t\"operator\": \"empty\",\n\t\t\t\t\"value\": null\n\t\t\t},\n {\n\t\t\t\t\"field\": \"instruments\",\n\t\t\t\t\"operator\": \"not-contains\",\n\t\t\t\t\"value\": \"flute\"\n\t\t\t}\n\t\t]\n\t}\n}"},"url":"https://api.aimsapi.com/v1/custom-tag/suggest/by-key","description":"This endpoint allows you to obtain suggestions of tracks that are similar to the custom tag specified by its key. The results are sorted from the most similar tracks.
\n","urlObject":{"path":["v1","custom-tag","suggest","by-key"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"8e79924c-2542-40fb-84d6-44adfb55df66","name":"Suggest Tracks based on the Custom Tag by Key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"key\": \"{{customTagKey}}\",\n\t\"page\": 1,\n\t\"page_size\": 100,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n {\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 60\n\t\t\t},\n {\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"lte\",\n\t\t\t\t\"value\": 265\n\t\t\t},\n {\n\t\t\t\t\"field\": \"release_year\",\n\t\t\t\t\"operator\": \"neq\",\n\t\t\t\t\"value\": 2016\n\t\t\t},\n {\n\t\t\t\t\"field\": \"release_year\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 1992\n\t\t\t},\n {\n\t\t\t\t\"field\": \"release_year\",\n\t\t\t\t\"operator\": \"lte\",\n\t\t\t\t\"value\": 2022\n\t\t\t},\n {\n\t\t\t\t\"field\": \"genres\",\n\t\t\t\t\"operator\": \"empty\",\n\t\t\t\t\"value\": null\n\t\t\t},\n {\n\t\t\t\t\"field\": \"instruments\",\n\t\t\t\t\"operator\": \"not-contains\",\n\t\t\t\t\"value\": \"flute\"\n\t\t\t}\n\t\t]\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/custom-tag/suggest/by-key"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.19.10"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"X-Powered-By","value":"PHP/7.4.13"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 06 Jan 2022 18:14:24 GMT"},{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"498"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"de8c22b6-239b-48c0-ba45-2aaf44b882e7\",\n \"tracks\": [\n {\n \"id\": 141907771,\n \"id_client\": \"RVR60#5\",\n \"duration\": 324,\n \"release_year\": 2019,\n \"track_name\": \"Lines\",\n \"tags\": [\n \"RVR\"\n ],\n \"processed_at\": \"2021-03-18T17:26:04.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ZjBkY2FlZGI1MTQ4ZjI0ZGI2NWViZjNiYTA2NTE3NmQ=\"\n },\n {\n \"id\": 141885892,\n \"id_client\": \"DEN28#9\",\n \"duration\": 212,\n \"release_year\": 2018,\n \"track_name\": \"Better With You\",\n \"tags\": [\n \"DEN\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 141641839,\n \"id_client\": \"SUPI22#35\",\n \"duration\": 217,\n \"release_year\": 2017,\n \"track_name\": \"Constellations\",\n \"tags\": [\n \"SUPI\"\n ],\n \"processed_at\": \"2021-02-18T10:25:42.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"Y2QwNjcwMzY4ODQ0ZGVmY2Q5MzQyODE5MTY0ODEzM2Q=\"\n },\n {\n \"id\": 141907464,\n \"id_client\": \"RVR60#18\",\n \"duration\": 322,\n \"release_year\": 2019,\n \"track_name\": \"Lines\",\n \"tags\": [\n \"RVR\"\n ],\n \"processed_at\": \"2021-03-18T17:15:52.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ODgxYzJjNDZiYjcwZjE5OTM4MTE3NThjY2ZhNjg5NzA=\"\n },\n {\n \"id\": 141885542,\n \"id_client\": \"DED164#12\",\n \"duration\": 244,\n \"release_year\": 2015,\n \"track_name\": \"Goodnight Sweet Dreams (a)\",\n \"tags\": [\n \"DED\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 141652702,\n \"id_client\": \"BAM-AL112#18\",\n \"duration\": 167,\n \"release_year\": 2018,\n \"track_name\": \"Shame\",\n \"tags\": [\n \"BAM-AL\"\n ],\n \"processed_at\": \"2021-03-09T11:23:47.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"YjJjYzcxYmNjZjlmOTNlNDE4ZjI2MGZhNGZlZjFmYmE=\"\n },\n {\n \"id\": 141856748,\n \"id_client\": \"DCD129#35\",\n \"duration\": 220,\n \"release_year\": 2016,\n \"track_name\": \"The Tide Can Turn\",\n \"tags\": [\n \"DCD\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 143709686,\n \"id_client\": \"AR20#106\",\n \"duration\": 228,\n \"release_year\": 2020,\n \"track_name\": \"Landslide\",\n \"tags\": [\n \"AR\"\n ],\n \"processed_at\": \"2020-05-15T11:58:48.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJFZIenhWOHhCdU10RTFCNjhvTklFai5Bb0RJVHc3bDdjdTBGZkgxdkJLMGx5QXZTMkNWTERT\"\n },\n {\n \"id\": 143807881,\n \"id_client\": \"MH222#35\",\n \"duration\": 178,\n \"release_year\": 2020,\n \"track_name\": \"Faded\",\n \"tags\": [\n \"MH\"\n ],\n \"processed_at\": \"2020-08-09T08:48:15.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJDg2bWRtR21GQmxEclA1a3BwaC9qemVBMkYuenBSRy84cTRCZERsMDVEZjBMUWR6L1JaUjEu\"\n },\n {\n \"id\": 141762817,\n \"id_client\": \"CAVCD348#41\",\n \"duration\": 179,\n \"release_year\": 2013,\n \"track_name\": \"METAPHYSICAL\",\n \"tags\": [\n \"CAVCD\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 141923225,\n \"id_client\": \"WSR513#66\",\n \"duration\": 147,\n \"release_year\": 2020,\n \"track_name\": \"Cybercrime\",\n \"tags\": [\n \"WSR\"\n ],\n \"processed_at\": \"2021-03-25T08:51:11.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"YzZjOTQ0YWZlZGI5ZDRkNGJiMGNlNjk2NzQ0Mzg3YmQ=\"\n },\n {\n \"id\": 143808126,\n \"id_client\": \"MH222#52\",\n \"duration\": 177,\n \"release_year\": 2020,\n \"track_name\": \"Faded\",\n \"tags\": [\n \"MH\"\n ],\n \"processed_at\": \"2020-08-09T09:06:37.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJHRCYXVxRlpBcGU5V2UyRzlYSXprTmUvWHJwOGNIcUgvL1NhUmhJdFlQazRFRGh3MHZQcTlH\"\n },\n {\n \"id\": 143256965,\n \"id_client\": \"GA72#19\",\n \"duration\": 182,\n \"release_year\": 2020,\n \"track_name\": \"Build An Empire\",\n \"tags\": [\n \"GA\"\n ],\n \"processed_at\": \"2020-11-08T21:07:10.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ZmQ4Yzg0NmVlY2ViMmUyZjdmZGUzOWJmMDQxNzY0YTI=\"\n },\n {\n \"id\": 143142327,\n \"id_client\": \"XMT266#176\",\n \"duration\": 216,\n \"release_year\": 2016,\n \"track_name\": \"Stay Down\",\n \"tags\": [\n \"XMT\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 143700977,\n \"id_client\": \"DEM241#19\",\n \"duration\": 191,\n \"release_year\": 2019,\n \"track_name\": \"Waves Of Blue\",\n \"tags\": [\n \"DEM\"\n ],\n \"processed_at\": \"2020-04-21T18:48:32.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJHllLjBHZGM4RmdLanJZQlZxcUJ4OS5zSVM3clFFcWdrNjEvSHQzdGdlWVI2aVZSdVZGR1pP\"\n },\n {\n \"id\": 142204903,\n \"id_client\": \"GA72#18\",\n \"duration\": 182,\n \"release_year\": 2020,\n \"track_name\": \"Build An Empire\",\n \"tags\": [\n \"GA\"\n ],\n \"processed_at\": \"2020-11-04T08:04:21.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"NjQ4ODdlNDAyYTY1ZDEwZGI3MDNiZGNiZmU2NDJhNGE=\"\n },\n {\n \"id\": 142144687,\n \"id_client\": \"JM155#11\",\n \"duration\": 176,\n \"release_year\": 2017,\n \"track_name\": \"Straight Like That (a)\",\n \"tags\": [\n \"JM\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 143284454,\n \"id_client\": \"JM267#8\",\n \"duration\": 135,\n \"release_year\": 2020,\n \"track_name\": \"Think It Over\",\n \"tags\": [\n \"JM\"\n ],\n \"processed_at\": \"2020-11-20T22:14:02.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ZjRhNjBiMGViY2I3MDJhMDIxMWM5MjQ2NTM1NTc1ODM=\"\n },\n {\n \"id\": 141938265,\n \"id_client\": \"EM5300#26\",\n \"duration\": 154,\n \"release_year\": 2017,\n \"track_name\": \"Post Modern Witchcraft\",\n \"tags\": [\n \"EM\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 142757198,\n \"id_client\": \"NTPM666#1\",\n \"duration\": 388,\n \"release_year\": 2016,\n \"track_name\": \"Ninja Tune Production Music Audio Reel\",\n \"tags\": [\n \"NTPM\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n }\n ]\n}"}],"_postman_id":"67e9d1da-ca31-4822-bec9-052fb85807e1"},{"name":"Filter suggested Tracks by ID","id":"12fe9d7b-b7e3-4e23-b938-00fb329567b3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"id\": \"{{customTagId}}\",\n\t\"page\": 1,\n\t\"page_size\": 100,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n {\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 60\n\t\t\t},\n {\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"lte\",\n\t\t\t\t\"value\": 265\n\t\t\t},\n {\n\t\t\t\t\"field\": \"release_year\",\n\t\t\t\t\"operator\": \"neq\",\n\t\t\t\t\"value\": 2016\n\t\t\t},\n {\n\t\t\t\t\"field\": \"release_year\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 1992\n\t\t\t},\n {\n\t\t\t\t\"field\": \"release_year\",\n\t\t\t\t\"operator\": \"lte\",\n\t\t\t\t\"value\": 2022\n\t\t\t},\n {\n\t\t\t\t\"field\": \"genres\",\n\t\t\t\t\"operator\": \"empty\",\n\t\t\t\t\"value\": null\n\t\t\t},\n {\n\t\t\t\t\"field\": \"instruments\",\n\t\t\t\t\"operator\": \"not-contains\",\n\t\t\t\t\"value\": \"flute\"\n\t\t\t}\n\t\t]\n\t}\n}"},"url":"https://api.aimsapi.com/v1/custom-tag/suggest/by-id","description":"This endpoint allows you to obtain suggestions of tracks that are similar to the custom tag specified by its ID. The results are sorted from the most similar tracks.
\n","urlObject":{"path":["v1","custom-tag","suggest","by-id"],"host":["https://api.aimsapi.com"],"query":[],"variable":[]}},"response":[{"id":"97997c6d-4aa9-4f3c-a993-a408fc514bf4","name":"Suggest Tracks based on the Custom Tag by ID","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"body":{"mode":"raw","raw":"{\n\t\"key\": \"{{customTagId}}\",\n\t\"page\": 1,\n\t\"page_size\": 100,\n \"filter\": {\n\t\t\"logic\": \"and\",\n\t\t\"conditions\": [\n {\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 60\n\t\t\t},\n {\n\t\t\t\t\"field\": \"duration\",\n\t\t\t\t\"operator\": \"lte\",\n\t\t\t\t\"value\": 265\n\t\t\t},\n {\n\t\t\t\t\"field\": \"release_year\",\n\t\t\t\t\"operator\": \"neq\",\n\t\t\t\t\"value\": 2016\n\t\t\t},\n {\n\t\t\t\t\"field\": \"release_year\",\n\t\t\t\t\"operator\": \"gte\",\n\t\t\t\t\"value\": 1992\n\t\t\t},\n {\n\t\t\t\t\"field\": \"release_year\",\n\t\t\t\t\"operator\": \"lte\",\n\t\t\t\t\"value\": 2022\n\t\t\t},\n {\n\t\t\t\t\"field\": \"genres\",\n\t\t\t\t\"operator\": \"empty\",\n\t\t\t\t\"value\": null\n\t\t\t},\n {\n\t\t\t\t\"field\": \"instruments\",\n\t\t\t\t\"operator\": \"not-contains\",\n\t\t\t\t\"value\": \"flute\"\n\t\t\t}\n\t\t]\n\t}\n}","options":{"raw":{"language":"json"}}},"url":"https://api.aimsapi.com/v1/custom-tag/suggest/by-id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.19.10"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"X-Powered-By","value":"PHP/7.4.13"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 06 Jan 2022 18:14:38 GMT"},{"key":"X-RateLimit-Limit","value":"500"},{"key":"X-RateLimit-Remaining","value":"497"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"clear"}],"cookie":[],"responseTime":null,"body":"{\n \"query_id\": \"3618a9dc-b092-4853-a521-a65297638a2e\",\n \"tracks\": [\n {\n \"id\": 141907771,\n \"id_client\": \"RVR60#5\",\n \"duration\": 324,\n \"release_year\": 2019,\n \"track_name\": \"Lines\",\n \"tags\": [\n \"RVR\"\n ],\n \"processed_at\": \"2021-03-18T17:26:04.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ZjBkY2FlZGI1MTQ4ZjI0ZGI2NWViZjNiYTA2NTE3NmQ=\"\n },\n {\n \"id\": 141885892,\n \"id_client\": \"DEN28#9\",\n \"duration\": 212,\n \"release_year\": 2018,\n \"track_name\": \"Better With You\",\n \"tags\": [\n \"DEN\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 141641839,\n \"id_client\": \"SUPI22#35\",\n \"duration\": 217,\n \"release_year\": 2017,\n \"track_name\": \"Constellations\",\n \"tags\": [\n \"SUPI\"\n ],\n \"processed_at\": \"2021-02-18T10:25:42.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"Y2QwNjcwMzY4ODQ0ZGVmY2Q5MzQyODE5MTY0ODEzM2Q=\"\n },\n {\n \"id\": 141907464,\n \"id_client\": \"RVR60#18\",\n \"duration\": 322,\n \"release_year\": 2019,\n \"track_name\": \"Lines\",\n \"tags\": [\n \"RVR\"\n ],\n \"processed_at\": \"2021-03-18T17:15:52.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ODgxYzJjNDZiYjcwZjE5OTM4MTE3NThjY2ZhNjg5NzA=\"\n },\n {\n \"id\": 141885542,\n \"id_client\": \"DED164#12\",\n \"duration\": 244,\n \"release_year\": 2015,\n \"track_name\": \"Goodnight Sweet Dreams (a)\",\n \"tags\": [\n \"DED\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 141652702,\n \"id_client\": \"BAM-AL112#18\",\n \"duration\": 167,\n \"release_year\": 2018,\n \"track_name\": \"Shame\",\n \"tags\": [\n \"BAM-AL\"\n ],\n \"processed_at\": \"2021-03-09T11:23:47.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"YjJjYzcxYmNjZjlmOTNlNDE4ZjI2MGZhNGZlZjFmYmE=\"\n },\n {\n \"id\": 141856748,\n \"id_client\": \"DCD129#35\",\n \"duration\": 220,\n \"release_year\": 2016,\n \"track_name\": \"The Tide Can Turn\",\n \"tags\": [\n \"DCD\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 143709686,\n \"id_client\": \"AR20#106\",\n \"duration\": 228,\n \"release_year\": 2020,\n \"track_name\": \"Landslide\",\n \"tags\": [\n \"AR\"\n ],\n \"processed_at\": \"2020-05-15T11:58:48.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJFZIenhWOHhCdU10RTFCNjhvTklFai5Bb0RJVHc3bDdjdTBGZkgxdkJLMGx5QXZTMkNWTERT\"\n },\n {\n \"id\": 143807881,\n \"id_client\": \"MH222#35\",\n \"duration\": 178,\n \"release_year\": 2020,\n \"track_name\": \"Faded\",\n \"tags\": [\n \"MH\"\n ],\n \"processed_at\": \"2020-08-09T08:48:15.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJDg2bWRtR21GQmxEclA1a3BwaC9qemVBMkYuenBSRy84cTRCZERsMDVEZjBMUWR6L1JaUjEu\"\n },\n {\n \"id\": 141762817,\n \"id_client\": \"CAVCD348#41\",\n \"duration\": 179,\n \"release_year\": 2013,\n \"track_name\": \"METAPHYSICAL\",\n \"tags\": [\n \"CAVCD\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 141923225,\n \"id_client\": \"WSR513#66\",\n \"duration\": 147,\n \"release_year\": 2020,\n \"track_name\": \"Cybercrime\",\n \"tags\": [\n \"WSR\"\n ],\n \"processed_at\": \"2021-03-25T08:51:11.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"YzZjOTQ0YWZlZGI5ZDRkNGJiMGNlNjk2NzQ0Mzg3YmQ=\"\n },\n {\n \"id\": 143808126,\n \"id_client\": \"MH222#52\",\n \"duration\": 177,\n \"release_year\": 2020,\n \"track_name\": \"Faded\",\n \"tags\": [\n \"MH\"\n ],\n \"processed_at\": \"2020-08-09T09:06:37.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJHRCYXVxRlpBcGU5V2UyRzlYSXprTmUvWHJwOGNIcUgvL1NhUmhJdFlQazRFRGh3MHZQcTlH\"\n },\n {\n \"id\": 143256965,\n \"id_client\": \"GA72#19\",\n \"duration\": 182,\n \"release_year\": 2020,\n \"track_name\": \"Build An Empire\",\n \"tags\": [\n \"GA\"\n ],\n \"processed_at\": \"2020-11-08T21:07:10.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ZmQ4Yzg0NmVlY2ViMmUyZjdmZGUzOWJmMDQxNzY0YTI=\"\n },\n {\n \"id\": 143142327,\n \"id_client\": \"XMT266#176\",\n \"duration\": 216,\n \"release_year\": 2016,\n \"track_name\": \"Stay Down\",\n \"tags\": [\n \"XMT\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 143700977,\n \"id_client\": \"DEM241#19\",\n \"duration\": 191,\n \"release_year\": 2019,\n \"track_name\": \"Waves Of Blue\",\n \"tags\": [\n \"DEM\"\n ],\n \"processed_at\": \"2020-04-21T18:48:32.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"JDJ5JDEwJHllLjBHZGM4RmdLanJZQlZxcUJ4OS5zSVM3clFFcWdrNjEvSHQzdGdlWVI2aVZSdVZGR1pP\"\n },\n {\n \"id\": 142204903,\n \"id_client\": \"GA72#18\",\n \"duration\": 182,\n \"release_year\": 2020,\n \"track_name\": \"Build An Empire\",\n \"tags\": [\n \"GA\"\n ],\n \"processed_at\": \"2020-11-04T08:04:21.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"NjQ4ODdlNDAyYTY1ZDEwZGI3MDNiZGNiZmU2NDJhNGE=\"\n },\n {\n \"id\": 142144687,\n \"id_client\": \"JM155#11\",\n \"duration\": 176,\n \"release_year\": 2017,\n \"track_name\": \"Straight Like That (a)\",\n \"tags\": [\n \"JM\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 143284454,\n \"id_client\": \"JM267#8\",\n \"duration\": 135,\n \"release_year\": 2020,\n \"track_name\": \"Think It Over\",\n \"tags\": [\n \"JM\"\n ],\n \"processed_at\": \"2020-11-20T22:14:02.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": \"ZjRhNjBiMGViY2I3MDJhMDIxMWM5MjQ2NTM1NTc1ODM=\"\n },\n {\n \"id\": 141938265,\n \"id_client\": \"EM5300#26\",\n \"duration\": 154,\n \"release_year\": 2017,\n \"track_name\": \"Post Modern Witchcraft\",\n \"tags\": [\n \"EM\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n },\n {\n \"id\": 142757198,\n \"id_client\": \"NTPM666#1\",\n \"duration\": 388,\n \"release_year\": 2016,\n \"track_name\": \"Ninja Tune Production Music Audio Reel\",\n \"tags\": [\n \"NTPM\"\n ],\n \"processed_at\": \"2020-02-28T10:56:51.000000Z\",\n \"process_input_error\": null,\n \"store_secret\": null\n }\n ]\n}"}],"_postman_id":"12fe9d7b-b7e3-4e23-b938-00fb329567b3"}],"id":"9713b91c-9d9d-4c04-bc94-1217b30e591e","_postman_id":"9713b91c-9d9d-4c04-bc94-1217b30e591e","description":""}],"id":"78a577b5-a292-4212-aa8a-69cf97c94010","_postman_id":"78a577b5-a292-4212-aa8a-69cf97c94010","description":""},{"name":"Grouping","item":[{"name":"Getting groups","item":[{"name":"Projects","item":[{"name":"Get Groups from Project Listing","id":"4806ac28-97db-4554-b8f2-4c0316a40af2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"url":"https://api.aimsapi.com/v1/project?page=1&page_size=10&groups=true","urlObject":{"path":["v1","project"],"host":["https://api.aimsapi.com"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"},{"key":"groups","value":"true"}],"variable":[]}},"response":[{"id":"2546619c-a61b-45c3-9edd-725756f56fd7","name":"Get Groups from Projects Listing","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"url":{"raw":"https://api.aimsapi.com/v1/project?page=1&page_size=10&groups=true","host":["https://api.aimsapi.com"],"path":["v1","project"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"},{"key":"groups","value":"true"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length, X-Hash"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 16 Dec 2022 21:26:07 GMT"},{"key":"X-Next-Page","value":"http://api.aimsapi.com/v1/project?page=2&page_size=10&groups=true"},{"key":"X-Ratelimit-Limit","value":"10000"},{"key":"X-Ratelimit-Remaining","value":"9999"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"}],"cookie":[],"responseTime":null,"body":"{\n \"collections\": [\n {\n \"id\": \"875e7787-4f91-6a38-46ef-629e1976e117\",\n \"key\": \"my-cartoon-episode-4\",\n \"processed_at\": \"2022-10-01T01:23:45.000000Z\",\n \"updated_at\": \"2022-10-01T01:23:40.000000Z\",\n \"title\": \"My Cartoon: Episode 4\",\n \"grouping_data\": [\n {\n \"id\": \"244673d5-b2dd-446a-5487-bc2dd57d3f4b\",\n \"title\": \"Happy Playful Children Lifestyle Music with Bass, Drums and Sound Effects\",\n \"tracks\": [\n 123456789,\n 234567890,\n 345678901\n ]\n },\n {\n \"id\": \"344673d5-b2dd-446a-5487-bc2dd57d3f4b\",\n \"title\": \"Tension Adventure Instrumentals with Percussion\",\n \"tracks\": [\n 456789123,\n 567890234,\n 678901345\n ]\n }\n ]\n },\n ...\n {\n \"id\": \"775e7787-4f91-6a38-46ef-629e1976e117\",\n \"key\": \"some-other-project\",\n \"processed_at\": \"2022-10-01T01:23:45.000000Z\",\n \"updated_at\": \"2022-10-01T01:23:40.000000Z\",\n \"title\": \"Some Other Project\",\n \"grouping_data\": [\n ...\n ]\n },\n ],\n \"pagination\": {\n \"item_count\": 123\n }\n}"}],"_postman_id":"4806ac28-97db-4554-b8f2-4c0316a40af2"},{"name":"Get Groups from Project Detail","id":"1967fae6-82e8-406d-885a-2265fe41d962","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"url":"https://api.aimsapi.com/v1/project/get/by-key/projectKey?groups=true","urlObject":{"path":["v1","project","get","by-key","projectKey"],"host":["https://api.aimsapi.com"],"query":[{"key":"groups","value":"true"}],"variable":[]}},"response":[{"id":"066a7463-95a1-4eed-8262-3f5a317110b5","name":"Get Groups from Project Detail","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"url":{"raw":"https://api.aimsapi.com/v1/project/get/by-key/projectKey?groups=true","host":["https://api.aimsapi.com"],"path":["v1","project","get","by-key","projectKey"],"query":[{"key":"groups","value":"true"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length, X-Hash"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 16 Dec 2022 21:37:38 GMT"},{"key":"X-Ratelimit-Limit","value":"10000"},{"key":"X-Ratelimit-Remaining","value":"9994"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"875e7787-4f91-6a38-46ef-629e1976e117\",\n \"key\": \"my-cartoon-episode-4\",\n \"processed_at\": \"2022-10-01T01:23:45.000000Z\",\n \"updated_at\": \"2022-10-01T01:23:40.000000Z\",\n \"title\": \"My Cartoon: Episode 4\",\n \"grouping_data\": [\n {\n \"id\": \"244673d5-b2dd-446a-5487-bc2dd57d3f4b\",\n \"title\": \"Happy Playful Children Lifestyle Music with Bass, Drums and Sound Effects\",\n \"tracks\": [\n 123456789,\n 234567890,\n 345678901\n ]\n },\n {\n \"id\": \"344673d5-b2dd-446a-5487-bc2dd57d3f4b\",\n \"title\": \"Tension Adventure Instrumentals with Percussion\",\n \"tracks\": [\n 456789123,\n 567890234,\n 678901345\n ]\n }\n ]\n }\n}"}],"_postman_id":"1967fae6-82e8-406d-885a-2265fe41d962"}],"id":"a4cccf13-18b9-4767-b756-fdba3cef74f1","_postman_id":"a4cccf13-18b9-4767-b756-fdba3cef74f1","description":""},{"name":"Playlists","item":[{"name":"Get Groups from Playlists Listing","id":"8ca82e0b-d2b0-40fd-bdb3-3dfd919dcb2a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"url":"https://api.aimsapi.com/v1/playlist?page=1&page_size=10&groups=true","urlObject":{"path":["v1","playlist"],"host":["https://api.aimsapi.com"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"},{"key":"groups","value":"true"}],"variable":[]}},"response":[{"id":"ae4ac6a6-7a42-41fc-86d7-9364907f58a5","name":"Get Groups from Projects Listing","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"url":{"raw":"https://api.aimsapi.com/v1/playlist?page=1&page_size=10&groups=true","host":["https://api.aimsapi.com"],"path":["v1","playlist"],"query":[{"key":"page","value":"1"},{"key":"page_size","value":"10"},{"key":"groups","value":"true"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length, X-Hash"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 16 Dec 2022 21:26:07 GMT"},{"key":"X-Next-Page","value":"http://api.aimsapi.com/v1/project?page=2&page_size=10&groups=true"},{"key":"X-Ratelimit-Limit","value":"10000"},{"key":"X-Ratelimit-Remaining","value":"9999"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"}],"cookie":[],"responseTime":null,"body":"{\n \"collections\": [\n {\n \"id\": \"875e7787-4f91-6a38-46ef-629e1976e117\",\n \"key\": \"my-cartoon-episode-4\",\n \"processed_at\": \"2022-10-01T01:23:45.000000Z\",\n \"updated_at\": \"2022-10-01T01:23:40.000000Z\",\n \"title\": \"My Cartoon: Episode 4\",\n \"grouping_data\": [\n {\n \"id\": \"244673d5-b2dd-446a-5487-bc2dd57d3f4b\",\n \"title\": \"Happy Playful Children Lifestyle Music with Bass, Drums and Sound Effects\",\n \"tracks\": [\n 123456789,\n 234567890,\n 345678901\n ]\n },\n {\n \"id\": \"344673d5-b2dd-446a-5487-bc2dd57d3f4b\",\n \"title\": \"Tension Adventure Instrumentals with Percussion\",\n \"tracks\": [\n 456789123,\n 567890234,\n 678901345\n ]\n }\n ]\n },\n ...\n {\n \"id\": \"775e7787-4f91-6a38-46ef-629e1976e117\",\n \"key\": \"some-other-project\",\n \"processed_at\": \"2022-10-01T01:23:45.000000Z\",\n \"updated_at\": \"2022-10-01T01:23:40.000000Z\",\n \"title\": \"Some Other Project\",\n \"grouping_data\": [\n ...\n ]\n },\n ],\n \"pagination\": {\n \"item_count\": 123\n }\n}"}],"_postman_id":"8ca82e0b-d2b0-40fd-bdb3-3dfd919dcb2a"},{"name":"Get Groups from Playlist Detail","id":"2d1abdc9-a40e-40d1-8e87-8517803ab4f3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"url":"https://api.aimsapi.com/v1/playlist/get/by-key/playlist.key?groups=true","urlObject":{"path":["v1","playlist","get","by-key","playlist.key"],"host":["https://api.aimsapi.com"],"query":[{"key":"groups","value":"true"}],"variable":[]}},"response":[{"id":"ffdea816-24cc-4e0a-96e7-ad0b614af360","name":"Get Groups from Detail","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Requested-With","value":"XMLHttpRequest"},{"key":"Authorization","value":"123abc"}],"url":{"raw":"https://api.aimsapi.com/v1/playlist/get/by-key/playlist.key?groups=true","host":["https://api.aimsapi.com"],"path":["v1","playlist","get","by-key","playlist.key"],"query":[{"key":"groups","value":"true"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Expose-Headers","value":"Access-Control-Allow-Origin, Cache-Control, Content-Language, Content-Type, Expires, Last-Modified, Pragma, Audio-Length, X-Hash"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 16 Dec 2022 21:37:38 GMT"},{"key":"X-Ratelimit-Limit","value":"10000"},{"key":"X-Ratelimit-Remaining","value":"9994"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Via","value":"1.1 google"},{"key":"Alt-Svc","value":"h3=\":443\"; ma=2592000,h3-29=\":443\"; ma=2592000"}],"cookie":[],"responseTime":null,"body":"{\n \"collection\": {\n \"id\": \"875e7787-4f91-6a38-46ef-629e1976e117\",\n \"key\": \"my-cartoon-episode-4\",\n \"processed_at\": \"2022-10-01T01:23:45.000000Z\",\n \"updated_at\": \"2022-10-01T01:23:40.000000Z\",\n \"title\": \"My Cartoon: Episode 4\",\n \"grouping_data\": [\n {\n \"id\": \"244673d5-b2dd-446a-5487-bc2dd57d3f4b\",\n \"title\": \"Happy Playful Children Lifestyle Music with Bass, Drums and Sound Effects\",\n \"tracks\": [\n 123456789,\n 234567890,\n 345678901\n ]\n },\n {\n \"id\": \"344673d5-b2dd-446a-5487-bc2dd57d3f4b\",\n \"title\": \"Tension Adventure Instrumentals with Percussion\",\n \"tracks\": [\n 456789123,\n 567890234,\n 678901345\n ]\n }\n ]\n }\n}"}],"_postman_id":"2d1abdc9-a40e-40d1-8e87-8517803ab4f3"}],"id":"3ee71250-1700-40c4-8479-cf0c8c8027ea","_postman_id":"3ee71250-1700-40c4-8479-cf0c8c8027ea","description":""}],"id":"79e8a7bf-5a1c-4fa5-9325-76c4270c0d3e","description":"You can retrieve groups from any endpoint that returns a collection (album, artist, playlist, project, custom tag) by providing a groups parameter with a value of true.
To get recommendations or collections similar to a group, you need to provide the group_id parameter with an existing group ID. Please note that group IDs are generated (you can't choose them) and change every time you add or remove tracks to and from a collection.
You can choose between collection types: project / playlist by changing the URL path.
\nI.e.:/v1/project/suggest/by-key
/v1/playlist/suggest/by-key
You can choose between collection types: albums / artists by changing the URL path.
\nI.e.:/v1/artists/similar/by-key
/v1/albums/similar/by-key
The grouping functionality sorts tracks in your collections (albums, artists, playlists, projects, custom tags) into groups and allows you to get suggestions for those groups.
\nFor example, imagine you have a project with music for an episode of a children's cartoon show. You have several tracks in the project. Some might be playful and fast, while others might be tensive and slow, or even menacing. If you ask AIMS for suggestions for the whole project, the suggestions will take both types of tracks into account, and you'll be provided with suggestions that try to satisfy both fast, playful and slow tensive tracks, which might not give desired results. With grouping, AIMS will automatically sort your tracks into groups (in this case, they might be called \"Happy Playful Children Lifestyle Music with Bass, Drums and Sound Effects\" and \"Tension Adventure Instrumentals with Percussion\"), and you can get separate suggestions for each group.
\nPlease note that this functionality needs to be enabled on your account before you can use it.
\nThe examples below are based on projects, but the same requests can be issued for albums, artists, playlists and custom tags.
\n","_postman_id":"70957a0d-020c-4a4c-9c69-026dea38bdb8"}],"id":"a352822a-e0f8-4f03-858a-3e131aacec8f","event":[{"listen":"prerequest","script":{"id":"a40e7446-6c3d-4732-8391-8dedccede519","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"a13fba67-ae28-46e5-86cf-d6df68b8336e","type":"text/javascript","exec":[""]}}],"_postman_id":"a352822a-e0f8-4f03-858a-3e131aacec8f","description":""}],"id":"408a272f-97b7-445d-8e7d-f48c308bafdb","_postman_id":"408a272f-97b7-445d-8e7d-f48c308bafdb","description":""},{"name":"FAQ","item":[],"id":"333355b7-f86d-4961-9af2-7f3bf19a9020","description":"Yes, please contact us. We'll grant you access to the \"Playground account\".
\nYes, search requests and feedback requests support one-off token authentication, which is suitable for front-end usage. You should never use your API key on the front-end.
\nNo, there's currently no such package. We can provide you with access to our demo application which showcases the best practices, and we can share code samples from the demo application.
\nWe use Peaks.js (there's also a compatible back-end solution called Audiowaveform).
\nNo, there's no such functionality at the moment.
\nMetadata do not affect the similarity algorithm itself. You can use the metadata for filtering using the AIMS API. If you're running queries directly from the front-end, you might also want to render the results instantly. Having some human-readable metadata in the search response also makes it easier to validate the integration on both your and our end.
\nNo. Some metadata fields are required by default when adding tracks and are described in the add track endpoint. Those are defaults that can be set differently for your account - contact us if you need other settings.
\nYou can use any string value shorter than 256 characters. The value needs to be unique.
\nResults are always sorted by similarity descending. The most similar result is always first.
\nYes. As long as you want to have all your tracks tagged (i.e. not only a subset of them), you don't need to integrate the auto-tagging API separately. We can connect the APIs and you receive the tags in the same webhook response that you process when a track is ready in AIMS API.
\nThis is intentional. The similarities are calculated based on the audio only, and different combinations of artists can change the audio characteristics significantly. For example, the solo tracks of Glen Hansard and Markéta Irglová are very different (most prominently in vocal type, of course), but they also perform together. If the tracks they created together were added to each of their own “artist” collection, they would skew the results. Therefore there are three collections in AIMS in this case: “Glen Hansard (glen-hansard)”, “Markéta Irglová (irglova-marketa)”, and “Glen Hansard, Markéta Irglová (glen-hansard-irglova-marketa)”, each reflecting the specific audio characteristic of them performing separate or together.
\nFor albums, there are simple album codes; for projects, playlists and custom tags, you can select the key ad-hoc, but for artists, we need to do some normalisations to ensure we group the tracks as well as possible (e.g. normalising all of these: “Simon and Garfunkel”, “Simon, Garfunkel, “simon & garfunkel”, “garfunkel, simon”, etc. to “garfunkel-simon”). Therefore, the key is created by AIMS. You can get the key when adding a track to AIMS. If you use the detailed=true parameter (i.e. https://api.aimsapi.com/v1/tracks?detailed=true when sending the add-track request), the response will contain (apart from other extra fields) a field called artist_canonical. This is the corresponding key of the “artist” collection. Depending on your use case, you might want to store this canonical with the artist or track objects/entities on your end.
If you're using Angular or Ember (and possibly other JS FE frameworks) to upload files to AIMS, be aware of a need to set the content-type header to undefined to allow the HTTP client to generate the correct multipart boundary.
When you finish integrating AIMS API, we will do an integration test to compare your site results with results coming directly from AIMS API. You can do the same using tools like Postman or Insomnia - you perform a search request on your site, the same request from the tool, and then compare the results.
\ntime_offset and time_limit parametersIf you provide time_offset and time_limit, which selects a part outside the track (e.g. 0:30-1:30 for a track only 0:20 long), the request will fail since there's no audio in the specified range. In general, you shouldn't provide time_offset and time_limit unless you know the length of the track. AIMS will use 0:30-1:30 by default (or up to the last 60 seconds if the track is shorter) if you don't provide any time_offset and time_limit.