{"uid":"cap_1Xo5jFFTCX8P-87Hi4K4e","slug":"freshproof-compare-c88f4dda","name":"FreshProof Compare","description":"Compare a fresh public web retrieval with previous evidence from a ProofBundle or retained snapshot. Returns deterministic fact differences, evidence, content hashes, retrieval timestamps, and significance for autonomous agents without inventing unsupported changes.","url":"https://freshproof-api-mainnet.up.railway.app/v1/compare","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","pattern":"^https?://","maxLength":4096,"description":"Public HTTP or HTTPS URL to retrieve for fresh comparison."},"previous":{"type":"object","required":["snapshotId"],"properties":{"snapshotId":{"type":"string","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Identifier of a retained FreshProof snapshot."}},"description":"Previous evidence supplied as a ProofBundle or retained snapshot identifier.","additionalProperties":false}}},"responseSchema":{"type":"json","example":{"changed":true,"warnings":[],"addedFacts":[],"currentHash":"bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb","previousHash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","removedFacts":[],"modifiedFacts":[{"name":"price","newValue":{"amount":24.99,"currency":"USD"},"oldValue":{"amount":19.99,"currency":"USD"},"newEvidence":{"quote":"USD 24.99","locator":"Freshly retrieved product price evidence","sourceUrl":"https://example.com/"},"oldEvidence":{"quote":"USD 19.99","locator":"Previous retained product price evidence","sourceUrl":"https://example.com/"},"significance":"material"}],"currentSnapshotId":"8b267630-834b-46c8-8e70-b7ca7cc54e28","currentRetrievedAt":"2026-07-28T08:30:00.000Z","highestSignificance":"material","previousRetrievedAt":"2026-07-27T08:30:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xWDSvyHBW4-R7WIvcvnmp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a live copy of a public URL and compares it against a previously stored FreshProof snapshot, returning deterministic fact differences, content hashes, and significance scores.","exampleAgentPrompt":"Check whether the Wikipedia page for 'Large language model' has changed since snapshot 3fa85f64-5717-4562-b3fc-2c963f66afa6 — tell me what facts are different, how significant the changes are, and show me the content hashes for both versions.","exampleUseCases":[{"title":"Detecting product price changes","prompt":"Compare the current Amazon listing at https://www.amazon.com/dp/B09XYZ1234 against my stored snapshot 1a2b3c4d-1234-4abc-a123-abcdef123456 and tell me if the price or availability has changed."},{"title":"Auditing a public policy document","prompt":"Fetch the latest version of https://example.gov/privacy-policy and diff it against snapshot f47ac10b-58cc-4372-a567-0e02b2c3d479 — I need to know exactly which facts or clauses were added, removed, or changed."},{"title":"Monitoring a competitor's homepage","prompt":"Pull the current version of https://competitor.com and compare it to my retained proof snapshot 550e8400-e29b-41d4-a716-446655440000 so I can see if they've updated their pricing, features, or messaging since last week."}],"resultDescription":"Returns a structured object containing deterministic fact differences (added, removed, or changed facts), content hashes for both the fresh retrieval and the previous snapshot, retrieval timestamps, evidence backing each difference, and a significance score indicating how materially the content has changed.","failureModes":["Snapshot ID not found or expired — returns 404-equivalent with error indicating unknown snapshotId","Target URL is unreachable or returns non-200 — returns error with retrieval failure details","URL pattern validation failure if URL is malformed or non-HTTP/HTTPS","Payment not included or insufficient — returns 402 Payment Required","Rate limiting or timeout on the target URL causes partial or failed retrieval","ProofBundle format mismatch causing comparison failure"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, evidence-backed diff between a live web page and a previously captured FreshProof snapshot. It is ideal for autonomous agents that must audit factual changes without hallucinating or inferring unsupported differences. Prefer it over generic scraping or summarization tools when reproducibility, content hashing, and verifiable evidence are required — especially for compliance, monitoring, or fact-checking workflows where provenance matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:35:35.793Z","isFirstParty":false}