Link in Bio データAPI
クリエイターがInstagram、TikTok、YouTubeのプロフィール欄に置く1本のリンクを、表示名、紹介文、アイコン、掲載されている連絡先メール、連携SNS、各ボタンのタイトルとリンク先という構造化データに変えます。
利用できるLink in Bio API
Link in Bio APIを使えば、Linktree、Komi、lnk.bio、Link.meのページを1回のリクエストで最大50件、サービスを混在させて読み取れます。
取得できるリンクインバイオのデータ
見つかったページごとに正規化された1行が返り、ページに表示されていない値は null になります。
ページの識別情報
読み取ったページごとに、サービス名、ページ名、ページURL、linktree:miguelangeles のような id を保持します。
クリエイターのプロフィール
表示名、紹介文、プロフィール写真、そのサービスの認証バッジを読み取ります。
連絡先メール
クリエイターがページに載せている連絡先アドレスを取得し、そのままアウトリーチ用のレコードに使えます。
連携しているSNS
ページのアイコンからリンクされているSNSプロフィールやWebサイトをまとめます。
ページ上のすべてのリンク
各ボタンを表示順に、タイトル、リンク先、リンクの種類、サムネイルとともに受け取り、リンクの総数も取得できます。
SocQとページを直接処理する方法の比較
SocQは、4つのリンクインバイオサービスを1つのリクエスト形式と1つの正規化された行で読み取ります。ページを直接処理する場合、取得、サービスごとの解析、保存、スキーマの保守はアプリケーション側で行う必要があります。
| 機能 | SocQ | ページの直接処理 |
|---|---|---|
| 入力の起点 | Linktree、Komi、lnk.bio、Link.meのページURLを1つのリストで最大50件 | ページURLとサービスごとに書いた取得ロジック |
| 結果の形式 | ページごとに1行、どのサービスでも同じフィールド | サービス固有のマークアップと独自の解析 |
| 実行モデル | ステータスをポーリングする非同期タスク | アプリケーション側で定義・運用 |
| 料金 | 見つかったページ1件につき0.5クレジット | 自前のインフラと保守 |
Link in Bio APIの仕組み
このエンドポイントは、SocQ共通の非同期タスクと保存済み結果の取得ワークフローを使用します。
1. ページURLを送信
最大50件のリンクインバイオURLを urls に入れて /v1/link-in-bio/profile にPOSTし、task_id を保存します。
2. タスクを追跡
タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
3. ページごとに1行を読み取る
data.results.items を読み取り、has_more が true の間は next_cursor をたどります。
SocQのAPIキーで認証し、クリエイターのプロフィール欄から集めたページを送信します。見つかったページ1件につき0.5クレジットです。
curl -X POST "https://api.socq.ai/v1/link-in-bio/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://linktr.ee/miguelangeles","https://kimkardashian.komi.io","https://lnk.bio/msjennafischer","https://link.me/danucd"]}'
# Poll GET /v1/tasks/{task_id}
# Read one row per page in data.results.itemsLink in Bio APIの主なユースケース
クリエイターの連絡先補完
各クリエイターのプロフィールリンクから、メール、表示名、アイコンをアウトリーチリストに追加します。
チャンネル横断の把握
social_urls と links を使い、クリエイターのYouTube、Spotify、ショップ、ニュースレターへの導線をひも付けます。
宣伝内容の追跡
同じページを定期的に読み直してリンクを比べ、新しいスポンサー、アフィリエイトショップ、新商品の告知を見つけます。
制限事項と公開データポリシー
Link in Bioの結果は、クリエイター自身が公開しているページを特定時点で読み取ったものです。
- 1回のリクエストで受け付けるURLは最大50件で、linktr.ee/<name>、<name>.komi.io、lnk.bio/<name>、link.me/<name> の形式です。
- 公開が終わったページは料金なしでスキップされ、送ったページがすべて読み取れなかった場合に限りタスクが失敗し、全額返金されます。
- email にはクリエイターがページに載せている連絡先アドレスが入り、ほかのプロフィール項目もページの表示内容に沿います。
Link in Bio APIに関するよくある質問
Link in Bio APIとは何ですか?
クリエイターのリンクインバイオページをまとめて読み取り、各ページの紹介文、アイコン、連絡先メール、連携SNS、すべてのリンクを正規化された1行として返すAPIです。
どのリンクインバイオサービスに対応していますか?
Linktree、Komi、lnk.bio、Link.meに対応しており、4つを同じリクエストに混在させられます。
クリエイターのメールアドレスは取得できますか?
できます。クリエイターがページに連絡先を載せていれば email に入ります。
Link in Bio APIの料金はどのように計算されますか?
見つかったページ1件につき1行が返り、0.5クレジットかかります。50件すべてが見つかった場合は合計25クレジットです。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
Creator API
Instagram、TikTok、YouTube、X、Facebook、Threadsのプロフィール1件を起点に、クリエイターの公開ビジネスメール、ほかのSNSのアカウント、プロフィール写真からの年齢・性別の推定を取得します。
Google Hotels API
目的地でホテルを検索し、任意のホテルのGoogleホテル上のプロフィールと1泊料金カレンダーを取得します。3つはすべて同じホテルIDでつながります。
Brand Monitoring API
ブランド、製品、トピックに言及したWebページを探し、ページごとに感情をスコア化し、Web全体での語られ方を要約します。
AI Search API
AI概要、ChatGPT、GoogleのAIモードが市場の質問にどう答えているかを追跡します。ブランドに触れた回答、可視性の高さ、引用されているドメインとページがわかります。
Instagram API
公開プロフィールを検索・照会し、フォロワーリストのレコード、フォロー関係、投稿、プロフィールがタグ付けされた投稿、ハッシュタグの検索結果、リール、文字起こし、コメント、アカウント数値、エンゲージメント指標、メディアのメタデータを、1つの非同期ワークフローで取得できます。
TikTok API
対応する公開TikTokプロフィール、個別動画のメタデータ、トップレベルコメント、動画の検索結果、指定したハッシュタグの動画を、正規化された1つの非同期ワークフローで取得できます。
