POST/tools/enrich-website
Fetch a public website’s homepage (and a few recommended pages) for personalization context: title, description, headings, and a text snippet.
0 credits. Rate class: enrich_website (default 20/min). No Idempotency-Key.
Private, loopback, link-local, and similar hosts are rejected. The response status is unreachable (not a separate error code). Redirects use the same host policy.
Request
POST /tools/enrich-website
X-API-Key: sk_live_...
Content-Type: application/json
{ "website": "https://acme.com" }
| Field | Required | Notes |
|---|---|---|
website | Yes | Max 500. Protocol optional (acme.com → https://acme.com) |
Response
{
"website": "https://acme.com",
"status": "ok",
"title": "Acme",
"description": "…",
"headings": ["…"],
"textSnippet": "…",
"hasLlmsTxt": false,
"llmsTxt": "",
"sitemapFound": true,
"recommendedPages": [{ "url": "https://acme.com/about", "path": "/about" }],
"pages": [{ "url": "https://acme.com/about", "title": "About", "snippet": "…" }],
"creditsCharged": 0
}
status: ok | unreachable | no-website.
Errors
| Error code | When |
|---|---|
validation_error | Missing website, unknown keys, or over max length |
rate_limited | enrich_website RPM exceeded |
MCP
Tool: enrich_website (readOnlyHint: true).
Related
- Email check: POST /tools/validate-email
- Limits: Credits & rate limits