クリエイターのプロフィール欄にあるリンクは、たいていLinktree、Komi、lnk.bio、Link.meのページにつながっています。このページには、連絡先のメールアドレス、ほかのSNSアカウント、ショップ、最新の動画、スポンサーなどが掲載されています。大規模にクリエイターをリサーチするなら、これらのページは有用なデータですが、手作業で読むのは手間がかかります。
2026-11-17、SocQはLink in Bio APIを、新しいLink in Bioプラットフォームで公開しました。4つのサービスすべてにまたがって1リクエストで最大50ページを読み取り、それぞれを構造化されたレコードとして返します。このガイドでは、リクエスト、フィールド、料金、そしてアウトリーチのパイプラインでの使い方を説明します。
結論: 最大50件のページURLを
urlsに指定して、POST /v1/link-in-bio/profileに送信します。Linktree、Komi、lnk.bio、Link.meのURLは同じリクエストに混在させられます。GET /v1/tasks/{task_id}をポーリングし、data.results.itemsからページごとに1行を読み取ります。見つかったページ1件につき0.5クレジット($0.0025)です。
エンドポイントが返す内容
1 SocQクレジット = $0.005です。
| エンドポイント | 返される内容 | 料金 |
|---|---|---|
| Link in Bio API | ページごとに1行:サービス、ページ名、表示名、プロフィール文、アバター、認証バッジ、連絡先メール、リンクされたSNSプロフィール、そしてページ上のすべてのリンクとそのタイトル、リンク先、種類、サムネイル | 見つかったページ1件あたり0.5クレジット($0.0025) |
すでに存在しないページはスキップされます。タスクが返金付きで失敗するのは、どのページも読み取れなかった場合だけです。
認証と非同期タスクの流れ
SocQのリクエストはすべてAPIキーで認証します。送信、タスクのステータス確認、結果の取得のいずれにも同じヘッダーを使います。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
収集はすべてバックグラウンドのタスクとして実行されます。
submit -> task_id -> queued -> running -> succeeded
\-> failed
送信のレスポンスにはdata.task_idとdata.statusが含まれます。そのIDでタスクをポーリングします。
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
statusがsucceededになると、レスポンスのdata.results.itemsに正規化されたレコードの最初のページが含まれます。limitのデフォルトは50で、最大500まで指定できます。has_moreがtrueなら、results.next_cursorをcursorとして渡して次のページを読み取ります。タスクがqueued、running、failedの間は、エンドポイントはresultsなしでタスクのメタデータを返します。
送信ボディに任意のcallback_urlを指定すると、タスクの完了時にSocQがタスクの概要を1回POSTします。レコードはGET /v1/tasks/{task_id}で読み取ってください。クライアント側でタイムアウトしてもタスクはキャンセルされないため、重複して支払わないよう、同じタスクIDで再開してください。402はクレジット不足、429はキーがレート制限またはクレジットの上限に達したことを意味します。
リンクインバイオのページをリクエストする
urlsに最大50件のページURLを、linktr.ee/name、name.komi.io、lnk.bio/name、link.me/nameの形式で指定します。InstagramやTikTokのプロフィール欄から集めたURLが混在したリストでも、事前に仕分ける必要はありません。
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"
]
}'
課金は返されたページの数に基づきます。SocQは送信されたURLの数に応じてクレジットを仮押さえすることがあり、タスクの完了後に実際のresult_countから最終的な請求額を確定し、使われなかったクレジットを返却します。
ページのレコードを理解する
ドキュメントの例から一部を抜粋した行は、次のとおりです。
{
"id": "komi:kimkardashian",
"platform": "link-in-bio",
"resource": "profile",
"type": "page",
"url": "https://kimkardashian.komi.io",
"service": "komi",
"username": "kimkardashian",
"name": "Kim Kardashian",
"email": null,
"social_urls": [
"https://www.instagram.com/kimkardashian/",
"https://www.tiktok.com/@kimkardashian",
"https://www.youtube.com/@KUWTK"
],
"links": [
{
"title": "Visit SKIMS",
"url": "https://skims.social/shop-skims",
"type": "link",
"thumbnail_url": "https://komi-production-assets.s3-accelerate.amazonaws.com/photos/x_LQCBYzoWiel0-yrAnrF.jpg"
}
],
"links_count": 21
}
よく使うフィールドは次のとおりです。
id:linktree:miguelangelesのような、サービスとページ名の組み合わせ。安定したキーとして使えます。serviceとusername:ページをホストしているサービスと、そのサービス上のページ名。name、text、avatar_url、is_verified:表示名、プロフィール文、プロフィール写真、そしてページにサービスの認証バッジが付いているかどうか。email:ページに掲載されている連絡先メールアドレス(ある場合)。social_urls:ページのアイコンからリンクされているSNSプロフィールとウェブサイト。links:表示順に並んだすべてのリンクと、そのtitle、url、type(linkやspotify_albumなど、サービスが報告する値)、thumbnail_url。links_count:ページ上のリンクの数。
スキーマの全体はLink in Bioのドキュメントに掲載しています。
大きなリストをバッチ処理する
長いリストは50件ずつのグループに分け、グループごとに1つのタスクを送信します。最小限のPythonのパターンは次のとおりです。
import os, time, requests
API = "https://api.socq.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SOCQ_API_KEY']}"}
def read_pages(urls):
task = requests.post(f"{API}/link-in-bio/profile",
json={"urls": urls}, headers=HEADERS).json()
task_id = task["data"]["task_id"]
while True:
time.sleep(3)
data = requests.get(f"{API}/tasks/{task_id}",
params={"limit": 50}, headers=HEADERS).json()["data"]
if data["status"] in ("succeeded", "failed"):
return data
for i in range(0, len(all_urls), 50):
result = read_pages(all_urls[i:i + 50])
本番で使う前に、HTTPステータスのチェック、回数を制限したリトライ、カーソルによるページネーションを追加し、各task_idを入力したバッチとともに保存してください。
使いどころ
アウトリーチ用の連絡先データ。 クリエイターがページに連絡先メールアドレスを掲載していれば、emailに入ります。空の場合は、クリエイターのメインのプロフィールに対してInfluencer Email Finder APIを実行してください。このAPIは、リンクインバイオのページ、リンクされたウェブサイト、ほかのアカウントも確認します。
クリエイターのアカウントを洗い出す。 social_urlsからは、クリエイター自身が掲載しているプロフィールのリストが得られます。信頼度スコアが必要な場合は、Social Media Profile Finderと組み合わせてください。どちらもCreator APIガイドで解説しています。
スポンサーとアフィリエイトのリサーチ。 linksからは、クリエイターがいま宣伝しているショップ、割引コード、ブランドパートナー、コンテンツが分かります。継続的に追跡し、collected_atでスナップショットを比較してください。
カタログのデータ拡充。 links_count、is_verified、リンクのtypeの値を使えば、各ページを開かなくてもクリエイターのデータベースにタグを付けたり絞り込んだりできます。
よくある質問(FAQ)
リンクインバイオAPIとは何ですか?
クリエイターがSNSのプロフィール欄に載せるランディングページ、つまりリンクインバイオのページを読み取り、構造化されたデータとして返すAPIです。SocQのLink in Bio APIは、Linktree、Komi、lnk.bio、Link.meに対応しています。
1回のリクエストで複数のサービスを混在させられますか?
はい。Linktree、Komi、lnk.bio、Link.meのURLは、1リクエストあたり最大50件まで、同じurls配列に入れられます。
ページが削除されていた場合はどうなりますか?
すでに存在しないページはスキップされ、課金されません。タスクが返金付きで失敗するのは、送信したどのページも読み取れなかった場合だけです。
すべてのページにメールアドレスが含まれますか?
いいえ。emailは、クリエイターがページにメールアドレスを掲載している場合にのみ入り、それ以外はnullになります。
1,000ページを読み取るにはいくらかかりますか?
見つかったページ1件あたり0.5クレジットなので、1,000ページで500クレジット、つまり$2.50です。50件のURLを含むリクエスト20回に分けて送信します。
LINK IN BIO API
公開Link in BioのURLでワークフローを試す
公開データの入力を送信すると、取得元をたどれるコンテキスト付きの正規化レコードを受け取れます。
Link in BioのAPIを見る