# Landfall: website intelligence for AI agents

> Website intelligence for AI agents, paid per call with x402. Three paid tools: a landing page audit for paid ads (readiness score, verdict, tags with IDs, conversion paths, top 5 fixes), business contact details from a website (phones, emails, address, hours, socials, company and VAT numbers), and a tracking check (ad pixels, analytics, tag managers, consent, site platform). Deterministic, evidence-based, typical response 1-3 seconds, never charged if a call fails.

Paid per call with x402 v2 (exact scheme) in USDC on Base mainnet (eip155:8453). No account or API key. Never charged if a call fails.

## When to use it
- Before launching or scaling Meta, Google or TikTok ads to a URL: confirm the page can convert and be measured (audit).
- To find how to contact a business from its website: phones, emails, address, hours, socials (business).
- To check which ad pixels, analytics and tag managers a site runs, with IDs (tracking).

## Endpoints
- [Landing page audit, 0.05 USDC](https://landfall-production-74ad.up.railway.app/v1/audit?url=https://example.com): GET, query `url` (required), `keyword` (optional ad keyword to check message match).
- [Business details, 0.02 USDC](https://landfall-production-74ad.up.railway.app/v1/business?url=https://example.com): GET, query `url`. Name, phones (E.164), emails, WhatsApp, address, opening hours, social profiles, review platforms, booking/chat tools, UK company and VAT numbers. Reads the contact page too when needed.
- [Tracking check, 0.01 USDC](https://landfall-production-74ad.up.railway.app/v1/tracking?url=https://example.com): GET, query `url`. Meta/Google Ads/TikTok tags with IDs, GA4, tag managers, conversion events, consent, site platform.
- [Developer guide with code examples](https://landfall-production-74ad.up.railway.app/docs)
- [Preview (free)](https://landfall-production-74ad.up.railway.app/v1/preview?url=https://example.com): verdict, overall score and issue counts only. 10 per hour.
- [Sample (free)](https://landfall-production-74ad.up.railway.app/v1/sample): a complete example response.
- [OpenAPI](https://landfall-production-74ad.up.railway.app/openapi.json)
- [Study: 2 in 3 UK local business websites aren't ready for paid ads](https://landfall-production-74ad.up.railway.app/study)
- MCP server: `https://landfall-production-74ad.up.railway.app/mcp` (streamable HTTP). Tools: audit_landing_page, get_business_details, check_tracking (paid via x402 MCP transport), preview_landing_page and sample_audit (free).

## Audit response fields
- `verdict`: "ready", "fix_first" or "not_ready". `score.overall`: 0-100. `score.by_category`: conversion, tracking, trust, mobile, speed.
- `blockers`: ids of critical failures. `top_fixes`: up to 5, in priority order, each with the fix and the evidence.
- `ad_platform_readiness`: meta, google_ads, tiktok, google_analytics_4, tag_manager. Each status is "detected", "not_detected" or "possibly_via_tag_manager".
- `conversion_paths`: forms, click_to_call, whatsapp_link, booking_tools, chat_tools, cta_texts.
- `checks`: every check with status "pass", "warn", "fail" or "unknown", plus evidence.
- `limitations`: what could not be verified for this page.

## Errors
Errors are JSON: `{"error": {"code", "message", "charged"}}`. A failed audit (unreachable page, not HTML, timeout) is never charged.
Codes: missing_url, invalid_url, blocked_target, blocked_by_site, page_error, dns_failed, fetch_failed, tls_error, timeout, not_html, too_many_redirects, rate_limited.

## Limits
Static HTML only (JavaScript is not run), first 1.5 MB of the page, 12 second fetch timeout, public websites only.