1人のXクリエイターを指定すると、オーディエンス・規模・コンテンツスタイルが近いアカウントを類似度スコアと概要指標付きでランキング形式で返します。通常のプロフィール取得よりクォータ消費が大きくなります。
GET
/api/v1/x/user/similarクォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 1 単位消費されます。
プラットフォーム共通パス
/api/v1/{platform}/user/similar利用可能なプラットフォーム
リクエストパラメータ
必須パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
username | query | string | X handle example: elonmusk |
レスポンスフィールド
| 名前 | 型 | 説明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | array<object> | Data |
data[].username | string | Account name |
data[].nickname | string | Account nickname |
data[].avatar | string | Account avatar URL |
data[].description | string | Account bio |
data[].follower_count | integer | Follower count |
お試し実行
https://openapi.scdata.cc/api/v1/x/user/similar
ダッシュボードのAPIキーを選択
リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く
クエリパラメータ
username*cURL の例
bash
curl -X GET "https://openapi.scdata.cc/api/v1/x/user/similar?username=elonmusk" \-H "Authorization: YOUR_API_KEY"
レスポンス例 (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": [{"username": "SpaceX","nickname": "SpaceX","avatar": "https://img-us.scrumball.ai/twitter/34743251/avatar/xxx.jpg","description": "SpaceX designs, manufactures and launches the world’s most advanced rockets and spacecraft","follower_count": 41900588},{"username": "NASA","nickname": "NASA","avatar": "https://img-us.scrumball.ai/twitter/11348282/avatar/xxx.jpg","description": "Explore the universe and discover our home planet.","follower_count": 92384026}]}
ユースケース
- 類似クリエイターの発掘 — 成果の良かったクリエイターを起点に、同じ種類のオーディエンスに届く他のアカウントを見つけます。
- 予算帯に合う代替案 — 予算超過の場合に、同じニッチでより小規模なクリエイターを探します。