Public GDF URLs

Every guide and item has stable machine URLs on the same host as the human reader.

Resource Canonical path File-style alias
Whole guide /g/{slug}/gdf /g/{slug}.gdf
One item /g/{slug}/{item_id}/gdf /g/{slug}/{item_id}.gdf
Human page /g/{slug}/{legacy_id} -

Item ids: use GDF form item-701220 or legacy numeric 701220 (same item).

Query formats (guide-level only):

  • Default: GDF JSON (application/vnd.guides.gdf+json)
  • ?format=jsonl - one chunk per page (RAG)
  • ?format=plaintext - benchmark fallback only

Each exported item includes metadata.co.guides.gdf_url, gdf_file_url, canonical_url, and api_url.