$ man structured-extract
/structured-extract(1)
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
wordmintCATEGORY
uncategorized
STATUS
● live
NAME
structured-extract — structured-data extractor / json-from-text / schema-guided extraction / key-value pull / form-filler
SYNOPSIS
POST https://x402.org/v1/structured-extract
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Structured-data extractor / JSON-from-text / schema-guided extraction / key-value pull / form-filler. Reads free-form text and emits a JSON object conforming to a user-supplied JSON Schema. Powered by Venice zai-org-glm-4.7 (function-calling-default model) with response_format json_object. Returns the extracted object plus a `validates` flag against the user's schema (basic top-level type and required-key check).
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| text | string | Source text. Up to 30,000 chars. | required |
| schema | object | JSON Schema describing the desired output object. The handler relays this to the model and validates the result's top-level shape. | required |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| extracted | string | JSON object pulled from the input text, shaped to match the user-supplied JSON Schema. |
| validates | string | Boolean flag indicating whether the extracted object passes the top-level type and required-key check. |
| schema | string | Echo of the JSON Schema the caller supplied to guide the extraction. |
| model | string | Identifier of the Venice model used for extraction (zai-org-glm-4.7, function-calling-default). |
| source | string | Original free-form text the extractor read to produce the structured object. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/structured-extract \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the structured-extract tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- wordminttext-extractionjson-schemastructured-outputkey-value-extractionform-fillerschema-guided-extraction
- methods
- POST
- cluster
- wordmint
- price
- $0.01 USDC per call
ADJACENT — other endpoints in wordmint
| endpoint | description | price |
|---|---|---|
| ai-to-human-text | AI text humanizer / GPT detector bypass. | $0.01 |
| citation-verify | Citation verifier / fact-check against URL / does-this-source-support-this-claim / hallucination detector. | $0.01 |
| commit-message-from-diff | Git commit message generator / Conventional Commits / AI commit-msg. | $0.01 |
| humanize | AI text humanizer / GPT detector bypass. | $0.01 |
| regex-from-prompt | Regex generator / NL to regex / pattern builder. | $0.01 |
| sentiment | Sentiment + emotion analyzer. | $0.01 |
| sentiment-analysis | Sentiment analyzer / emotion classifier / aspect-based sentiment. | $0.01 |
| summarize | AI summarizer / TLDR generator. | $0.01 |
SEE ALSO