sociallinks.dev

API

APIキーを取得
料金API一括ログインAPIキーを取得

ホーム / API ドキュメント

V1
API キー

API リファレンス

Social links API

クリエイターのプロフィール 1 つから、すべてのアカウントへ。Instagram、TikTok、YouTube、X のプロフィールリンクを送ると、他のプラットフォームにあるクリエイターのアカウントを、それぞれの判定・信頼度スコア・根拠とともに受け取れます。

ベース URLhttps://sociallinks.dev/v1

できること

クリエイターを検索プロフィールリンク 1 つから、クリエイターの他のアカウントへ。POST /resolve複数のクリエイターを検索最大 500 件のプロフィールをキューに入れ、バックグラウンドで処理します。POST /batchesバッチを CSV でダウンロード送ったプロフィールごとに 1 行、プラットフォームごとに 1 列。ステータスと課金クレジットも含みます。GET /batches/{id}/export残高を確認キーに紐づくアカウントの残りクレジット。GET /balance
OpenAPI 仕様コード生成ツールや AI エージェント向けの完全な仕様です。
表示

認証

ダッシュボード → API でキーを作成し、すべてのリクエストに Authorization: Bearer sl_…（または x-api-key: sl_…）として付けて送ってください。キーはアカウントのクレジットを消費します。キーは作成時に一度だけ表示され、無効化すると即座に使えなくなります。

MCP サーバー

Claude Code、Cursor、VS Code、Windsurf、Gemini CLI などの MCP クライアントから検索できます。https://sociallinks.dev/mcp をリモート（Streamable HTTP）サーバーとして追加し、API キーを Authorization ヘッダーで送ってください。ツールの料金は REST エンドポイントとまったく同じです。

claude mcp add --transport http sociallinks https://sociallinks.dev/mcp --header "Authorization: Bearer sl_your_key"

設定ファイルの場所： Cursor ~/.cursor/mcp.json · VS Code .vscode/mcp.json · Windsurf ~/.codeium/windsurf/mcp_config.json · Gemini CLI ~/.gemini/settings.json

ツール

  • lookup_creator

    プロフィールURLからクリエイターを1人検索。アカウントが見つかったときだけ課金されます。

  • check_balance

    キーに紐づくアカウントの残りクレジット。無料。

  • start_batch

    多数のプロフィールURLをキューに入れ、バックグラウンドで検索します。

  • get_batch

    バッチの進捗と結果の行。

料金

送ったアカウント以外に 1 つ以上アカウントが見つかった場合、クリエイター 1 人につき 1 クレジットです。何も見つからなかった検索や失敗した検索は無料です。過去 30 日以内に自分のアカウントで支払ったクリエイターの再検索も無料です。クレジットはウェブサイトと共通です。料金をご覧ください。

クリエイターを検索

POST/resolve

Instagram、TikTok、YouTube、X のプロフィール URL を 1 つ送ってください。他のプラットフォームにあるクリエイターのアカウントを、それぞれの判定・総合信頼度スコア・根拠とともに返します。新規検索は 10〜40 秒、すでに把握しているクリエイターは即時に返ります。アカウントが 1 つ以上見つかった場合は 1 クレジット、何も見つからなければ無料です。X-Credits-Remaining ヘッダーに残高が入ります。

パラメータ

  • urlbody · string必須

    クリエイターのプロフィールページ。投稿、リール、動画、@ハンドルのみは 400 で拒否されます。

リクエスト

curl -X POST "https://sociallinks.dev/v1/resolve" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/mkbhd"}'

レスポンス（200）

{
  "creator": {
    "id": "cr_0k3x9a1",
    "name": "Marques Brownlee",
    "kind": "person",
    "aliases": ["Marques Brownlee", "mkbhd"],
    "total_audience": 38000000
  },
  "profiles": [
    { "platform": "instagram", "handle": "mkbhd", "verdict": "seed", "net_confidence": 1 },
    {
      "platform": "youtube",
      "handle": "mkbhd",
      "url": "https://www.youtube.com/@mkbhd",
      "followers": 20000000,
      "verdict": "confirmed",
      "net_confidence": 0.97,
      "evidence": [
        { "kind": "bio_link", "detail": "Linked from the creator's own Instagram bio", "source": "https://www.instagram.com/mkbhd" }
      ]
    }
  ],
  "websites": [{ "url": "https://mkbhd.com", "kind": "website", "label": "mkbhd.com" }],
  "identity_confidence": 0.96,
  "rejected": 4
}

クリエイターを検索（GET）

GET/resolve

POST /resolve と同じです。GET リクエストしか送れないツール向けです。

パラメータ

  • urlquery · string必須

    URL エンコードしたクリエイターのプロフィールページ。

リクエスト

curl "https://sociallinks.dev/v1/resolve?url=https%3A%2F%2Fwww.instagram.com%2Fmkbhd" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

レスポンス（200）

{
  "creator": {
    "id": "cr_0k3x9a1",
    "name": "Marques Brownlee",
    "kind": "person",
    "aliases": ["Marques Brownlee", "mkbhd"],
    "total_audience": 38000000
  },
  "profiles": [
    { "platform": "instagram", "handle": "mkbhd", "verdict": "seed", "net_confidence": 1 },
    {
      "platform": "youtube",
      "handle": "mkbhd",
      "url": "https://www.youtube.com/@mkbhd",
      "followers": 20000000,
      "verdict": "confirmed",
      "net_confidence": 0.97,
      "evidence": [
        { "kind": "bio_link", "detail": "Linked from the creator's own Instagram bio", "source": "https://www.instagram.com/mkbhd" }
      ]
    }
  ],
  "websites": [{ "url": "https://mkbhd.com", "kind": "website", "label": "mkbhd.com" }],
  "identity_confidence": 0.96,
  "rejected": 4
}

複数のクリエイターを検索

POST/batches

各行はアカウントが見つかった場合のみ課金され、過去 30 日以内に自分のアカウントで支払った行は無料です。プロフィールリンクでない行はスキップされ、課金されません。バッチの状態を確認してから CSV をダウンロードしてください。

パラメータ

  • urlsbody · string[] | string必須

    最大 500 件のプロフィール URL。配列、または 1 行に 1 件。

  • namebody · string

    バッチのラベル。

リクエスト

curl -X POST "https://sociallinks.dev/v1/batches" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Q4 shortlist","urls":["https://www.tiktok.com/@zachking","https://www.youtube.com/@mkbhd"]}'

レスポンス（201）

{
  "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
  "rows": 2,
  "invalid": 0,
  "duplicates": 0
}

バッチを確認

GET/batches/{id}

status が "completed"、"partial"、"failed" のいずれかになるまで数秒おきに確認してください。各項目には個別のステータスと見つかったアカウントが入ります。

パラメータ

  • idpath · uuid必須

    POST /batches が返した id。

リクエスト

curl "https://sociallinks.dev/v1/batches/$BATCH_ID" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

レスポンス（200）

{
  "batch": {
    "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
    "name": "Q4 shortlist",
    "status": "completed",
    "total": 2,
    "succeeded": 2,
    "empty": 0,
    "failed": 0,
    "skipped": 0,
    "charged": 2,
    "created_at": "2026-10-19T09:30:00Z"
  },
  "items": [
    {
      "position": 0,
      "input": { "url": "https://www.tiktok.com/@zachking" },
      "status": "succeeded",
      "charged": 1,
      "result": {
        "name": "Zach King",
        "profiles": [{ "platform": "youtube", "handle": "ZachKing", "url": "https://www.youtube.com/@ZachKing", "verdict": "confirmed" }],
        "notFound": ["linkedin"]
      }
    }
  ]
}

バッチを CSV でダウンロード

GET/batches/{id}/export

スプレッドシートや CRM へのインポートにそのまま使えます。

パラメータ

  • idpath · uuid必須

    バッチの id。

リクエスト

curl "https://sociallinks.dev/v1/batches/$BATCH_ID/export" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY" -o results.csv

レスポンス（200）

row,input,status,credits,creator,verified_creator,instagram,youtube,tiktok,x,twitch,facebook,linkedin,nothing_found_on,error
1,https://www.tiktok.com/@zachking,succeeded,1,Zach King,no,https://www.instagram.com/zachking,https://www.youtube.com/@ZachKing,https://www.tiktok.com/@zachking,https://x.com/zachking,,https://www.facebook.com/zachking,,linkedin,

バッチの一覧

GET/batches

途中から再開するときに便利です。

パラメータ

なし。

リクエスト

curl "https://sociallinks.dev/v1/batches" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

レスポンス（200）

{
  "batches": [
    {
      "id": "6f1c2a4e-1b2c-4d3e-9f00-0a1b2c3d4e5f",
      "name": "Q4 shortlist",
      "status": "completed",
      "total": 2,
      "succeeded": 2,
      "empty": 0,
      "failed": 0,
      "skipped": 0,
      "charged": 2,
      "created_at": "2026-10-19T09:30:00Z"
    }
  ]
}

バッチを停止

POST/batches/{id}/cancel

実行中の行は最後まで処理されます。バッチがすでに完了している場合は 409 を返します。

パラメータ

  • idpath · uuid必須

    バッチの id。

リクエスト

curl -X POST "https://sociallinks.dev/v1/batches/$BATCH_ID/cancel" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

レスポンス（200）

{ "ok": true }

残高を確認

GET/balance

ウェブサイトと同じクレジットです。パックは https://sociallinks.dev/pricing で購入できます。

パラメータ

なし。

リクエスト

curl "https://sociallinks.dev/v1/balance" \
  -H "Authorization: Bearer $SOCIALLINKS_KEY"

レスポンス（200）

{ "credits": 742 }

エラー

すべてのエラーは { "error": { "message", "code" } } の形式です。message は人が読める文、code は処理を分岐したいときに使えます。

ステータスコード意味
400—プロフィール URL ではない（投稿、リール、動画、@ハンドルのみは拒否されます）、またはボディがありません。
401invalid_api_keyキーが不明か、無効化されています。
401login_requiredキーが送信されていません。
402out_of_creditsクレジットが残っていません。課金はされていません。パックを購入して再試行してください。
404—このアカウントにそのバッチはありません。
409—バッチはすでに完了しています。
429—新規検索が多すぎます。Retry-After の秒数だけ待つか、リストを /batches に送ってください。
502—こちら側で検索に失敗しました。課金はされていません。もう一度お試しください。

レート制限

キーあたりの新規検索1 分あたり 5 回
検索済みのクリエイター制限なし。即時に返します
バッチあたりのプロフィール数500
アカウントあたりの有効な API キー10

サポート

ご質問や不具合は support@youtubetranscript.dev までメールでどうぞ。