Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия SoundCloud: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите треки SoundCloud по keyword: исполнитель, жанр, теги, длительность, прослушивания, лайки, репосты, скачивания и лицензия каждого трека. | $1.39 за 1 000 запросов | Норма |
Поиск пользователейsearch_users | Находите исполнителей и аккаунты SoundCloud по keyword: описание, город, страна, подписчики, число треков и плейлистов и флаги верификации и Pro. | $1.39 за 1 000 запросов | Норма |
Поиск плейлистовsearch_playlists | Находите плейлисты и альбомы SoundCloud по keyword: жанр, число треков, общая длительность, лайки, репосты, имя автора и его верификация. | $1.39 за 1 000 запросов | Норма |
Трекtrack | Получите один трек SoundCloud по ссылке: жанр, теги, длительность в секундах, прослушивания, лайки, репосты, скачивания, лицензию и данные исполнителя. | $1.39 за 1 000 запросов | Норма |
Сведения об исполнителеartist | Получите данные исполнителя или пользователя SoundCloud по ссылке на профиль: описание, город и страну, подписчиков, число треков и плейлистов, статус верификации и Pro и дату создания аккаунта. | $1.39 за 1 000 запросов | Норма |
Плейлистplaylist | Откройте плейлист или альбом SoundCloud по полному url с /sets/: описание, жанр, число треков, общую длительность, лайки и репосты. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API SoundCloud?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите треки SoundCloud по | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · title · text · genre · tags · duration_sec · duration_seconds · artist_name · artist_url · artist_avatar_url · artist_follower_count · artist_verified · play_count · like_count · comment_count · repost_count · download_count · artwork_url · license · posted_at · platform |
search_usersПоиск пользователей Находите исполнителей и аккаунты SoundCloud по | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · username · name · url · bio · avatar_url · city · country · follower_count · following_count · track_count · playlist_count · like_count · is_verified · is_pro · created_at · platform |
search_playlistsПоиск плейлистов Находите плейлисты и альбомы SoundCloud по | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · title · url · text · genre · track_count · duration_sec · duration_seconds · like_count · repost_count · is_album · artwork_url · artist_name · artist_url · artist_verified · posted_at · platform |
trackТрек Получите один трек SoundCloud по ссылке: жанр, теги, длительность в секундах, прослушивания, лайки, репосты, скачивания, лицензию и данные исполнителя. Аудио не скачивается. Права сверх указанных в треке не предоставляются, история прослушиваний не сохраняется. | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · title · text · genre · tags · duration_sec · duration_seconds · artist_name · artist_url · artist_avatar_url · artist_follower_count · artist_verified · play_count · like_count · comment_count · repost_count · download_count · artwork_url · license · posted_at · platform |
artistСведения об исполнителе Получите данные исполнителя или пользователя SoundCloud по ссылке на профиль: описание, город и страну, подписчиков, число треков и плейлистов, статус верификации и Pro и дату создания аккаунта. Личность не проверяется. Слушатели, доходы и закрытая аналитика недоступны. | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · username · name · url · bio · avatar_url · city · country · follower_count · following_count · track_count · playlist_count · like_count · is_verified · is_pro · created_at · platform |
playlistПлейлист Откройте плейлист или альбом SoundCloud по полному | url | keyword, query | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · title · url · text · genre · track_count · duration_sec · duration_seconds · like_count · repost_count · is_album · artwork_url · artist_name · artist_url · artist_verified · posted_at · platform |
Что означают параметры действия search в API SoundCloud?
Ищите треки SoundCloud по keyword: исполнитель, жанр, теги, длительность, прослушивания, лайки, репосты, скачивания и лицензия каждого трека. Длительность указана в секундах; перед повторным использованием или ремиксом стоит проверить поле лицензии.
keywordОбязательный- Поисковый запрос для поиска треков в search, исполнителей в search_users или сетов в search_playlists. Параметр общий для эндпоинтов, но каждое действие возвращает свой тип сущностей. В действии playlist он используется как запасной поисковый запрос, только если нет полного URL /sets/, и точное совпадение плейлиста не гарантируется.SoundCloud: треки, пользователи и плейлисты являются разными целями поиска — Официальная документация SoundCloud по поиску разделяет отдельные аудиотреки, аккаунты пользователей и плейлисты, причём аккаунты могут представлять группы или слушателей. Для запросов к этим типам ресурсов используются разные действия. Наличие в веб-интерфейсе SoundCloud фильтров по дате, длительности или персональных фильтров не означает, что этот эндпоинт их поддерживает. · Проверено
Что означают параметры действия search_users в API SoundCloud?
Находите исполнителей и аккаунты SoundCloud по keyword: описание, город, страна, подписчики, число треков и плейлистов и флаги верификации и Pro. Совпадение имени не подтверждает личность или готовность к сотрудничеству.
keywordОбязательный- Поисковый запрос для поиска треков в search, исполнителей в search_users или сетов в search_playlists. Параметр общий для эндпоинтов, но каждое действие возвращает свой тип сущностей. В действии playlist он используется как запасной поисковый запрос, только если нет полного URL /sets/, и точное совпадение плейлиста не гарантируется.SoundCloud: треки, пользователи и плейлисты являются разными целями поиска — Официальная документация SoundCloud по поиску разделяет отдельные аудиотреки, аккаунты пользователей и плейлисты, причём аккаунты могут представлять группы или слушателей. Для запросов к этим типам ресурсов используются разные действия. Наличие в веб-интерфейсе SoundCloud фильтров по дате, длительности или персональных фильтров не означает, что этот эндпоинт их поддерживает. · Проверено
Что означают параметры действия search_playlists в API SoundCloud?
Находите плейлисты и альбомы SoundCloud по keyword: жанр, число треков, общая длительность, лайки, репосты, имя автора и его верификация. is_album отражает то, как подана подборка, и не доказывает официальный релиз.
keywordОбязательный- Поисковый запрос для поиска треков в search, исполнителей в search_users или сетов в search_playlists. Параметр общий для эндпоинтов, но каждое действие возвращает свой тип сущностей. В действии playlist он используется как запасной поисковый запрос, только если нет полного URL /sets/, и точное совпадение плейлиста не гарантируется.SoundCloud: границы владения плейлистами, альбомами и треками — Официальная документация SoundCloud указывает, что плейлисты являются подборками собственных треков пользователя или треков других авторов и могут оформляться как альбомы или сеты. Поэтому создатель подборки не обязательно является автором каждого трека в ней. Этот эндпоинт возвращает сводку по подборке и не повторяет официальные функции редактирования плейлистов. · Проверено
Что означают параметры действия track в API SoundCloud?
Получите один трек SoundCloud по ссылке: жанр, теги, длительность в секундах, прослушивания, лайки, репосты, скачивания, лицензию и данные исполнителя. Аудио не скачивается. Права сверх указанных в треке не предоставляются, история прослушиваний не сохраняется.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Ссылка на ресурс SoundCloud. Для track используйте прямые URL треков, для artist ссылки на профили исполнителей (из них извлекается путь автора), для playlist полные URL /sets/. Если передать в playlist ссылку не на плейлист, выполняется общий поиск, и нужная сущность может не вернуться.SoundCloud: чем All Rights Reserved отличается от лицензий Creative Commons — Официальная документация SoundCloud о лицензиях отличает All Rights Reserved от различных условий Creative Commons. Поле `license` помогает проверить права, но не является универсальным разрешением на коммерческое или повторное использование. Конкретные права на дальнейшее использование нужно оценивать по условиям соответствующей лицензии. · Проверено
Что означают параметры действия artist в API SoundCloud?
Получите данные исполнителя или пользователя SoundCloud по ссылке на профиль: описание, город и страну, подписчиков, число треков и плейлистов, статус верификации и Pro и дату создания аккаунта. Личность не проверяется. Слушатели, доходы и закрытая аналитика недоступны.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Ссылка на ресурс SoundCloud. Для track используйте прямые URL треков, для artist ссылки на профили исполнителей (из них извлекается путь автора), для playlist полные URL /sets/. Если передать в playlist ссылку не на плейлист, выполняется общий поиск, и нужная сущность может не вернуться.SoundCloud: профили артистов, групп и обычных слушателей — Категория Profiles/People в SoundCloud включает музыкантов, группы, авторов и обычных слушателей. Название действия `artist` — это идентификатор действия в шлюзе, а не подтверждение того, что любой профиль принадлежит профессиональному артисту. · Проверено
Что означают параметры действия playlist в API SoundCloud?
Откройте плейлист или альбом SoundCloud по полному url с /sets/: описание, жанр, число треков, общую длительность, лайки и репосты. Для других ссылок выполняется поиск по keyword или query. Такой поиск может не найти нужную подборку.
urlОбязательный- Ссылка на ресурс SoundCloud. Для track используйте прямые URL треков, для artist ссылки на профили исполнителей (из них извлекается путь автора), для playlist полные URL /sets/. Если передать в playlist ссылку не на плейлист, выполняется общий поиск, и нужная сущность может не вернуться.SoundCloud: сводка по подборке отличается от подробного списка треков — Официальная документация SoundCloud описывает плейлисты как подборки треков и объясняет, как настроить формат альбома или сета. Этот источник описывает только связи между объектами: эндпоинт не возвращает массивы `tracks` с подробными данными, а официальные лимиты SoundCloud на размер плейлистов не гарантируют количество результатов этого эндпоинта. · Проверено
keywordНеобязательный- Поисковый запрос для поиска треков в search, исполнителей в search_users или сетов в search_playlists. Параметр общий для эндпоинтов, но каждое действие возвращает свой тип сущностей. В действии playlist он используется как запасной поисковый запрос, только если нет полного URL /sets/, и точное совпадение плейлиста не гарантируется.
queryНеобязательный- Дополнительный запасной поисковый запрос для действия playlist с более низким приоритетом, чем у keyword. Передача этого параметра не отменяет обязательность url.
Как использовать API SoundCloud
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"soundcloud","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API SoundCloud
Какие данные можно получить через API SoundCloud?
Укажите в platform значение soundcloud. В текущем каталоге: поиск, поиск пользователей, поиск плейлистов, трек, сведения об исполнителе и more. Эти названия действий соответствуют разным объектам или представлениям SoundCloud; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе SoundCloud?
Поисковый запрос для поиска треков в search, исполнителей в search_users или сетов в search_playlists. Параметр общий для эндпоинтов, но каждое действие возвращает свой тип сущностей. В действии playlist он используется как запасной поисковый запрос, только если нет полного URL /sets/, и точное совпадение плейлиста не гарантируется. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе SoundCloud?
Объявленная схема включает title, text, genre и tags. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия SoundCloud возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.