# MiniFrame Tools – Structured Web Data Extraction

> MiniFrame Tools – Structured Web Data Extraction is a paid API for AI agents from tools.miniframe.com.br, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Renders a JavaScript-enabled webpage and extracts structured metadata (JSON-LD, Open Graph, meta tags, headings, tables, links) plus custom CSS selector fields, returning everything as JSON.

## Facts

- Endpoint: POST https://tools.miniframe.com.br/extract
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/miniframe-tools-structured-web-data-extraction-669225f3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g2-sokG1bk5dQcZTe4_Mc

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 miniframe-tools-structured-web-data-extraction-669225f3 -d '<json body>'
```

Example prompt: Pull the structured data from https://example.com/product/123 — I want the JSON-LD, Open Graph tags, all headings, and also grab the price and availability using the CSS selectors '.price' and '.stock-status'.

## When to prefer this

Choose this endpoint when you need the semantic and structured data a page already encodes (JSON-LD, Open Graph, meta) rather than raw HTML, and especially when the page is a JavaScript single-page app that won't yield useful content from a plain HTTP fetch. Prefer it over raw-HTML scrapers when you want clean, parsed JSON output without writing your own extraction logic. Also prefer it when you need to extract specific elements via CSS selectors in the same call.

## Known failure modes

- URL points to a private/internal network address — blocked with an error
- URL is unreachable or returns a non-200 status
- JavaScript rendering times out on a very slow or complex page
- CSS selector returns no matching elements — field will be null or empty
- Malformed URL in request body
- Page has bot-detection that prevents rendering

## How this service works

Use when you need the structured data a page already carries, not raw HTML. Renders JavaScript and returns JSON-LD, Open Graph, meta tags, headings, tables and links, plus any fields you pass as CSS selectors. JSON body { url }, optional selectors ({ name: cssSelector }). Private/internal targets are blocked.

## Output

A JSON object containing: JSON-LD structured data found on the page, Open Graph properties, HTML meta tags, all headings (h1–h6), tables as arrays, all links with their href and text, and any values matched by the custom CSS selectors provided in the request.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "Public http/https URL to read."
  },
  "selectors": {
   "type": "object",
   "description": "Optional map of name -> CSS selector."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {},
  "links": [
   {
    "href": "https://www.iana.org/domains/example",
    "text": "More information..."
   }
  ],
  "title": "Example Domain",
  "jsonld": [],
  "tables": [],
  "headings": [
   {
    "tag": "h1",
    "text": "Example Domain"
   }
  ],
  "selected": {
   "heading": "Example Domain"
  },
  "final_url": "https://example.com/",
  "opengraph": {},
  "description": ""
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/miniframe-tools-structured-web-data-extraction-669225f3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.miniframe.com.br](https://www.zero.xyz/host/tools.miniframe.com.br/llms.txt)