{"uid":"cap_lomxBDQ3FNTBj9yXwp-gu","slug":"watch-diff-http-headers-fetch-6a8da43d","name":"Watch & Diff — HTTP Headers Fetch","description":"Did this URL change since my last check? Fetch, normalize, hash and diff any page, region or JSON for AI agents running recurring tasks. State per paying wallet, 90 days. Pay per call over x402, no API key.","url":"https://watch-diff.agent-utils.workers.dev/v1/headers","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","description":"Absolute http(s) URL to fetch (max 2 MB body)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ok":{"type":"boolean"},"url":{"type":"string"},"status":{"type":"integer"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"finalUrl":{"type":"string"},"checkedAt":{"type":"string"},"redirected":{"type":"boolean"},"responseMs":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"url":"https://example.com/","status":200,"headers":{"etag":"\"8423…\"","server":"ECAcc","content-type":"text/html; charset=UTF-8","cache-control":"max-age=3600","last-modified":"Mon, 13 Jan 2025 20:11:20 GMT","content-length":"1256"},"finalUrl":"https://example.com/","checkedAt":"2026-09-06T21:10:00.000Z","redirected":false,"responseMs":95}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_W0NczLoYdEf2-ZbqiBtT-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the HTTP response headers for a given URL, returning status, redirect info, timing, and all headers without downloading the full body.","exampleAgentPrompt":"Fetch the HTTP headers for https://example.com/data.json and tell me its ETag, Last-Modified, and whether it redirected anywhere.","exampleUseCases":[{"title":"Cache freshness check for a resource","prompt":"Check the headers for https://api.partner.com/feed.json — I want to know the Cache-Control policy, the ETag, and whether it redirected before answering."},{"title":"Uptime and redirect monitoring","prompt":"Probe https://myapp.com/health right now and tell me if it returned a 200 or redirected, how long it took, and what server header it reported."},{"title":"Content-type verification before processing","prompt":"Before I send that URL to my pipeline, can you fetch the headers for https://cdn.example.com/report.pdf and confirm the content-type and content-length so I know it's actually a PDF?"}],"resultDescription":"A JSON object with: ok (boolean), url (the requested URL), status (HTTP status code), headers (key-value map of all response headers such as ETag, Last-Modified, Cache-Control, Content-Type, Server), finalUrl (URL after any redirects), redirected (boolean), checkedAt (ISO timestamp), and responseMs (round-trip latency in milliseconds).","failureModes":["URL is unreachable or DNS fails — returns ok: false with an error message","URL exceeds 2 MB body limit — may error or truncate","Non-HTTP/HTTPS URLs are rejected","Payment via x402 fails or wallet has insufficient USDC — request is rejected before fetch","Target server returns no headers or times out — partial or error response"],"whenToPreferThis":"Use this endpoint when you only need HTTP metadata (headers, status, redirect chain, latency) for a URL without downloading and parsing the full body. It is ideal for lightweight change detection using ETag or Last-Modified, uptime probing, content-type pre-checks, and redirect auditing. Prefer it over full-page fetch or diff endpoints when you do not need body content. It charges per call via x402 micropayments with no API key setup required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:43:18.109Z","isFirstParty":false}