プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
SoundCloudの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | keywordでSoundCloudのトラックを検索し、アーティスト、ジャンル、タグ、再生時間、再生数、いいね数、リポスト数、ダウンロード数、各トラックに付与されたライセンスを取得します。再生時間の単位は秒です。再利用やリミックスの前には、ライセンスフィールドを確認することをおすすめします。 | 1,000リクエストあたり$1.39 | 正常 |
ユーザー検索search_users | keywordでSoundCloudのアーティストやアカウントを検索します。自己紹介、都市、国、フォロワー数、トラック数とプレイリスト数、認証済み・Proのフラグを取得できます。名前が一致しても、本人であることや仕事の依頼が可能であることを確認するものではありません。 | 1,000リクエストあたり$1.39 | 正常 |
プレイリスト検索search_playlists | keywordに一致するSoundCloudのプレイリストやアルバムを、ジャンル、トラック数、合計再生時間、いいね数、リポスト数、作成者の名前と認証状況とともに見つけます。is_albumはセットの表示形式を反映したもので、公式リリースであることを証明するものではありません。 | 1,000リクエストあたり$1.39 | 正常 |
トラックtrack | リンクからSoundCloudのトラックを1件読み取ります。ジャンル、タグ、再生時間（秒）、再生数、いいね数、リポスト数、ダウンロード数、ライセンス、アーティスト情報を取得できます。音声はダウンロードされません。トラックに明記された範囲を超えるライセンスは付与されず、再生履歴も保存されません。 | 1,000リクエストあたり$1.39 | 正常 |
アーティスト詳細artist | プロフィールリンクからSoundCloudのアーティストやユーザーを確認します。自己紹介、都市と国、フォロワー数、トラック数とプレイリスト数、認証済み・Proのステータス、アカウント作成日を取得できます。アカウント所有者の身元は確認されません。リスナー情報、収益、非公開のアナリティクスにはアクセスできません。 | 1,000リクエストあたり$1.39 | 正常 |
プレイリストplaylist | /sets/を含む完全なurlから、SoundCloudのプレイリストやアルバムを開きます。説明、ジャンル、トラック数、合計再生時間、いいね数、リポスト数を取得できます。それ以外のリンクは、keywordまたはqueryによる検索にフォールバックします。その検索で目的のセットにたどり着くとは限りません。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
SoundCloudの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索
| keyword | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | 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ユーザー検索
| keyword | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | 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プレイリスト検索
| keyword | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | 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のトラックを1件読み取ります。ジャンル、タグ、再生時間（秒）、再生数、いいね数、リポスト数、ダウンロード数、ライセンス、アーティスト情報を取得できます。音声はダウンロードされません。トラックに明記された範囲を超えるライセンスは付与されず、再生履歴も保存されません。 | url | — | Sync配信 | — | 1,000リクエストあたり$1.39 | 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,000リクエストあたり$1.39 | 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プレイリスト /sets/を含む完全な | url | keyword, query | Sync配信 | — | 1,000リクエストあたり$1.39 | 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 |
SoundCloudのsearchのパラメータはそれぞれどういう意味ですか？
keywordでSoundCloudのトラックを検索し、アーティスト、ジャンル、タグ、再生時間、再生数、いいね数、リポスト数、ダウンロード数、各トラックに付与されたライセンスを取得します。再生時間の単位は秒です。再利用やリミックスの前には、ライセンスフィールドを確認することをおすすめします。
keyword必須- 検索クエリ文字列を指定します。searchではトラック、search_usersではアーティスト、search_playlistsではセットを検索します。複数のエンドポイントで共通のパラメータですが、アクションごとに返されるエンティティの種類が異なります。playlistアクションでは、完全な/sets/ URLがない場合にのみ代替の検索語として使われ、目的のプレイリストと完全に一致するとは限りません。SoundCloud：トラック、ユーザー、プレイリストは別々の検索対象 — SoundCloud公式の検索ドキュメントでは、個別の音声トラック、ユーザーアカウント、プレイリストを区別しており、ユーザーアカウントはバンドやリスナーを表す場合もあります。これらのリソースタイプの照会には、それぞれ別のアクションを使用します。SoundCloudのWebインターフェースに日付、再生時間、パーソナライズされたフィルタがあっても、このエンドポイントでそれらのオプションがサポートされるわけではありません。 · 確認日
SoundCloudのsearch_usersのパラメータはそれぞれどういう意味ですか？
keywordでSoundCloudのアーティストやアカウントを検索します。自己紹介、都市、国、フォロワー数、トラック数とプレイリスト数、認証済み・Proのフラグを取得できます。名前が一致しても、本人であることや仕事の依頼が可能であることを確認するものではありません。
keyword必須- 検索クエリ文字列を指定します。searchではトラック、search_usersではアーティスト、search_playlistsではセットを検索します。複数のエンドポイントで共通のパラメータですが、アクションごとに返されるエンティティの種類が異なります。playlistアクションでは、完全な/sets/ URLがない場合にのみ代替の検索語として使われ、目的のプレイリストと完全に一致するとは限りません。SoundCloud：トラック、ユーザー、プレイリストは別々の検索対象 — SoundCloud公式の検索ドキュメントでは、個別の音声トラック、ユーザーアカウント、プレイリストを区別しており、ユーザーアカウントはバンドやリスナーを表す場合もあります。これらのリソースタイプの照会には、それぞれ別のアクションを使用します。SoundCloudのWebインターフェースに日付、再生時間、パーソナライズされたフィルタがあっても、このエンドポイントでそれらのオプションがサポートされるわけではありません。 · 確認日
SoundCloudのsearch_playlistsのパラメータはそれぞれどういう意味ですか？
keywordに一致するSoundCloudのプレイリストやアルバムを、ジャンル、トラック数、合計再生時間、いいね数、リポスト数、作成者の名前と認証状況とともに見つけます。is_albumはセットの表示形式を反映したもので、公式リリースであることを証明するものではありません。
keyword必須- 検索クエリ文字列を指定します。searchではトラック、search_usersではアーティスト、search_playlistsではセットを検索します。複数のエンドポイントで共通のパラメータですが、アクションごとに返されるエンティティの種類が異なります。playlistアクションでは、完全な/sets/ URLがない場合にのみ代替の検索語として使われ、目的のプレイリストと完全に一致するとは限りません。SoundCloud：プレイリスト、アルバム、トラックの所有関係 — SoundCloud公式ドキュメントでは、プレイリストはユーザー自身または他のユーザーのトラックをまとめたもので、アルバムやセットとして設定できると説明しています。そのため、コレクションの作成者が収録されたすべてのトラックの作者とは限りません。このエンドポイントはコレクションの概要を返すものであり、公式のプレイリスト編集機能を再現するものではありません。 · 確認日
SoundCloudのtrackのパラメータはそれぞれどういう意味ですか？
リンクからSoundCloudのトラックを1件読み取ります。ジャンル、タグ、再生時間（秒）、再生数、いいね数、リポスト数、ダウンロード数、ライセンス、アーティスト情報を取得できます。音声はダウンロードされません。トラックに明記された範囲を超えるライセンスは付与されず、再生履歴も保存されません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- 対象となるSoundCloudリソースのリンクを指定します。trackではトラックの直接URL、artistではアーティストのプロフィールリンク（リンクからクリエイターのパスが抽出されます）、playlistでは完全な/sets/ URLを使用してください。playlistアクションにプレイリスト以外のリンクを指定すると一般検索にフォールバックし、目的のエンティティが返されない場合があります。SoundCloud：All Rights ReservedとCreative Commonsライセンスの違い — SoundCloud公式のライセンスドキュメントでは、All Rights Reservedと各種Creative Commonsの条件を区別しています。`license`フィールドは権利を確認するための指標であり、商用利用や再利用を一律に許可するものではありません。具体的な利用の可否は、該当するライセンスの条件に照らして判断する必要があります。 · 確認日
SoundCloudのartistのパラメータはそれぞれどういう意味ですか？
プロフィールリンクからSoundCloudのアーティストやユーザーを確認します。自己紹介、都市と国、フォロワー数、トラック数とプレイリスト数、認証済み・Proのステータス、アカウント作成日を取得できます。アカウント所有者の身元は確認されません。リスナー情報、収益、非公開のアナリティクスにはアクセスできません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- 対象となるSoundCloudリソースのリンクを指定します。trackではトラックの直接URL、artistではアーティストのプロフィールリンク（リンクからクリエイターのパスが抽出されます）、playlistでは完全な/sets/ URLを使用してください。playlistアクションにプレイリスト以外のリンクを指定すると一般検索にフォールバックし、目的のエンティティが返されない場合があります。SoundCloud：アーティスト、バンド、リスナーを含むプロフィール — SoundCloudのProfiles/Peopleカテゴリには、ミュージシャン、バンド、クリエイター、一般のリスナーが含まれます。`artist`というアクション名はゲートウェイのアクション識別子であり、任意のプロフィールがプロのアーティストであることを証明するものではありません。 · 確認日
SoundCloudのplaylistのパラメータはそれぞれどういう意味ですか？
/sets/を含む完全なurlから、SoundCloudのプレイリストやアルバムを開きます。説明、ジャンル、トラック数、合計再生時間、いいね数、リポスト数を取得できます。それ以外のリンクは、keywordまたはqueryによる検索にフォールバックします。その検索で目的のセットにたどり着くとは限りません。
url必須- 対象となるSoundCloudリソースのリンクを指定します。trackではトラックの直接URL、artistではアーティストのプロフィールリンク（リンクからクリエイターのパスが抽出されます）、playlistでは完全な/sets/ URLを使用してください。playlistアクションにプレイリスト以外のリンクを指定すると一般検索にフォールバックし、目的のエンティティが返されない場合があります。SoundCloud：コレクションの概要と詳細なトラック一覧の違い — SoundCloud公式ドキュメントでは、プレイリストをトラックのコレクションとして説明し、アルバムやセットの形式を変更する方法を解説しています。このリファレンスはオブジェクト間の関係のみを定義するものです。このエンドポイントは`tracks`の詳細配列を返しません。また、SoundCloud公式のプレイリスト保存上限は、このエンドポイントの出力件数を保証するものではありません。 · 確認日
keyword任意- 検索クエリ文字列を指定します。searchではトラック、search_usersではアーティスト、search_playlistsではセットを検索します。複数のエンドポイントで共通のパラメータですが、アクションごとに返されるエンティティの種類が異なります。playlistアクションでは、完全な/sets/ URLがない場合にのみ代替の検索語として使われ、目的のプレイリストと完全に一致するとは限りません。
query任意- playlistアクションで使用する補助的な代替検索語で、keywordより優先度が低くなります。このパラメータを指定しても、urlは引き続き必須です。
SoundCloud APIの使い方
- 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>"}}'
SoundCloud APIに関する質問
SoundCloud APIでは何を取得できますか？
platformをsoundcloudに設定します。現在のカタログには検索、ユーザー検索、プレイリスト検索、トラック、アーティスト詳細、moreが掲載されています。これらのアクション名はそれぞれ異なるSoundCloudのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
SoundCloudのsearchリクエストを開始するには、どの入力を使用しますか？
検索クエリ文字列を指定します。searchではトラック、search_usersではアーティスト、search_playlistsではセットを検索します。複数のエンドポイントで共通のパラメータですが、アクションごとに返されるエンティティの種類が異なります。playlistアクションでは、完全な/sets/ URLがない場合にのみ代替の検索語として使われ、目的のプレイリストと完全に一致するとは限りません。params内のkeywordとして送信してください。
SoundCloudのsearchはどのフィールドを返しますか？
宣言されたスキーマにはtitle、text、genre、tagsが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
SoundCloudのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。