Agent Mercantile · URL Context

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://api.agentmercantile.com/v1/url-context", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "url": "https://example.com/"
  }),
});
const data = await res.json();

curl -X POST \
  "https://api.agentmercantile.com/v1/url-context" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/"}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "checked_at": "2026-08-19T00:00:00.000Z",
  "content": {
    "approx_tokens": 39,
    "characters": 155,
    "extraction_basis": "body-heuristic",
    "text": "This domain is for use in illustrative examples in documents. You may use this domain in literature without prior coordination or asking for permission.",
    "token_estimate_method": "ceil(characters/4)",
    "truncated": false
  },
  "evidence": {
    "final_response_headers": {
      "content-type": "text/html; charset=UTF-8"
    },
    "notes": []
  },
  "final_url": "https://example.com/",
  "freshness": {
    "observations": []
  },
  "http": {
    "content_type": "text/html; charset=UTF-8",
    "redirect_count": 0,
    "status": 200
  },
  "limitations": [],
  "metadata": {
    "canonical": "https://example.com/",
    "description": null,
    "title": "Example Domain"
  },
  "methodology_version": "url-context-0.1.0",
  "outline": [
    {
      "level": 1,
      "text": "Example Domain"
    }
  ],
  "requested_url": "https://example.com/",
  "size": {
    "normalized_content_characters": 155,
    "output_json_bytes": 1400,
    "source_bytes_read": 1256
  },
  "status": "OK",
  "structured_data": {
    "json_ld_types": []
  }
}