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.dev
https://email.xyzforge.workers.dev
https://og.xyzforge.workers.dev
Auth
None for the anonymous tier; X-RapidAPI-Key via RapidAPI for paid plans
Errors
JSON {"error":"message"} with 4xx/5xx status
Health
GET /health on 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