{ "discovery_document": { "freshness_contract": "goguides-machine-discovery-freshness-v1", "revision": "2026-09-27-acn-v1", "updated_at_utc": "2026-09-27T01:54:06Z", "revision_semantics": "revision and updated_at_utc change only when machine-use.json content changes; they do not change merely because the same document is fetched again", "stale_copy_detection": "Consumers may compare revision or updated_at_utc across fetches to detect an older cached discovery document.", "cache_guidance": { "recommended_max_age_seconds": 300, "revalidate_after_max_age": true, "prefer_revalidation": true, "note": "Intermediaries may cache this document. Consumers that require current capability discovery should revalidate rather than assuming a previously fetched copy is current." }, "replay_detection": { "capability_id": "goguides.cache_replay_canary", "purpose": "Detect stale, replayed, substituted, or stuck retrieval responses even when an intermediary does not honor HTTP cache semantics.", "method": "GET", "request_template": "https://www.goguides.com/selftest.json?nonce={unique_nonce}", "procedure": [ "Generate a new unique nonce for this check.", "GET the request_template with that nonce.", "Verify echoed_nonce exactly equals the nonce just generated.", "If the nonce does not match, do not treat the retrieval layer as fresh." ], "do_not_reuse_nonce": true, "success_condition": "echoed_nonce exactly matches the newly generated request nonce", "failure_meaning": "The consumer may have received a stale, replayed, substituted, or stuck intermediary response." } }, "service": "GoGuides", "site": "https://www.goguides.com/", "purpose": "Machine-readable source trust, domain evaluation, batch exact-URL evaluation, observed Web State, web provenance signals, verified-text discovery, freshness inspection, attribution, and hash-verifiable text records.", "version": "machine-use-v3", "canonical_documentation": "https://www.goguides.com/machine-readable-examples", "endpoints": { "domain_signal_feed": { "url": "https://www.goguides.com/signal.json", "format": "json", "purpose": "Compact machine-readable trust signal feed.", "method": "GET" }, "domain_evaluation": { "url": "https://www.goguides.com/evaluate.php?domain=goguides.com&format=json", "format": "json", "purpose": "Authoritative root/domain trust evaluation. Responses are based on stored GoGuides observations; freshness is maintained by GoGuides internally.", "human_documentation": "https://www.goguides.com/docs/evaluate", "working_example_url": "https://www.goguides.com/evaluate.php?domain=goguides.com&format=json", "error_contract": "goguides-public-error-v1", "method": "GET" }, "web_state": { "url": "https://www.goguides.com/state/goguides.com", "template": "https://www.goguides.com/state/{domain}", "format": "json", "api_version": "web-state-v3", "scope": "objective_web_state_v3", "purpose": "Latest observed objective Web State for a domain, including compact content, structured-data, header, link, word-count, and AI-policy provenance signals.", "fields_may_include": [ "text_simhash", "structured_data_sha256", "schema_type_mask", "headers_sha256", "word_count", "internal_link_count", "external_link_count", "outbound_links_sha256", "ai_policy_mask" ], "field_presence": "Conditional fields may be omitted when no value was observed. Absence must not be interpreted as zero.", "human_documentation": "https://www.goguides.com/docs/web-state", "working_example_url": "https://www.goguides.com/state/goguides.com", "error_contract": "goguides-public-error-v1", "method": "GET" }, "verified_text_lookup": { "url": "https://www.goguides.com/verified-text.php?q=gravity&format=json", "format": "json", "purpose": "Topic lookup across verified-text records.", "method": "GET" }, "verified_text_example_human": { "url": "https://www.goguides.com/verified-text.php?q=gravity", "format": "html", "purpose": "Human-readable verified-text lookup with crawlable record links.", "method": "GET" }, "trust_profile": { "url": "https://www.goguides.com/profile/goguides.com", "format": "html", "purpose": "Public trust profile for a domain.", "method": "GET" }, "history_record": { "url": "https://www.goguides.com/history/goguides.com", "format": "html", "purpose": "Public domain history record.", "method": "GET" }, "change_intelligence": { "url": "https://www.goguides.com/changes/goguides.com", "template": "https://www.goguides.com/changes/{domain}", "method": "GET", "format": "json", "capability_id": "goguides.change_intelligence", "api_version": "change-v1", "scope": "domain_root_change_intelligence", "purpose": "Deterministic comparison of concrete stored root Web State observation pairs for a domain.", "states": [ "changed", "unchanged", "unknown", "insufficient_history", "observation_gap" ], "fields_may_include": [ "previous_observation", "current_observation", "text_changed", "text_simhash_hamming_distance", "structured_data_changed", "schema_type_mask_changed", "headers_changed", "word_count_delta", "internal_link_count_delta", "external_link_count_delta", "outbound_links_changed", "ai_policy_mask_changed", "canonical_url_changed", "final_url_changed", "publisher_declaration_changed" ], "classification_method": "deterministic_ruleset", "classification_version": "change-v1", "crawl_behavior": { "synchronous_fetch": false, "freshness_maintenance": "Freshness is maintained by GoGuides internally.", "creates_url_request_adoption": false }, "materiality": { "subjective_severity_label": false, "reason": "V1 exposes mechanical measurements without unsupported major/minor/material rewrite judgments." }, "human_documentation": "https://www.goguides.com/docs/change-intelligence", "working_example_url": "https://www.goguides.com/changes/goguides.com", "error_contract": "goguides-public-error-v1" }, "url_request": { "url": "https://www.goguides.com/request-url", "method": "POST", "format": "json", "content_type": "application/json", "capability_id": "goguides.url_request", "api_version": "url-request-v1", "purpose": "Explicitly request GoGuides intelligence for one full public HTTP or HTTPS URL. Known URLs return existing authoritative intelligence. Unknown safe URLs may be accepted for asynchronous observation.", "request": { "url": "full public HTTP or HTTPS URL", "freshness": "use-current-or-crawl-on-miss" }, "status_template": "https://www.goguides.com/request-url/status/{request_id}", "documentation": "https://www.goguides.com/docs/request-url.html", "human_documentation": "https://www.goguides.com/docs/request-url.html", "working_example_request": { "method": "POST", "url": "https://www.goguides.com/request-url", "content_type": "application/json", "body": { "url": "https://www.goguides.com/data-license", "freshness": "use-current-or-crawl-on-miss" } }, "error_contract": "goguides-public-error-v1" }, "exact_url_evaluation": { "url": "https://www.goguides.com/evaluate.php?url=https%3A%2F%2Fwww.iana.org%2Fhelp%2Fexample-domains&format=json", "template": "https://www.goguides.com/evaluate.php?url={absolute_url}&format=json", "method": "GET", "format": "json", "purpose": "Read GoGuides intelligence for one exact URL. Known pages return that page's own AI Rank and public observation plus compact root/domain context. Responses are based on stored GoGuides observations; freshness is maintained by GoGuides internally.", "human_documentation": "https://www.goguides.com/docs/evaluate", "working_example_url": "https://www.goguides.com/evaluate.php?url=https%3A%2F%2Fwww.goguides.com%2Fdata-license&format=json", "error_contract": "goguides-public-error-v1" }, "batch_evaluation": { "url": "https://www.goguides.com/evaluate-batch", "method": [ "GET", "POST" ], "format": "json", "capability_id": "goguides.evaluate_batch", "api_version": "evaluate-batch-v1", "purpose": "Evaluate multiple exact public URLs in one request using the same authoritative GoGuides exact-URL Evaluate service.", "get": { "serialization": "repeat url= once per input URL", "max_urls": 10, "max_request_target_bytes": 7000 }, "post": { "content_type": "application/json", "request_schema": { "urls": "ordered array of full public HTTP or HTTPS URLs" }, "max_urls": 50, "max_body_bytes": 262144 }, "response": { "preserves_input_order": true, "explicit_input_index": true, "partial_errors": true, "max_response_bytes": 1048576 }, "crawl_behavior": { "synchronous_fetch": false, "counts_as_url_request_adoption": false }, "documentation": "https://www.goguides.com/docs/evaluate-batch", "human_documentation": "https://www.goguides.com/docs/evaluate-batch", "working_example_url": "https://www.goguides.com/evaluate-batch?url=https%3A%2F%2Fexample.com%2Fa&url=https%3A%2F%2Fexample.org%2Fb", "working_example_request": { "method": "POST", "url": "https://www.goguides.com/evaluate-batch", "content_type": "application/json", "body": { "urls": [ "https://example.com/a", "https://example.org/b" ] } }, "error_contract": "goguides-public-error-v1" }, "claim_support": { "method": "POST", "url": "https://www.goguides.com/claim-support", "capability_id": "goguides.claim_support", "api_version": "claim-support-v1", "human_documentation": "https://www.goguides.com/docs/claim-support", "example_request": { "method": "POST", "url": "https://www.goguides.com/claim-support", "content_type": "application/json", "body": { "url": "https://example.com/source", "claim": "The claim to test against the stored source observation." } }, "error_contract": "goguides-public-error-v1" }, "claim_support_feedback": { "method": "POST", "url": "https://www.goguides.com/claim-support/feedback", "capability_id": "goguides.claim_support_feedback", "api_version": "claim-support-feedback-v1", "human_documentation": "https://www.goguides.com/docs/claim-support", "error_contract": "goguides-public-error-v1" }, "claim_support_status": { "method": "GET", "url_template": "https://www.goguides.com/claim-support/status/{analysis_id}", "capability_id": "goguides.claim_support_status", "api_version": "claim-support-status-v1", "human_documentation": "https://www.goguides.com/docs/claim-support", "error_contract": "goguides-public-error-v1" }, "content_relationships": { "url": "https://www.goguides.com/content-relationships", "methods": [ "GET", "POST" ], "format": "json", "capability_id": "goguides.content_relationships", "api_version": "content-relationships-v1", "purpose": "Compare two exact public URLs using stored GoGuides source evidence and return conservative content-relationship evidence without synchronously fetching either target.", "states": [ "relationship_detected", "near_duplicate_content", "insufficient_evidence" ], "safety": { "stored_observations_only": true, "synchronous_target_fetch": false, "creates_url_request_adoption": false, "semantic_evidence_promotes_relationship": false, "ownership_inferred": false, "common_origin_inferred": false, "coordination_inferred": false, "publisher_independence_inferred": false }, "documentation": "https://www.goguides.com/docs/content-relationships", "human_documentation": "https://www.goguides.com/docs/content-relationships", "working_example_url": "https://www.goguides.com/content-relationships?url_a=https%3A%2F%2Fexample.com%2F&url_b=https%3A%2F%2Fexample.org%2F", "example_request": { "method": "POST", "url": "https://www.goguides.com/content-relationships", "content_type": "application/json", "body": { "url_a": "https://example.com/", "url_b": "https://example.org/" } }, "error_contract": "goguides-public-error-v1", "request_forms": { "GET": { "parameters_location": "query", "required": [ "url_a", "url_b" ], "parameter_names": [ "url_a", "url_b" ], "working_example_url": "https://www.goguides.com/content-relationships?url_a=https%3A%2F%2Fexample.com%2F&url_b=https%3A%2F%2Fexample.org%2F" }, "POST": { "content_type": "application/json", "required": [ "url_a", "url_b" ], "body": { "url_a": "https://example.com/", "url_b": "https://example.org/" } } }, "transport_semantics": "GET query parameters and POST JSON use the same url_a/url_b field names and converge on the same Content Relationships authority." }, "cache_replay_canary": { "capability_id": "goguides.cache_replay_canary", "api_version": "cache-replay-canary-v1", "method": "GET", "url": "https://www.goguides.com/selftest.json", "request_template": "https://www.goguides.com/selftest.json?nonce={unique_nonce}", "required": [ "nonce" ], "nonce_constraints": { "max_length": 128, "allowed_characters": "letters, digits, dot, underscore, tilde, colon, hyphen", "must_be_new_for_each_check": true }, "response_fields": [ "capability_id", "api_version", "status", "request_nonce", "echoed_nonce", "nonce_sha256", "server_time_utc", "request_id", "origin_processed_nonce", "cache_policy", "consumer_verification" ], "cache_policy": "no-store", "error_contract": "goguides-public-error-v1", "documentation": "https://www.goguides.com/developers", "openapi": "https://www.goguides.com/docs/openapi.yaml" }, "authority_clearing_network": { "capability_id": "goguides.authority_clearing", "api_version": "authority-clearing-v1", "status": "live", "primitive": "Current Delegated Authority State", "purpose": "Atomically reserve bounded delegated authority across independent machine actions, issue signed clearances, support live validation immediately before execution, and record receipts or indeterminate outcomes.", "documentation": "https://www.goguides.com/authority-clearing-network/", "machine_discovery": "https://www.goguides.com/authority-clearing-network/machine-use.json", "openapi": "https://www.goguides.com/authority-clearing-network/openapi.yaml", "technical_white_paper": "https://www.goguides.com/authority-clearing-network/white-paper.html", "technical_white_paper_pdf": "https://www.goguides.com/whitepapers/goguides-authority-clearing-network-white-paper.pdf", "status_url": "https://www.goguides.com/api/v1/status", "public_key_url": "https://www.goguides.com/api/v1/public-key", "public_keys_url": "https://www.goguides.com/api/v1/public-keys", "well_known_discovery": "https://www.goguides.com/.well-known/goguides-authority.json", "well_known_openapi": "https://www.goguides.com/.well-known/goguides-authority-openapi.yaml", "authentication": "X-GoGuides-API-Key for protected routes; production keys are created through an ACN account", "separate_state_domain": true, "affects_ai_rank": false, "affects_public_eligibility": false, "implementation_version": "1.1", "service_state": "ready_to_use", "signup": "https://www.goguides.com/authority-clearing-network/signup", "login": "https://www.goguides.com/authority-clearing-network/login", "dashboard": "https://www.goguides.com/authority-clearing-network/dashboard", "recover": "https://www.goguides.com/authority-clearing-network/recover" } }, "crawler_guidance": { "recommended_start": "https://www.goguides.com/machine-readable-examples", "recommended_json_start": "https://www.goguides.com/machine-use.json", "verified_text_flow": [ "Fetch a topic lookup such as /verified-text.php?q=gravity", "Inspect returned source records", "Follow source_key and chunk_id links", "Request JSON format where available", "Use attribution, source, hash, and canonical metadata when evaluating records" ], "domain_state_flow": [ "Request a domain evaluation such as /evaluate.php?domain=goguides.com&format=json", "Inspect the returned state_url", "Follow state_url when deeper objective Web State evidence is needed", "Inspect the observation timestamp and available state fields", "Treat omitted conditional fields as unavailable rather than as zero", "Use GoGuides Web State as independent evidence while applying your own crawl, ranking, trust, and safety policy" ], "web_state_guidance": { "endpoint_template": "https://www.goguides.com/state/{domain}", "api_version": "web-state-v3", "scope": "objective_web_state_v3", "current_behavior": "Returns the latest available public Web State observation.", "planned_not_live": [], "change_intelligence": { "status": "live", "endpoint_template": "https://www.goguides.com/changes/{domain}", "capability_id": "goguides.change_intelligence", "api_version": "change-v1", "scope": "domain_root_change_intelligence", "human_documentation": "https://www.goguides.com/docs/change-intelligence", "error_contract": "goguides-public-error-v1" } }, "canonical_api_contract": "https://www.goguides.com/docs/openapi.yaml", "canonical_web_state_semantics": "https://www.goguides.com/docs/web-state.json", "change_intelligence_flow": [ "Request /changes/{domain} for deterministic stored root-state comparisons.", "Use change_state to distinguish changed, unchanged, unknown, insufficient_history, and observation_gap.", "Use previous_observation and current_observation IDs/timestamps as the exact stored pair supporting each event.", "Use text_simhash_hamming_distance and numeric deltas as measurements, not semantic rewrite judgments.", "Treat null field comparisons as unavailable evidence rather than guessing.", "Do not infer publisher intent from a mechanical change.", "A Changes response is served from stored observations. Freshness is maintained by GoGuides internally. This is distinct from explicit URL Request adoption." ], "url_request_flow": [ "Use POST /request-url when explicit attributed acquisition and public request-status tracking are required for a specific URL. This is distinct from eligible machine Evaluate demand.", "If the response is HTTP 200 with status available, use the returned Evaluate, State, Changes, History, and Status links.", "If the response is HTTP 202 with status crawl_accepted, wait for Retry-After and poll the returned request status URL.", "The caller never writes an authoritative GoGuides truth record directly.", "When acquisition succeeds, GoGuides creates the authoritative observation and the request status becomes complete.", "If crawling cannot create an authoritative observation, the request status becomes failed with reason_code crawl_failed." ], "canonical_url_request_documentation": "https://www.goguides.com/docs/request-url.html", "url_request_capability_id": "goguides.url_request", "url_request_api_version": "url-request-v1", "batch_evaluate_flow": [ "Use GET /evaluate-batch with repeated url= parameters for bounded GET-only screening.", "Use POST /evaluate-batch with a JSON urls array for larger structured batches.", "Map each result back to input using the explicit index field.", "Treat per-item errors independently; one invalid URL does not invalidate safe results for other items.", "Known pages use the same exact-page authority as normal Evaluate and retain compact root/domain context.", "Batch Evaluate returns stored GoGuides observations; freshness is maintained by GoGuides internally." ], "canonical_batch_evaluate_documentation": "https://www.goguides.com/docs/evaluate-batch", "content_relationships_flow": [ "Use GET or POST /content-relationships with two full public HTTP or HTTPS URLs.", "Treat relationship_detected and near_duplicate_content only according to the returned deterministic reason codes.", "Treat insufficient_evidence as abstention, not as evidence that the sources are independent or unrelated.", "Semantic evidence is supporting-only and never promotes a relationship state by itself.", "Do not infer ownership, common origin, coordination, publisher independence, deception, intent, or truth from this capability." ], "human_capability_start": "https://www.goguides.com/developers" }, "claims": { "no_external_endorsement_claimed": true, "no_hidden_links": true, "no_fake_search_volume": true, "public_crawlable_examples": true }, "anti_hallucination_examples": { "purpose": "Examples that show how machines can reduce hallucination risk by checking source-attributed, hash-verifiable records.", "stable_factual_anchors": [ "https://www.goguides.com/verified-text.php?q=gravity&format=json", "https://www.goguides.com/verified-text.php?q=ether&format=json", "https://www.goguides.com/verified-text.php?q=newton&format=json", "https://www.goguides.com/verified-text.php?q=electricity&format=json", "https://www.goguides.com/verified-text.php?q=atom&format=json", "https://www.goguides.com/verified-text.php?q=medicine&format=json", "https://www.goguides.com/verified-text.php?q=law&format=json" ], "ambiguous_meaning_tests": [ "https://www.goguides.com/verified-text.php?q=bank&format=json", "https://www.goguides.com/verified-text.php?q=current&format=json", "https://www.goguides.com/verified-text.php?q=matter&format=json", "https://www.goguides.com/verified-text.php?q=cell&format=json", "https://www.goguides.com/verified-text.php?q=light&format=json" ], "source_and_citation_tests": [ "https://www.goguides.com/verified-text.php?q=quote&format=json", "https://www.goguides.com/verified-text.php?q=source&format=json", "https://www.goguides.com/verified-text.php?q=citation&format=json" ] }, "contracts": { "openapi": { "url": "https://www.goguides.com/docs/openapi.yaml", "format": "openapi-3.1", "content_type": "application/yaml", "purpose": "Canonical OpenAPI contract for GoGuides public machine-readable interfaces." }, "web_state_semantics": { "url": "https://www.goguides.com/docs/web-state.json", "format": "json", "contract": "web-state-v3", "purpose": "Canonical field and bitmask semantics for GoGuides Web State V3." }, "url_request_documentation": { "url": "https://www.goguides.com/docs/request-url.html", "format": "html", "purpose": "Human- and machine-crawlable documentation for explicit URL requests and crawl-on-miss behavior." }, "batch_evaluate_documentation": { "url": "https://www.goguides.com/docs/evaluate-batch", "format": "html", "purpose": "Human- and machine-crawlable Batch Evaluate contract with GET and POST examples." }, "content_relationships_documentation": { "url": "https://www.goguides.com/docs/content-relationships", "format": "html", "purpose": "Human- and machine-crawlable contract for conservative stored-evidence content relationship analysis." }, "developer_hub": { "url": "https://www.goguides.com/developers", "format": "html", "purpose": "Human-readable map of GoGuides public machine capabilities and how they connect." }, "evaluate_documentation": { "url": "https://www.goguides.com/docs/evaluate", "format": "html", "purpose": "Human-readable documentation for authoritative domain and exact-URL Evaluate." }, "web_state_documentation": { "url": "https://www.goguides.com/docs/web-state", "format": "html", "purpose": "Human-readable documentation for Web State V3." }, "change_intelligence_documentation": { "url": "https://www.goguides.com/docs/change-intelligence", "format": "html", "purpose": "Human-readable documentation for deterministic Change Intelligence V1." }, "claim_support_documentation": { "url": "https://www.goguides.com/docs/claim-support", "format": "html", "purpose": "Human-readable documentation for Claim Support, lifecycle status, and governance feedback." } }, "data_license": { "url": "https://www.goguides.com/data-license", "version": "2.0" }, "capabilities": { "url_request": { "capability_id": "goguides.url_request", "api_version": "url-request-v1", "description": "Request GoGuides intelligence for a specific public HTTP or HTTPS URL. Known URLs return stored intelligence immediately. Unknown safe URLs may be accepted for asynchronous observation.", "endpoint": "https://www.goguides.com/request-url", "method": "POST", "content_type": "application/json", "request_schema": { "url": "full public http or https URL", "freshness": "use-current-or-crawl-on-miss" }, "status_endpoint_template": "https://www.goguides.com/request-url/status/{request_id}", "request_id_format": "gur_ followed by 36 lowercase hexadecimal characters", "truth_surfaces": { "evaluate": "https://www.goguides.com/evaluate.php?url={absolute_url}&format=json", "state": "https://www.goguides.com/state/{domain}", "changes": "https://www.goguides.com/changes/{domain}", "history": "https://www.goguides.com/history/{domain}", "domain_evaluate": "https://www.goguides.com/evaluate.php?domain={domain}&format=json" }, "crawl_behavior": { "synchronous_fetch": false, "unknown_safe_url": "may be accepted for asynchronous observation", "evaluate_demand_counts_as_url_request_adoption": false }, "identity": { "user_agent_is_verification": false, "signature_agent_is_verification": false, "web_bot_auth": "enabled", "web_bot_auth_protocol": "RFC 9421 HTTP Message Signatures + Web Bot Auth", "web_bot_auth_behavior": "opportunistic; unsigned requests remain supported", "verified_identity_requires_cryptographic_verification": true }, "safety": { "allowed_schemes": [ "http", "https" ], "credentials_in_url": false, "private_or_nonpublic_network_targets": false, "unsupported_ports": false, "redirect_targets_revalidated_by_crawler": true }, "documentation": { "human": "https://www.goguides.com/docs/request-url.html", "openapi": "https://www.goguides.com/docs/openapi.yaml" }, "public_post_acceptance": true, "human_documentation": "https://www.goguides.com/docs/request-url.html", "error_contract": "goguides-public-error-v1" }, "evaluate_batch": { "capability_id": "goguides.evaluate_batch", "api_version": "evaluate-batch-v1", "endpoint": "https://www.goguides.com/evaluate-batch", "methods": [ "GET", "POST" ], "description": "Screen multiple exact URLs through one authoritative GoGuides evaluation service without creating a second score or policy truth path.", "get_compatible": true, "limits": { "get_max_urls": 10, "post_max_urls": 50, "get_max_request_target_bytes": 7000, "post_max_body_bytes": 262144, "max_response_bytes": 1048576, "ip_requests_per_hour": 30, "ip_urls_per_hour": 300, "network_requests_per_hour": 120 }, "semantics": { "same_internal_service_for_get_post": true, "preserves_input_order": true, "explicit_input_index": true, "partial_errors": true, "same_exact_url_authority_as_evaluate": true, "domain_context_remains_root_authority": true }, "adoption": { "batch_demand_is_evaluate_demand": true, "counts_as_url_request_adoption": false }, "safety": { "response_size_limited": true, "global_kill_switch": true, "root_public_policy_is_maximum_boundary": true, "private_or_nonpublic_network_targets": false }, "documentation": { "human": "https://www.goguides.com/docs/evaluate-batch", "openapi": "https://www.goguides.com/docs/openapi.yaml" }, "human_documentation": "https://www.goguides.com/docs/evaluate-batch", "error_contract": "goguides-public-error-v1" }, "change_intelligence": { "capability_id": "goguides.change_intelligence", "api_version": "change-v1", "endpoint": "https://www.goguides.com/changes/{domain}", "method": "GET", "classification_method": "deterministic_ruleset", "classification_version": "change-v1", "truth_scope": "authoritative domain root", "observation_pair": "concrete stored observation rows for the same authoritative root requested URL", "measurements": { "text": "64-bit simhash Hamming distance", "counts": "signed current-minus-previous numeric deltas", "hashes": "equality/difference only", "publisher_declarations": "stored declaration/self-claim projection only when available" }, "states": [ "changed", "unchanged", "unknown", "insufficient_history", "observation_gap" ], "safety": { "subjective_materiality_labels": false, "publisher_intent_inference": false, "synchronous_target_fetch": false, "creates_url_request_adoption": false }, "freshness_maintenance": "Freshness is maintained by GoGuides internally.", "human_documentation": "https://www.goguides.com/docs/change-intelligence", "error_contract": "goguides-public-error-v1" }, "claim_support": { "capability_id": "goguides.claim_support", "api_version": "claim-support-v1", "category": "model_assisted_judgment", "method": "POST", "path": "/claim-support", "source_scope": "one fixed current stored GoGuides source observation", "verdicts": [ "supported", "contradicted", "unaddressed", "insufficient_evidence", "source_unavailable" ], "numeric_confidence": false, "synchronous_target_fetch": false, "explicit_url_request_adoption": false, "cache": "no-store", "human_documentation": "https://www.goguides.com/docs/claim-support", "error_contract": "goguides-public-error-v1" }, "claim_support_feedback": { "capability_id": "goguides.claim_support_feedback", "api_version": "claim-support-feedback-v1", "category": "governance_feedback", "method": "POST", "path": "/claim-support/feedback", "requires": [ "analysis_id", "reason_code" ], "reason_codes": [ "verdict_disputed", "evidence_mismatch", "source_mismatch", "source_stale", "insufficient_context", "analysis_other_issue" ], "deduplication": true, "automatic_verdict_mutation": false, "automatic_source_mutation": false, "automatic_lifecycle_mutation": false, "feedback_is_truth_vote": false, "cache": "no-store", "human_documentation": "https://www.goguides.com/docs/claim-support", "error_contract": "goguides-public-error-v1" }, "claim_support_status": { "capability_id": "goguides.claim_support_status", "api_version": "claim-support-status-v1", "category": "analysis_lifecycle_status", "method": "GET", "path": "/claim-support/status/{analysis_id}", "states": [ "active", "flagged", "superseded", "withdrawn" ], "observational_only": true, "creates_analysis": false, "triggers_reanalysis": false, "triggers_crawl": false, "explicit_url_request_adoption": false, "historical_verdict_rewritten": false, "cache": "no-store", "human_documentation": "https://www.goguides.com/docs/claim-support", "error_contract": "goguides-public-error-v1" }, "content_relationships": { "capability_id": "goguides.content_relationships", "api_version": "content-relationships-v1", "endpoint": "https://www.goguides.com/content-relationships", "methods": [ "GET", "POST" ], "description": "Compare two exact public URLs through the same stored GoGuides evidence authority and return conservative deterministic relationship states with model-assisted evidence restricted to a supporting role.", "request_schema": { "url_a": "first full public HTTP or HTTPS URL", "url_b": "second full public HTTP or HTTPS URL" }, "states": [ "relationship_detected", "near_duplicate_content", "insufficient_evidence" ], "semantics": { "same_normalized_resource": "relationship_detected", "explicit_canonical_relationship": "relationship_detected", "exact_stored_content_hash_match_with_minimum_evidence": "near_duplicate_content", "unusable_surface_or_unaccepted_evidence": "insufficient_evidence", "insufficient_evidence_means_independence": false }, "safety": { "stored_observations_only": true, "synchronous_target_fetch": false, "truth_record_mutation": false, "crawl_queue_mutation": false, "creates_url_request_adoption": false, "semantic_evidence_promotes_relationship": false, "raw_source_text_returned": false, "private_model_scores_returned": false, "ownership_inferred": false, "common_origin_inferred": false, "coordination_inferred": false, "deception_inferred": false, "intent_inferred": false, "publisher_independence_inferred": false }, "documentation": { "human": "https://www.goguides.com/docs/content-relationships", "openapi": "https://www.goguides.com/docs/openapi.yaml" }, "human_documentation": "https://www.goguides.com/docs/content-relationships", "error_contract": "goguides-public-error-v1" } }, "human_developer_hub": "https://www.goguides.com/developers", "human_documentation": { "developer_hub": "https://www.goguides.com/developers", "integration_guide": "https://www.goguides.com/machine-readable-examples", "evaluate": "https://www.goguides.com/docs/evaluate", "batch_evaluate": "https://www.goguides.com/docs/evaluate-batch", "web_state_v3": "https://www.goguides.com/docs/web-state", "change_intelligence_v1": "https://www.goguides.com/docs/change-intelligence", "url_request": "https://www.goguides.com/docs/request-url.html", "claim_support": "https://www.goguides.com/docs/claim-support", "content_relationships_v1": "https://www.goguides.com/docs/content-relationships", "openapi": "https://www.goguides.com/docs/openapi.yaml", "white_paper_v3": "https://www.goguides.com/white-paper" }, "public_error_contract": { "version": "goguides-public-error-v1", "applies_to": "public machine-facing HTTP 4xx responses", "purpose": "Make client errors self-describing so automated consumers can correct requests without guessing.", "response_fields": [ "error_contract", "http_status", "reason_code", "message", "retry_guidance", "required", "required_any_of", "allowed_methods", "example_url", "example_request", "request_template", "documentation", "openapi", "machine_discovery" ], "header": "X-GoGuides-Error-Contract: goguides-public-error-v1", "status_semantics": { "4xx": "Request, access, policy, identifier, request-size, media-type, or rate-limit condition.", "5xx": "Server-side or temporary service failure." }, "examples": { "evaluate_batch_missing_urls": { "http_status": 400, "reason_code": "missing_urls", "working_example_url": "https://www.goguides.com/evaluate-batch?url=https%3A%2F%2Fexample.com%2Fa&url=https%3A%2F%2Fexample.org%2Fb" }, "content_relationships_missing_urls": { "http_status": 400, "reason_code": "missing_required_parameters", "working_example_url": "https://www.goguides.com/content-relationships?url_a=https%3A%2F%2Fexample.com%2F&url_b=https%3A%2F%2Fexample.org%2F" } } } }