Page metadata
GET /api/metaFetch page metadata for a URL: title, description, OpenGraph, Twitter cards, canonical URL, favicon.
Input
| Field | Type | Description |
|---|---|---|
url * | string | Public http(s) URL |
Example output
{
"url": "https://example.com",
"title": "Example",
"description": "Example site",
"og": {
"title": "Example"
},
"twitter": {}
}
Try it - see the 402 challenge (free)
curl -i "https://agent402.tools/api/meta?url=https%3A%2F%2Fexample.com"
The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:
Paid call (JavaScript agent)
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/meta?url=https%3A%2F%2Fexample.com");
Part of these workflows
This tool is one step in 6 curated multi-tool workflows - agents can fetch the whole sequence as an MCP prompt or call https://agent402.tools/api/skill-packs/{slug}/prompt.
- Content extraction - Turn arbitrary URLs and PDFs into clean structured text - articles, page metadata, PDF pages, OCR'd images, browser-rendered SPAs.
- Link preview card - The 'turn a URL into a card-shaped preview' workflow. Pull OpenGraph/Twitter card metadata, fetch the article body as a description fallback, normalize the og:image into a standard 1200×630 social card variant and a 400×400 square thumbnail, and extract URL/mention entities from the body for related-link surfacing. Five tools, one structured card payload ready for chat embeds, social shares, or RSS-to-card pipelines.
- Technical SEO audit - Can search engines and AI crawlers actually index this page? One pass over reachability, TLS, robots policy, sitemap health, meta/OpenGraph tags, and the on-page link graph.
- Competitor scan - What's a competitor using? Tech stack, HTTP headers, WHOIS, and page metadata in one call.
- Page audit - Full page SEO + security audit: content extraction, metadata, HTTP headers, robots policy, and sitemap health in one call.
- URL inspector - Quick URL health and metadata check - parse the URL structure, verify reachability, and pull page metadata in one pass.
Related tools
Extract article
POST /api/extractExtract the main article content from any public URL as clean markdown. Returns title, byline, excerpt, word count, and …
Browser render
POST /api/renderRender a page in a real headless Chromium browser (JavaScript executed), then extract the main content as clean markdown…
Screenshot
GET /api/screenshotScreenshot any public URL in headless Chromium. Returns a PNG image. Query params: ?url=https://…&fullPage=true (optiona…