Link preview metadata for a page
Fetch a public web page's head and return link-preview metadata: title, description, site name, type, preview image, canonical URL, language, author, published time, favicon, theme colour, and every OpenGraph and Twitter-card field. Reads at most 512 KB and never runs JavaScript. Use to build link previews, label citations or check how a URL will unfurl before sharing it.
Inputs
| Name | Type | Description |
|---|---|---|
url (required) | string | Absolute public http(s) URL of the page |
Request
Over HTTP, with a card key from /credits:
curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/url/meta?url=https%3A%2F%2Fgithub.com%2F"
Or one of your 25 free calls, no key:
curl "https://agent-data-tools.revmesh2074.workers.dev/url/meta?url=https%3A%2F%2Fgithub.com%2F&trial=1"
Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum, Monad, World Chain or Tempo) and retries.
Example result
{
"url": "https://github.com/",
"finalUrl": "https://github.com/",
"title": "GitHub",
"description": "…",
"siteName": "GitHub",
"type": "object",
"image": "https://github.githubassets.com/…",
"canonical": "https://github.com/",
"lang": "en",
"author": null,
"publishedTime": null,
"favicon": "https://github.githubassets.com/…",
"themeColor": null,
"openGraph": {
"og:site_name": "GitHub"
},
"twitter": {
"twitter:card": "summary_large_image"
}
}
From an AI agent (MCP)
Add the MCP server to Claude, Cursor or any MCP client. This tool is url_meta, and the first 25 successful calls are free:
https://agent-data-tools.revmesh2074.workers.dev/mcp