Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.geogen.io/llms.txt

Use this file to discover all available pages before exploring further.

Citations are the external links LLMs reference when answering prompts. The CLI exposes both the aggregated top-domains view and per-domain URL drill-downs.

geogen citations list

Top cited domains for an entity. Maps to GET /v1/entities/citations.
geogen citations list --entity ent_123 --period 30d --limit 20
Options:
FlagDescription
--entity <id>Entity ID (required)
--period <period>7d, 14d, or 30d
--start-date <iso> / --end-date <iso>Custom date range
--models <uuids>Comma-separated model UUIDs
--tags <ids>Comma-separated tag IDs
--prompt-ids <ids>Comma-separated prompt IDs
--limit <n>Max results
--offset <n>Pagination offset
The result includes a uuid for each cited domain. Use that with citations details to drill in.

geogen citations details

Show exact URLs LLMs cited on a specific domain. Maps to GET /v1/entities/citations/details.
geogen citations details \
  --entity ent_123 \
  --cited <citedEntityUuid> \
  --period 30d \
  --limit 50
FlagDescription
--entity <id>Entity ID (required)
--cited <uuid>Cited domain UUID from citations list (required)
--period <period>7d, 14d, or 30d
--start-date <iso> / --end-date <iso>Custom date range
--models <uuids>Comma-separated model UUIDs
--limit <n>Max results
--offset <n>Pagination offset

Pipeline example

# Top cited domain → drill into its URLs
TOP_UUID=$(geogen --json citations list --entity ent_123 --limit 1 | jq -r '.data[0].citedEntityUuid')
geogen citations details --entity ent_123 --cited "$TOP_UUID"