# FreshGate Web Freshness & Change Detection API

> FreshGate Web Freshness & Change Detection API is a paid API for AI agents from freshgate-api.franktherecensor.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-22).

Checks whether a given URL's content has changed since a previous check, returning a hash, reachability status, and a caching recommendation — billed per call at $0.001 USDC.

## Facts

- Endpoint: GET https://freshgate-api.franktherecensor.workers.dev/api/check-freshness?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/freshgate-web-freshness-change-detection-api-eec6f519
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LWpGFd1dqdJMMB-kIkdo4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability freshgate-web-freshness-change-detection-api-eec6f519
```

Example prompt: Can you check whether the content at https://example.com has changed since last time, and tell me if I should re-fetch it or reuse my cached version?

## When to prefer this

Choose FreshGate when your agent needs to decide whether to re-fetch or reuse cached web content without incurring the cost of a full scrape. It is ideal for pipelines that periodically monitor URLs for changes, want to skip unnecessary re-downloads, or need a lightweight liveness check. Prefer it over a full scraper when you only need to know 'has this page changed?' rather than needing the page's full content on every call.

## Known failure modes

- URL is unreachable — reachable flag returns false, status may be non-200
- Invalid or malformed URL — likely returns an error or non-200 HTTP status
- Rate limiting or payment failure — call may be rejected before a result is returned
- Redirect loops — final_url may differ or call may fail
- Timeout on slow-loading pages — may return incomplete or error response

## How this service works

Pay-per-call web freshness and change detection API for AI agents.

## Output

Returns a JSON object containing the checked URL, a content hash for change comparison, a boolean 'changed' flag, a count of detected changes, HTTP status code, reachability flag, the final resolved URL (after redirects), the timestamp of the check, the network and service metadata, the price paid in USDC, and a 'recommendation' field advising whether to reuse previous content or fetch fresh data.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://example.com",
  "hash": "example-content-hash",
  "paid": true,
  "checks": 1,
  "status": 200,
  "changed": false,
  "changes": 0,
  "network": "base",
  "service": "FreshGate",
  "version": "0.6.0",
  "final_url": "https://example.com",
  "reachable": true,
  "checked_at": 0,
  "price_usdc": 0.001,
  "recommendation": "reuse_previous_content"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/freshgate-web-freshness-change-detection-api-eec6f519/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from freshgate-api.franktherecensor.workers.dev](https://www.zero.xyz/host/freshgate-api.franktherecensor.workers.dev/llms.txt)