POST AI agent ready /v1/url-metadata

URL メタデータ API - 開いたグラフ、タイトル、ファビコンを抽出

URL を取得し、タイトル、説明、Open Graph タグ、Twitter Card タグ、ファビコン、正規 URL、言語、作成者、キーワード、テーマカラーを抽出します。リンクのプレビューやソーシャル共有に役立ちます。

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/url-metadata \
  -H "Content-Type: application/json" \
  -d '{"url":"https://github.com"}'

When to use this API

チャットアプリでリッチリンクプレビューを生成する

ユーザーがチャットメッセージに URL を貼り付けると、このエンドポイントを呼び出してタイトル、説明、OG イメージを取得します。 Slack や Discord の表示リンクが展開されるのと同様に、メッセージの下にプレビューカードをレンダリングします。

コンテンツを公開する前に OG タグを検証する

ブログ投稿をソーシャルメディアで共有する前に、OG タグを抽出してタイトル、説明、画像が正しいことを確認してください。 Twitter、LinkedIn、または Facebook で公開される前に、欠落または切り詰められたメタデータを検出します。

自動メタデータを備えたブックマークマネージャーを構築する

ユーザーが URL をブックマークコレクションに保存すると、抽出されたメタデータからタイトル、説明、サムネイルが自動入力されます。ユーザーが各ブックマークの詳細を手動で入力する手間を省きます。

Frequently asked questions

このエンドポイントはリダイレクトに従いますか?

はい。エンドポイントは HTTP リダイレクトに従い、最終的な宛先 URL からメタデータを抽出します。ステータスフィールドには、最終応答の HTTP ステータスが反映されます。

og フィールドと twitter フィールドの違いは何ですか?

og には、Open Graph メタタグ (Facebook、LinkedIn などで使用される) が含まれています。 twitter には Twitter Card タグが含まれています。多くのサイトでは両方を設定していますが、両方が存在する場合、Twitter Card タグは Twitter/X で優先されます。

シングルページアプリからメタデータを抽出できますか?

エンドポイントは、JavaScript を実行せずに、最初の HTML 応答を取得します。 SPA がそのメタタグをクライアント側でレンダリングする場合、それらのタグは応答に表示されません。

遅い URL に対するタイムアウトはありますか?

はい。ターゲット URL が応答しない場合、エンドポイントは 10 秒後にタイムアウトします。タイムアウトになると、説明メッセージ付きの 400 エラーが返されます。

標準フィールドには何が含まれますか?

canonical フィールドには、ページの優先 URL を示す <link rel="canonical"> タグの値が含まれます。これは、同じコンテンツを提供する URL の重複を排除するのに役立ちます。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.