Docs
ダッシュボード

Xクリエイターのプロフィールを取得

5 件のエンドポイント • ベース: https://openapi.scdata.cc

エンドポイント
GETプロフィール

/api/v1/x/user/info

GET最近のポスト

/api/v1/x/user/posts

GETブランド提携

/api/v1/x/user/brands

GET類似クリエイター

/api/v1/x/user/similar

GETハッシュタグ反応

/api/v1/x/user/hashtag/engagement

Xクリエイターの保存済み公開プロフィールを返します。プロフィール情報、フォロワー数とフォロー数、認証状態、他プラットフォームの連携アカウント、直近のポストの平均エンゲージメント指標を含みます。バッチ選定に適したデータベース値で、最新値が必要な場合はリアルタイム版をご利用ください。

GET/api/v1/x/user/info

クォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 1 単位消費されます。

プラットフォーム共通パス

/api/v1/{platform}/user/info

利用可能なプラットフォーム

リクエストパラメータ

必須パラメータ

名前位置型説明
usernamequerystringX handle
example: elonmusk

レスポンスフィールド

名前型説明
successbooleanSuccess
codeintegerCode
messagestringMessage
dataobject-
data.user_idstringAccount ID
data.related_platformsarray<object>Related platforms
data.usernamestringAccount name
data.nicknamestringAccount nickname
data.avatarstringAccount avatar URL
data.bannerstringProfile banner URL
data.descriptionstringAccount bio
data.bio_urlstringExternal link in bio
data.channel_urlstringAccount URL
data.follower_countintegerFollower count
data.following_countintegerFollowing count
data.favourites_countintegerNumber of posts the account has liked; an activity signal
data.countrystringCountry
data.locationstringSelf-reported location text
data.languagestringLanguage
data.genderstringGender
data.is_business_accountbooleanBusiness account
data.is_verifiedbooleanVerified
data.verified_typestringVerification type (Government / Business / Blue, etc.)
data.is_privatebooleanPrivate account; posts of private accounts cannot be fetched
data.register_atstringAccount creation time
data.tagsarray<string>Top 10 hashtags in recent posts
data.categoriesarray<object>Category
data.publish_count_monthintegerPosts per month
data.publish_count_weekintegerPosts per week
data.last_publish_atstringLast publish time
data.total_post_countintegerTotal posts ever (including reposts)
data.total_media_countintegerPosts with images or video
data.total_video_countintegerVideo posts in the sample window
data.original_post_countintegerOriginal posts in the sample window (excluding reposts and replies)
data.retweet_ratiostringRepost share in the window
data.reply_ratiostringReply share in the window
data.top_sourcestringMost used posting client
data.avg_engagement_rate_5stringLast 5 posts: average engagement rate = average engagements (likes + replies + reposts + quotes) / followers × 100
data.avg_view_rate_5stringLast 5 posts: average reach rate = average impressions / followers × 100
data.avg_view_count_5stringLast 5 posts: average impressions
data.avg_like_count_5stringLast 5 posts: average likes
data.avg_comment_count_5stringLast 5 posts: average replies
data.avg_retweet_count_5stringLast 5 posts: average reposts
data.avg_quote_count_5stringLast 5 posts: average quotes
data.avg_engagement_rate_10stringLast 10 posts: average engagement rate = average engagements (likes + replies + reposts + quotes) / followers × 100
data.avg_view_rate_10stringLast 10 posts: average reach rate = average impressions / followers × 100
data.avg_view_count_10stringLast 10 posts: average impressions
data.avg_like_count_10stringLast 10 posts: average likes
data.avg_comment_count_10stringLast 10 posts: average replies
data.avg_retweet_count_10stringLast 10 posts: average reposts
data.avg_quote_count_10stringLast 10 posts: average quotes
data.avg_engagement_rate_30stringLast 30 posts: average engagement rate = average engagements (likes + replies + reposts + quotes) / followers × 100
data.avg_view_rate_30stringLast 30 posts: average reach rate = average impressions / followers × 100
data.avg_view_count_30stringLast 30 posts: average impressions
data.avg_like_count_30stringLast 30 posts: average likes
data.avg_comment_count_30stringLast 30 posts: average replies
data.avg_retweet_count_30stringLast 30 posts: average reposts
data.avg_quote_count_30stringLast 30 posts: average quotes
data.med_engagement_rate_30stringLast 30 posts: median engagement rate = median engagements (likes + replies + reposts + quotes) / followers × 100
data.med_view_rate_30stringLast 30 posts: median reach rate = median impressions / followers × 100
data.med_view_count_30stringLast 30 posts: median impressions
data.med_like_count_30stringLast 30 posts: median likes
data.med_comment_count_30stringLast 30 posts: median replies
data.med_retweet_count_30stringLast 30 posts: median reposts
data.med_quote_count_30stringLast 30 posts: median quotes
data.avg_engagement_rate_5_videostringLast 5 video posts: average engagement rate = average engagements (likes + replies + reposts + quotes) / average impressions × 100
data.avg_engagement_rate_10_videostringLast 10 video posts: average engagement rate = average engagements (likes + replies + reposts + quotes) / average impressions × 100
data.avg_engagement_rate_30_videostringLast 30 video posts: average engagement rate = average engagements (likes + replies + reposts + quotes) / average impressions × 100
data.med_engagement_rate_30_videostringLast 30 video posts: median engagement rate = median engagements (likes + replies + reposts + quotes) / median impressions × 100
data.cooperation_scoreobjectCollaboration propensity score
data.evaluation_minstringEstimated minimum collaboration rate (USD)
data.evaluation_maxstringEstimated maximum collaboration rate (USD)
data.last_update_atstringData updated at

お試し実行

https://openapi.scdata.cc/api/v1/x/user/info
ダッシュボードのAPIキーを選択
リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く

クエリパラメータ

username*

cURL の例

bash
curl -X GET "https://openapi.scdata.cc/api/v1/x/user/info?username=elonmusk" \
  -H "Authorization: YOUR_API_KEY"

レスポンス例 (200 application/json)

json
{
  "success": true,
  "code": 200,
  "message": "Request successful",
  "data": {
    "user_id": "string",
    "related_platforms": [
      {
        "platform": "string",
        "platform_url": "string"
      }
    ],
    "username": "string",
    "nickname": "string",
    "avatar": "string",
    "banner": "string",
    "description": "string",
    "bio_url": "string",
    "channel_url": "string",
    "follower_count": 0,
    "following_count": 0,
    "favourites_count": 0,
    "country": "string",
    "location": "string",
    "language": "string",
    "gender": "string",
    "is_business_account": true,
    "is_verified": true,
    "verified_type": "string",
    "is_private": true,
    "register_at": "string",
    "tags": [
      "string"
    ],
    "categories": [
      {
        "level1": {
          "id": 9044,
          "zh_name": "Sports",
          "en_name": "Sports"
        },
        "level2": {
          "id": 9044,
          "zh_name": "Sports",
          "en_name": "Sports"
        },
        "level3": {
          "id": 9044,
          "zh_name": "Sports",
          "en_name": "Sports"
        }
      }
    ],
    "publish_count_month": 0,
    "publish_count_week": 0,
    "last_publish_at": "string",
    "total_post_count": 0,
    "total_media_count": 0,
    "total_video_count": 0,
    "original_post_count": 0,
    "retweet_ratio": "string",
    "reply_ratio": "string",
    "top_source": "string",
    "avg_engagement_rate_5": "string",
    "avg_view_rate_5": "string",
    "avg_view_count_5": "string",
    "avg_like_count_5": "string",
    "avg_comment_count_5": "string",
    "avg_retweet_count_5": "string",
    "avg_quote_count_5": "string",
    "avg_engagement_rate_10": "string",
    "avg_view_rate_10": "string",
    "avg_view_count_10": "string",
    "avg_like_count_10": "string",
    "avg_comment_count_10": "string",
    "avg_retweet_count_10": "string",
    "avg_quote_count_10": "string",
    "avg_engagement_rate_30": "string",
    "avg_view_rate_30": "string",
    "avg_view_count_30": "string",
    "avg_like_count_30": "string",
    "avg_comment_count_30": "string",
    "avg_retweet_count_30": "string",
    "avg_quote_count_30": "string",
    "med_engagement_rate_30": "string",
    "med_view_rate_30": "string",
    "med_view_count_30": "string",
    "med_like_count_30": "string",
    "med_comment_count_30": "string",
    "med_retweet_count_30": "string",
    "med_quote_count_30": "string",
    "avg_engagement_rate_5_video": "0%",
    "avg_engagement_rate_10_video": "0%",
    "avg_engagement_rate_30_video": "0%",
    "med_engagement_rate_30_video": "0%",
    "cooperation_score": {
      "score": 0,
      "score_level": "string",
      "tags": [
        {
          "label": "string",
          "polarity": "positive"
        }
      ]
    },
    "evaluation_min": "string",
    "evaluation_max": "string",
    "last_update_at": "string"
  }
}

ユースケース

  • クリエイターの事前審査 — 詳しく評価する前に、フォロワー数、認証状態、平均エンゲージメントを確認して候補を絞り込みます。
  • クロスプラットフォーム照合 — 連携アカウント情報を使ってXアカウントを同一クリエイターの他チャンネルと結び付け、統合プロファイルを作成します。

関連エンドポイント