goguides.com trust favicon wikipedia.org trust favicon mozilla.org trust favicon
GoGuides publishes independent web evidence, provenance, and machine-readable records.
Log In Navigation
Developer & Machine API Hub

Use GoGuides as web-evidence infrastructure

GoGuides independently observes public web sources and exposes machine-readable evidence about source identity, observed state, historical change, verification, provenance, GoGuides-derived assessment, bounded analysis, and source-use context.

This page is the human-readable capability map. Machines should start with /machine-use.json and the OpenAPI 3.1 contract.

Machine discovery freshness

/machine-use.json carries a body-level freshness contract so machine consumers can identify stale discovery copies. The discovery_document.revision and discovery_document.updated_at_utc values change only when the discovery document itself changes; they do not change merely because the same document is fetched again.

The origin advertises a five-minute cache lifetime for /machine-use.json. Consumers that require current capability discovery should revalidate after that interval and may compare the body-level revision or update timestamp across fetches. Apache also supplies Last-Modified for conditional revalidation.

Freshness contract: goguides-machine-discovery-freshness-v1.

Cache-replay canary

If a consumer suspects that a retrieval tool, proxy, or intermediary is replaying stale bytes, use the public GET-only cache-replay canary. Generate a new unique nonce for each check, request /selftest.json?nonce=<unique_nonce>, and require echoed_nonce in the JSON response to exactly match the nonce just generated.

A matching nonce means GoGuides received that nonce and generated the response after receiving it. A mismatch means the consumer should not treat its retrieval layer as fresh, even if HTTP cache metadata appears valid. Do not reuse an old nonce when testing freshness.

Capability: goguides.cache_replay_canary. Method: GET. Open an example canary request.

Capability map

Evaluate

Resolve a supported root/domain or exact public URL through the authoritative GoGuides evaluation path for that normalized scope.

Read Evaluate documentation

Batch Evaluate

Evaluate multiple exact URLs in one bounded request while preserving the same per-URL evaluation authority used by single Evaluate.

Read Batch Evaluate documentation

Web State V3

Read the latest supported stored observation of content, structured data, headers, links, word count, AI-facing policy state, and related provenance fields.

Read Web State documentation

URL Request

Explicitly request GoGuides intelligence for one public URL and receive an attributed request/result lifecycle under the documented contract.

Read URL Request documentation

Claim Support

Run bounded model-assisted analysis against one fixed stored GoGuides source observation, then inspect lifecycle status or submit feedback.

Read Claim Support documentation

Content Relationships

Compare two exact public URLs using stored evidence and conservative relationship states without inferring ownership, intent, or coordination.

Read Content Relationships documentation

Verified Text

Retrieve source-attributed public text records with stable record metadata and SHA-256 integrity values.

Open Verified Text

Discovery & contracts

Use machine-use discovery, AI Discovery, compact public signals, OpenAPI, human documentation, and response metadata to locate the right evidence surface.

Open AI Discovery

How the pieces fit together

Observe

GoGuides independently records publicly observable source and domain state.

Evaluate

Evaluate resolves the requested normalized scope through the authoritative GoGuides record path.

Compare

Web State and Change Intelligence expose stored evidence and deterministic longitudinal differences.

Analyze

Claim Support and Content Relationships add bounded analysis without rewriting the underlying observation.

Monitor

History, state, change, verification, provenance, and integrity records help consumers decide when deeper inspection is useful.

Verify

Verification, provenance, history, machine identity, and integrity records provide additional evidence a consuming system can inspect.

Evidence → Interpretation → Decision

GoGuides keeps independently observed evidence distinguishable from deterministic comparisons, GoGuides-derived assessments, model-assisted judgments, and downstream source-use decisions. A consumer can use the layers together without treating any one layer as a universal truth certificate.

Important interpretation boundary

GoGuides does not claim that every statement on an observed website is true, that every source is safe for every use, or that an outside AI system will rank, cite, recommend, train on, retrieve, transact with, or otherwise use a source. Consumers inspect the evidence and apply their own policies.