POST AI agent ready /v1/url-metadata

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

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

Endpoint

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 标签以确认标题、描述和图像正确。在 Twitter、LinkedIn 或 Facebook 上发布之前捕获丢失或截断的元数据。

当用户将 URL 保存到其书签集合时，会从提取的元数据中自动填充标题、描述和缩略图。使用户无需手动输入每个书签的详细信息。

该端点是否遵循重定向？

是的。端点遵循 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。

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