Link in Bio
リンクインバイオのページは、クリエイターがInstagram、TikTok、YouTubeのプロフィール欄に置く唯一のランディングページで、表示名、短い紹介文、プロフィール写真、ほかのSNSへのアイコン、場合によっては連絡先メール、そしてショップや音楽、スポンサー、ニュースレターへのボタンが並んでいます。このページを読み取れば、プロフィール欄の1本のリンクが、整理された連絡先、ほかのチャンネルの一覧、いま宣伝しているものの一覧に変わります。
Link in Bio API の主な機能
- 4つのサービスを1回でLinktree、Komi、lnk.bio、Link.meのURLを最大50件の urls に混ぜて送れ、各行がどのサービスのものかは service でわかります。
- クリエイターの基本情報username、name、text、avatar_url でページ名、表示名、紹介文、プロフィール写真がわかり、is_verified でそのサービスの認証バッジの有無を確認できます。
- 連絡先メールemail にはクリエイターがページに載せている連絡先アドレスが入り、そのままアウトリーチ用のリストに追加できます。
- 連携しているSNSsocial_urls には、ページのアイコンからリンクされているSNSプロフィールやWebサイトがまとまり、ほかのネットワークのアカウントにたどれます。
- すべてのリンクを表示順でlinks は各ボタンを表示順に返し、タイトル、リンク先の url、link や spotify_album などの type、thumbnail_url が付きます。合計数は links_count でわかります。
Link in Bio API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | リンクインバイオのページURLを最大50件。linktr.ee/<name>、<name>.komi.io、lnk.bio/<name>、link.me/<name> の形式で、サービスを混在させても構いません。 |
Link in Bio API の使い方
リンクインバイオのURLをまとめて送り、ページごとに1行ずつ読み取ります。
- /v1/link-in-bio/profile に {"urls": ["https://linktr.ee/miguelangeles", "https://kimkardashian.komi.io", "https://lnk.bio/msjennafischer", "https://link.me/danucd"]} をPOSTします。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items からページごとに1行ずつ読み取り、has_more が true の間は results.next_cursor を渡して続きを取得します。
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"]}'Link in Bio API の主なユースケース
- クリエイターの連絡先を補完: InstagramやTikTokのプロフィールから集めたリンクをまとめて送り、各クリエイターのメール、表示名、アイコンをアウトリーチリストに加えます。
- ほかのチャンネルを洗い出す: social_urls と links を使い、1人のクリエイターのYouTube、Spotify、ショップ、ニュースレターへの導線を1つのレコードにまとめます。
- 宣伝内容の変化を追う: 同じページを定期的に読み直してリンクのタイトルとリンク先を比べ、新しいスポンサー、アフィリエイトショップ、新商品の告知をいち早く見つけます。
Link in Bio API 活用のヒント
- id はサービス名とページ名を組み合わせた値(例:linktree:miguelangeles)なので、これをキーにすると何度取得しても同じページがそろいます。
- 1回のリクエストに最大50件まで入れられ、サービスは自由に混在できます。料金は見つかったページごとにかかります。
- links を collected_at と一緒に保存しておくと、次に取得したときにどのボタンが増えたか、なくなったかを正確に把握できます。