# MicroScrape Structured Field Extraction

> MicroScrape Structured Field Extraction is a paid API for AI agents from microscrape-production.up.railway.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Extracts specific data fields from any webpage using caller-supplied CSS selectors, returning a structured JSON object with named fields

## Facts

- Endpoint: GET https://microscrape-production.up.railway.app/api/v1/extract
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/microscrape-structured-field-extraction-413576e2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bIUIzVjKx10mRRNjkOG7p

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 microscrape-structured-field-extraction-413576e2
```

Example prompt: Scrape this product page https://example.com/product/123 and pull out the title using 'h1.product-title', the price using '.price-now', and the stock status using '.availability-label'.

## When to prefer this

Choose this endpoint when you need to extract specific, named data fields from a webpage and you know or can determine the CSS selectors for those fields. It is ideal for structured data extraction from product pages, articles, or listings where the page structure is consistent. Prefer it over the Markdown or metadata endpoints when you need precise field-level data rather than full-page content, and over a full crawler when you only need a small number of targeted fields.

## Known failure modes

- CSS selector does not match any element on the page — field returns null or empty string
- Target URL is unreachable or returns a non-200 status — extraction fails with an error
- JavaScript-rendered content may not be available if the page requires JS execution
- Malformed JSON in the fields parameter causes a 400 bad request
- Rate limiting or bot protection on the target site blocks the fetch
- Invalid URL format in the url parameter causes a validation error

## How this service works

MicroScrape: structured field extraction via caller-supplied CSS selectors

## Output

A JSON object containing a request_id, the scraped URL, and a fields object mapping each caller-supplied field name to the text content extracted from the corresponding CSS selector on the page. If a selector matches nothing, the field value will be null or empty.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url",
      "fields"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "URL to extract fields from"
      },
      "fields": {
       "type": "string",
       "description": "JSON object mapping field names to CSS selectors, e.g. {\"title\":\"h1\",\"price\":\".price\"}"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "request_id",
      "url",
      "fields"
     ],
     "properties": {
      "url": {
       "type": "string"
      },
      "fields": {
       "type": "object"
      },
      "request_id": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/microscrape-structured-field-extraction-413576e2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from microscrape-production.up.railway.app](https://www.zero.xyz/host/microscrape-production.up.railway.app/llms.txt)
