Structured Web Extraction

web

Serving

Fetch a web page and return structured data: standard fields (title, description, language, h1, OpenGraph, author, published), headings, JSON-LD and a text excerpt. Optional schema picks named fields or applies regexes to the HTML. POST /v1/url with {url}. JavaScript is not executed; pages are cached for 10 minutes. Pay per request in USDC; no account, no API key.

Endpoint: POST https://test.agent.pocket.network/v1/structured-web-extraction/v1/url
Price per call: $0.005 USD
Networks payable on: Base Sepolia (eip155:84532)
Protocol: rest

Calling it

The first call returns 402 Payment Required with the terms. Sign for those terms and retry the same request with the payment attached.

Example request

A real, working call — the request the service card verifies against.

curl -X POST https://test.agent.pocket.network/v1/structured-web-extraction/v1/url \
  -H 'content-type: application/json' \
  -d '{"url":"https://example.com"}'

Example response

The response this call returned, captured 2026-09-25 15:53:31 UTC.

{
  "portal": {
    "provenance": "third-party-supplier",
    "serviceId": "structured-web-extraction",
    "schemaCheck": "unchecked"
  },
  "data": {
    "url": "https://example.com",
    "title": "Example Domain",
    "fields": {
      "title": "Example Domain",
      "language": "en",
      "h1": "Example Domain"
    },
    "page": {
      "headings": {
        "h1": [
          "Example Domain"
        ],
        "h2": [],
        "h3": []
      },
      "json_ld": [],
      "links_count": 1,
      "text_excerpt": "Example Domain Example Domain This domain is for use in documentation examples without needing permission. Avoid use in operations. Learn more",
      "text_length": 142
    },
    "schema_mode": "standard",
    "cached": true,
    "service": "structured-web-extraction"
  }
}

Try it

Make one real paid call from your own wallet — about $0.005 on Base Sepolia (eip155:84532). The wallet signs; nothing here holds a key. You'll see exactly what the service answers.

No browser wallet found. Install MetaMask, Rabby, or Coinbase Wallet to try a call here.

EndpointRequest body

Supported methods

Methods the registry lists for this service. The portal forwards any call as sent; the supplier decides what it answers, and a delivered answer is settled.

Methods Structured Web Extraction accepts, and whether each reads or writes.
Method	Effect
`GET /v1/health`	read
`GET /v1/version`	read
`POST /v1/url`	read

Schemas

Published by the service itself. The example above is generated from these.

Request schema

{
  "type": "object",
  "description": "The request body for POST /v1/url.",
  "properties": {
    "url": {
      "type": "string",
      "description": "The page URL (http or https)."
    },
    "schema": {
      "description": "Optional: a list of field names, a JSON Schema, or {fields: {name: regex}}."
    }
  },
  "required": [
    "url"
  ]
}

Response schema

{
  "type": "object",
  "description": "For POST /v1/url, a JSON object with url, title, `fields` and `page` (headings, json_ld, links_count, excerpt). The exact shape is the service's own and is not pinned here; errors return a JSON object with an `error` field."
}