Documents & Structured Data · x402 V2

Schema.org Extract

Use this service when you need this capability: extracts bounded JSON-LD Schema.org entities, type indexes, and explicit relationships without inventing values.

Price and endpoint

LivePOSTBase USDC

0.01 USDC per call

x402 V2 exact payment on Base mainnet (eip155:8453) using USDC. The HTTP 402 challenge confirms the exact requirements before an authorized payment.

POST https://signalharness.ai/api/agent/services/schema_org_extract/invoke

Purpose

Extracts bounded JSON-LD Schema.org entities, type indexes, and explicit relationships without inventing values.

Documented public-source retrieval is bounded by the URL, byte, redirect, and timeout limits below. Source availability can affect execution; review the input schema and returned source metadata.

Inputs

Request fields and validation limits
FieldTypeRequiredLimits
urlstringOptionalPattern: ^https://; Minimum length 9; Maximum length 2048
htmlstringOptionalMinimum length 1; Maximum length 65536
baseUrlstringOptionalPattern: ^https://; Minimum length 9; Maximum length 2048

Example request body

{
  "html": "<script type=\"application/ld+json\">{\"@type\":\"WebPage\"}</script>"
}
View complete input schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "additionalProperties": false,
  "minProperties": 1,
  "maxProperties": 2,
  "required": [],
  "properties": {
    "url": {
      "type": "string",
      "pattern": "^https://",
      "minLength": 9,
      "maxLength": 2048
    },
    "html": {
      "type": "string",
      "minLength": 1,
      "maxLength": 65536
    },
    "baseUrl": {
      "type": "string",
      "pattern": "^https://",
      "minLength": 9,
      "maxLength": 2048
    }
  }
}

Realistic output shape

Illustrative output from the canonical adapter fixture and schema. It is not a completed paid execution or a current live observation.

{
  "entityCount": 0,
  "typeIndex": [
    {
      "type": "example",
      "ids": [
        "example"
      ]
    }
  ],
  "entities": [
    {
      "id": "example",
      "types": [
        "example"
      ],
      "valueJson": "example"
    }
  ],
  "relationships": [
    {
      "from": "example",
      "to": "example",
      "kind": "example"
    }
  ],
  "warnings": [
    "Verify the caller-supplied data before relying on this result."
  ]
}
View complete output schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "additionalProperties": false,
  "minProperties": 5,
  "maxProperties": 5,
  "required": [
    "entityCount",
    "typeIndex",
    "entities",
    "relationships",
    "warnings"
  ],
  "properties": {
    "entityCount": {
      "type": "integer",
      "minimum": 0,
      "maximum": 2000
    },
    "typeIndex": {
      "type": "array",
      "minItems": 0,
      "maxItems": 256,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "minProperties": 2,
        "maxProperties": 2,
        "required": [
          "type",
          "ids"
        ],
        "properties": {
          "type": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256
          },
          "ids": {
            "type": "array",
            "minItems": 1,
            "maxItems": 256,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048
            }
          }
        }
      }
    },
    "entities": {
      "type": "array",
      "minItems": 0,
      "maxItems": 256,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "minProperties": 3,
        "maxProperties": 3,
        "required": [
          "id",
          "types",
          "valueJson"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2048
          },
          "types": {
            "type": "array",
            "minItems": 0,
            "maxItems": 32,
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 256
            }
          },
          "valueJson": {
            "type": "string",
            "minLength": 2,
            "maxLength": 65536
          }
        }
      }
    },
    "relationships": {
      "type": "array",
      "minItems": 0,
      "maxItems": 256,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "minProperties": 3,
        "maxProperties": 3,
        "required": [
          "from",
          "to",
          "kind"
        ],
        "properties": {
          "from": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2048
          },
          "to": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2048
          },
          "kind": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256
          }
        }
      }
    },
    "warnings": {
      "type": "array",
      "minItems": 0,
      "maxItems": 32,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 1024
      }
    }
  }
}

Execution limits

  • MaxInputBytes: 131072
  • MaxOutputBytes: 1048576
  • MaxConcurrentExecutions: 2
  • MaxArtifacts: 0
  • MaxArtifactBytes: 0
  • RateLimitPerMinute: 30
  • MaxFetchBytes: 2097152
  • MaxDecodedBytes: 2097152
  • FetchTimeoutMs: 20000
  • MaxRedirects: 3
  • MaxEntities: 2000
  • MaxNesting: 32
  • MaxNodes: 25000

Timeout: 30000 ms. Full schemas are in OpenAPI.

Copyable unpaid request

This schema-valid request returns the canonical HTTP 402 challenge without executing the service. A payment-capable client validates the challenge, signs only with prior authority and budget, and retries the identical body.

curl -i -X POST https://signalharness.ai/api/agent/services/schema_org_extract/invoke \
  -H "Content-Type: application/json" \
  --data '{"html":"<script type=\"application/ld+json\">{\"@type\":\"WebPage\"}</script>"}'

Continue with the paid-call walkthrough →