Api Endpoint

Agent Mercantile

Fetch deterministic, token-efficient context from one public HTTPS URL: canonical URL, title/description, headings, clean main content, structured-data types, freshness observations, evidence, and limitations. Call when you need a bounded JSON reading of one public page without a browser, login, crawl, or LLM.

Open interactive test console

Offering

Provider
api.agentmercantile.com
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Web Search Research
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.agentmercantile.com/v1/url-context
MIME type
Not provided
First seen
2026-10-16T01:50:10.647Z
Last seen
Tags
url-context, webpage-context, web-extraction, page-evidence, structured-webpage

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.01 USDC
Atomic price: 10000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "payTo": "0xdb7b2b54f80479826222749a2ea73a8acc306e1e"
  }
]

Observed health

Status
Healthy
Latest latency
51 ms
Average latency
853 ms
HTTP status
200
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "additionalProperties": false,
      "properties": {
        "url": {
          "description": "One absolute public HTTPS URL on port 443. No credentials in the URL. http, non-443 ports, and private/non-public targets are rejected without fetch.",
          "format": "uri",
          "type": "string"
        }
      },
      "required": [
        "url"
      ],
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": false,
          "properties": {
            "url": {
              "description": "One absolute public HTTPS URL on port 443. No credentials in the URL. http, non-443 ports, and private/non-public targets are rejected without fetch.",
              "format": "uri",
              "type": "string"
            }
          },
          "required": [
            "url"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "additionalProperties": true,
          "properties": {
            "checked_at": {
              "description": "ISO-8601 timestamp when extraction ran.",
              "type": "string"
            },
            "content": {
              "properties": {
                "approx_tokens": {
                  "type": "integer"
                },
                "characters": {
                  "type": "integer"
                },
                "extraction_basis": {
                  "enum": [
                    "main",
                    "article",
                    "body-heuristic",
                    "none"
                  ],
                  "type": "string"
                },
                "text": {
                  "type": "string"
                },
                "token_estimate_method": {
                  "type": "string"
                },
                "truncated": {
                  "type": "boolean"
                }
              },
              "type": "object"
            },
            "evidence": {
              "type": "object"
            },
            "final_url": {
              "description": "Final URL after bounded redirects, or null on HOLD.",
              "type": [
                "string",
                "null"
              ]
            },
            "freshness": {
              "properties": {
                "observations": {
                  "type": "array"
                }
              },
              "type": "object"
            },
            "http": {
              "properties": {
                "content_type": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "redirect_count": {
                  "type": "integer"
                },
                "status": {
                  "type": [
                    "integer",
                    "null"
                  ]
                }
              },
              "type": "object"
            },
            "limitations": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "metadata": {
              "properties": {
                "canonical": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "description": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "title": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "type": "object"
            },
            "methodology_version": {
              "enum": [
                "url-context-0.1.0"
              ],
              "type": "string"
            },
            "outline": {
              "items": {
                "properties": {
                  "level": {
                    "type": "integer"
                  },
                  "text": {
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "type": "array"
            },
            "requested_url": {
              "description": "The buyer-supplied URL after request validation.",
              "type": "string"
            },
            "size": {
              "type": "object"
            },
            "status": {
              "enum": [
                "OK",
                "PARTIAL",
                "HOLD"
              ],
              "type": "string"
            },
            "structured_data": {
              "properties": {
                "json_ld_types": {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "type": "object"
            }
          },
          "required": [
            "status",
            "methodology_version",
            "requested_url",
            "content",
            "limitations"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}