{
  "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."
    },
    "domain_evaluation": {
      "url": "https://www.goguides.com/evaluate.php?domain=goguides.com&format=json",
      "format": "json",
      "purpose": "Authoritative root/domain trust evaluation. Eligible machine evaluation may generate asynchronous domain discovery or throttled freshness demand when appropriate."
    },
    "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."
    },
    "verified_text_lookup": {
      "url": "https://www.goguides.com/verified-text.php?q=gravity&format=json",
      "format": "json",
      "purpose": "Topic lookup across verified-text records."
    },
    "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."
    },
    "trust_profile": {
      "url": "https://www.goguides.com/profile/goguides.com",
      "format": "html",
      "purpose": "Public trust profile for a domain."
    },
    "history_record": {
      "url": "https://www.goguides.com/history/goguides.com",
      "format": "html",
      "purpose": "Public domain history record."
    },
    "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": "eligible reads may contribute to throttled asynchronous freshness maintenance",
        "creates_url_request_adoption": false
      },
      "materiality": {
        "subjective_severity_label": false,
        "reason": "V1 exposes mechanical measurements without unsupported major/minor/material rewrite judgments."
      }
    },
    "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 into the protected GoGuides crawler pipeline.",
      "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"
    },
    "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 full public page observation plus compact root/domain context. When an eligible machine lookup requests an unknown exact page, GoGuides asynchronously ensures both the authoritative domain root and the requested exact URL are scheduled for crawl. Ordinary non-machine reads do not create crawl work."
    },
    "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,
        "deduplicates_internal_work": true,
        "max_response_bytes": 1048576
      },
      "crawl_behavior": {
        "synchronous_fetch": false,
        "eligible_machine_miss": "Evaluate demand may asynchronously schedule authoritative root plus requested exact URL",
        "counts_as_url_request_adoption": false,
        "queue_misses_per_batch": 5,
        "global_queue_misses_per_hour": 500
      },
      "documentation": "https://www.goguides.com/docs/evaluate-batch.html"
    },
    "claim_support": {
      "method": "POST",
      "url": "https://www.goguides.com/claim-support",
      "capability_id": "goguides.claim_support",
      "api_version": "claim-support-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"
    },
    "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"
    }
  },
  "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"
      }
    },
    "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. Eligible reads may contribute to throttled asynchronous freshness maintenance; 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.",
      "Multiple requests for the same target may share one existing crawler job; request intent and crawler work are separate.",
      "The caller never writes an authoritative GoGuides truth record directly.",
      "When crawl-on-miss succeeds, the normal GoGuides crawler pipeline 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.",
      "Eligible machine misses remain Evaluate demand and never become explicit /request-url adoption."
    ],
    "canonical_batch_evaluate_documentation": "https://www.goguides.com/docs/evaluate-batch.html"
  },
  "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.html",
      "format": "html",
      "purpose": "Human- and machine-crawlable Batch Evaluate contract with GET and POST examples."
    }
  },
  "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 into the protected GoGuides crawler pipeline.",
      "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,
        "known_url_crawl": false,
        "unknown_safe_url": "protected crawl-on-miss",
        "dedupe": true,
        "priority_protected": true,
        "evaluate_exact_url_machine_miss": "eligible machine miss asynchronously schedules authoritative domain root plus requested exact URL",
        "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
    },
    "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,
        "queue_misses_per_batch": 5,
        "global_queue_misses_per_hour": 500
      },
      "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.html",
        "openapi": "https://www.goguides.com/docs/openapi.yaml"
      }
    },
    "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": "throttled_asynchronous"
    },
    "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"
    },
    "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"
    },
    "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"
    }
  }
}