跳转到内容
POST AI agent ready /v1/url-metadata

URL 元数据 API - 提取开放图、标题和网站图标

获取 URL 并提取标题、描述、开放图谱标签、Twitter 卡标签、网站图标、规范 URL、语言、作者、关键字和主题颜色。 Useful for link previews and social sharing.

Parameters

stringrequired

Full URL to fetch and extract metadata from.

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 包含开放图谱元标记（由 Facebook、LinkedIn 等使用）。 twitter 包含 Twitter 卡标签。 许多网站都设置了两者，但当两者都存在时，Twitter Card 标签在 Twitter/X 上优先。
我可以从单页应用程序中提取元数据吗？
端点获取初始 HTML 响应而不执行 JavaScript。 如果 SPA 在客户端呈现其元标记，这些标记将不会出现在响应中。
慢速 URL 是否有超时？
是的。 如果目标 URL 没有响应，端点将在 10 秒后超时。 超时会返回 400 错误以及描述性消息。
规范字段包含什么？
canonical 字段包含 <link rel="canonical"> 标记的值，该标记指示页面的首选 URL。 这可以帮助您消除提供相同内容的重复 URL。

Get your API key

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

Sign up free View full docs