# BRAINIAC URL to Markdown

> BRAINIAC URL to Markdown is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-12).

Fetches a public URL via HTTP GET and returns its content converted to Markdown format, with metadata such as content hash, HTTP status, and retrieval timestamp.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/web-intelligence/url-to-markdown?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-url-to-markdown-256f1d60
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NrrW5RoXitYKYmgmPZslY

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-url-to-markdown-256f1d60 -d '<json body>'
```

Example prompt: Can you fetch the content of https://docs.example.com/getting-started and give it to me as markdown so I can read it without all the HTML noise?

## When to prefer this

Choose this endpoint when you need a quick, no-auth, pay-per-call fetch-and-convert of a single public URL to Markdown, without needing JavaScript rendering. It is ideal for agents that need to read documentation, articles, or web pages without spinning up a full browser. Prefer alternatives with JavaScript rendering if the target page relies heavily on client-side rendering.

## Known failure modes

- URL is unreachable or returns a non-200 HTTP status — the httpStatus field will reflect the error code
- URL points to a JavaScript-rendered SPA — content will be incomplete because JS is not executed
- URL contains embedded iframes — those will not be fetched, surfaced as a warning
- URL is malformed or does not match the required pattern — validation error returned
- URL times out or is rate-limited by the target server — request failure

## 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 content rendered as a Markdown string, the final resolved URL (after any redirects), the originally requested URL, the HTTP status code, content type, a SHA-256 content hash, retrieval timestamp, source metadata, and any warnings (e.g. embedded frames not fetched) and limitations (e.g. JavaScript not executed).

## 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": {
  "sources": [
   {
    "url": "https://example.com/",
    "source": "Public HTTP response",
    "retrievedAt": "2026-11-02T18:00:00.000Z"
   }
  ],
  "finalUrl": "https://example.com/",
  "markdown": "# Example Domain\n\nThis domain is for use in documentation examples.",
  "warnings": [
   "Embedded frames were not fetched."
  ],
  "httpStatus": 200,
  "contentHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "contentType": "text/html",
  "limitations": [
   "Only the bytes from one public HTTP GET are read. JavaScript is not executed."
  ],
  "retrievedAt": "2026-11-02T18:00:00.000Z",
  "requestedUrl": "https://example.com/"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-url-to-markdown-256f1d60/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)
