agentutility(7)$ man structured-extract
/structured-extract
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
wordmintCATEGORY
uncategorized
STATUS
● live
NAME
structured-extract — extracts structured json from free-form text, conforming to a user-supplied json schema
SYNOPSIS
POST https://x402.agentutility.ai/structured-extract
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Extracts structured JSON from free-form text, 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). Use it as a JSON-from-text extractor, schema-guided extraction, key-value pull, or form-filler.
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.agentutility.ai/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 the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the structured-extract tool from your MCP-aware agent.
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 |
| app-review-sentiment | Scores app-store reviews by onboarding, stability, pricing, performance, and feature requests. | $0.01 |
| brand-bootstrap | Bootstraps a brand kit for a new business or product in one call. | $0.01 |
| brand-launch-brief | Generates a structured brand launch brief for a new company or product from name, concept, audience, and tone. | $0.01 |
| brand-positioning-brief | Generates a brand positioning brief covering messaging pillars, taglines, launch channels, and a logo prompt. | $0.01 |
| brand-sentiment-analysis | Scores comments, mentions, survey verbatims, and campaign feedback for sentiment. | $0.01 |
| candidate-feedback-sentiment | Summarizes candidate experience, recruiter feedback, and hiring-process comments by sentiment. | $0.01 |
| churn-risk-sentiment | Analyzes support tickets, chats, and emails for negative sentiment, urgency, and at-risk churn themes. | $0.01 |
SEE ALSO