# BRAINIAC Website Metadata Extractor

> BRAINIAC Website Metadata Extractor is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-17).

Fetches and returns structured metadata from any public webpage, including title, description, OpenGraph tags, robots directives, canonical URL, and HTTP status.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/web-intelligence/website-metadata-extract?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-website-metadata-extractor-da676259
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n6krLbzkNuRA1CHT9cHU8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-website-metadata-extractor-da676259 -d '<json body>'
```

Example prompt: Can you fetch the metadata for https://www.openai.com/ — I need the page title, description, OpenGraph info, canonical URL, and what robots directives it has?

## When to prefer this

Use this endpoint when you need structured metadata from a single webpage without maintaining a scraping infrastructure. It is ideal for SEO audits, link preview generation, content enrichment pipelines, and verifying page-level signals like canonical URLs, language, and robots directives. Prefer this over full-page scrapers when you only need head-level metadata rather than body content. It requires no account setup and charges only $0.02 USDC per call via x402 on Base.

## Known failure modes

- Invalid or malformed URL returns a validation error
- URL is unreachable or times out — HTTP error or timeout response
- Page returns non-HTML content type — metadata fields may be absent
- Redirect loops or too many redirects — may return error or partial data
- Robots.txt not fetched — robots values only reflect meta tags and HTTP headers
- Canonical URL is non-HTTP/HTTPS — reported as a warning, canonical field may be null

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

A JSON object containing the page title, meta description, OpenGraph properties (title, description, image, type, URL, locale, site name), robots directives from both meta tags and HTTP headers, canonical URL, final resolved URL, language, HTTP status code, content type, retrieval timestamp, any warnings about missing or non-standard tags, and limitations such as whether robots.txt was fetched.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "pattern": "^https?:\\/\\/\\S+$",
   "maxLength": 2000,
   "minLength": 8
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "title": "Example Domain",
  "robots": {
   "meta": "index,follow",
   "header": "noarchive"
  },
  "sources": [
   {
    "url": "https://example.com/",
    "source": "Public HTTP response",
    "retrievedAt": "2026-11-02T18:00:00.000Z"
   }
  ],
  "finalUrl": "https://example.com/",
  "language": "en",
  "warnings": [
   "A canonical link was present but was not an http or https URL."
  ],
  "openGraph": {
   "url": "https://example.com/",
   "type": "website",
   "image": "https://example.com/image.png",
   "title": "Example Domain",
   "locale": "en",
   "siteName": "Example",
   "description": "Illustrative description"
  },
  "httpStatus": 200,
  "contentType": "text/html",
  "description": "Illustrative description from the description meta tag.",
  "limitations": [
   "robots.txt was not fetched. Robots values come from the page meta tag and the X-Robots-Tag header."
  ],
  "retrievedAt": "2026-11-02T18:00:00.000Z",
  "canonicalUrl": "https://example.com/",
  "requestedUrl": "https://example.com/"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-website-metadata-extractor-da676259/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
