API documentation
All APIs are plain HTTPS GET endpoints returning JSON (or PNG for OG images). Try them directly in the browser — the public endpoints below have a small anonymous quota. For production use, subscribe on RapidAPI and send your key in the X-RapidAPI-Key header.
- Base URLs
https://meta.xyzforge.workers.devhttps://email.xyzforge.workers.devhttps://og.xyzforge.workers.dev- Auth
- None for the anonymous tier;
X-RapidAPI-Keyvia RapidAPI for paid plans - Errors
- JSON
{"error":"message"}with 4xx/5xx status - Health
GET /healthon every API
URL Metadata API
GET /v1/meta?url=<url>
Fetches the page, follows redirects, and returns normalised metadata. Results are cached for 10 minutes.
curl "https://meta.xyzforge.workers.dev/v1/meta?url=https://github.com"
{
"url": "https://github.com/",
"final_url": "https://github.com/",
"status": 200,
"title": "GitHub · Build and ship software on a single, collaborative platform",
"description": "Join the world's most widely adopted...",
"lang": "en",
"canonical": "https://github.com/",
"favicon": "https://github.githubassets.com/favicons/favicon.svg",
"og": { "title": "...", "description": "...", "image": "...", "type": "object", "site_name": "GitHub" },
"twitter": { "card": "summary_large_image", "site": "@github", "image": "..." },
"images": ["..."],
"jsonld_types": ["WebSite", "Organization"],
"fetched_at": "2026-11-08T00:00:00Z",
"cached": false
}
Query options: timeout (ms, max 8000), ua = bot|browser (default bot).
Email Validation API
GET /v1/validate?email=<address>
curl "https://email.xyzforge.workers.dev/v1/validate?email=someone@gmial.com"
{
"email": "someone@gmial.com",
"normalized": "someone@gmial.com",
"valid_syntax": true,
"domain": "gmial.com",
"has_mx": true,
"mx": ["..."],
"disposable": false,
"role_account": false,
"free_provider": false,
"did_you_mean": "someone@gmail.com",
"score": 42,
"verdict": "risky"
}
verdict is one of deliverable, risky, undeliverable. Score is 0–100. No mailbox‑level SMTP probing is performed (it is unreliable and often blocked), so deliverable means the address is well‑formed, on a domain that accepts mail, and not disposable.
OG Image API
GET /v1/og?title=<text>&subtitle=<text>&theme=<dark|light|sunset|ocean>&site=<text>
Returns a 1200×630 PNG, cached at the edge for 24 hours. Use it directly in a meta tag:
<meta property="og:image"
content="https://og.xyzforge.workers.dev/v1/og?title=Hello%20World&subtitle=From%20the%20edge&theme=sunset">
Options: title (required, ≤120 chars), subtitle (≤200), site footer text, theme, emoji (single emoji shown as a badge), format=svg for the vector source.
Rate limits
Anonymous: 20 requests/min per IP, daily cap shown on each product card. RapidAPI plans: per the plan. Limits return 429 with a Retry-After header.
Changelog
- 2026‑11‑08 — Initial public release of Metadata, Email Validation and OG Image APIs.