# info.summary
Public read-only preference, ranking, entity, graph and evidence API.

# info.description
Machine-readable EnFavori community preference data. Vote interactions are preference signals, not star ratings and not a claim of statistical representativeness.

# tags[].description
Gateway readiness, freshness and contract health.

# tags[].description
Machine-readable public entity identity, preference evidence, dedicated verification state and action discovery.

# tags[].description
Canonical, user-confirmed action discovery for public EnFavori entities.

# tags[].description
Read-only deterministic tools for AI agents. No LLM execution occurs in this gateway.

# tags[].description
Authenticated aggregate EnFavori Preference Intelligence derived from historical ranking snapshots.

# paths./.get.responses.200.headers.Link.description
Service description/documentation and, for resource endpoints, canonical links.

# paths./catalog.get.responses.200.headers.Link.description
Service description/documentation and, for resource endpoints, canonical links.

# paths./lists/{selector}.get.summary
Get one published ranking by slug or permanent list UID

# paths./lists/{selector}.get.parameters[].description
Published list slug or permanent ef_list_* UID.

# paths./lists/{selector}.get.responses.200.description
Ranking resource with history, graph and evidence

# paths./lists/{selector}.get.responses.200.headers.Link.description
Service description/documentation and, for resource endpoints, canonical links.

# paths./entities/{uid}.get.responses.200.headers.Link.description
Service description/documentation and, for resource endpoints, canonical links.

# paths./changes.get.description
Use since for time filtering and cursor for stable forward pagination. A snapshot may exist even when the ranking did not change; inspect changed_from_previous when present.

# paths./changes.get.parameters[].description
ISO-8601 timestamp. Only snapshots captured at or after this time are returned.

# paths./changes.get.parameters[].description
Opaque cursor returned by the previous response.

# paths./changes.get.responses.200.headers.Link.description
Service description/documentation and, for resource endpoints, canonical links.

# paths./changes.get.responses.422.description
One or more query parameters are invalid.

# paths./status.get.summary
Get AI Data Gateway readiness and freshness status

# paths./status.get.description
Returns 200 when the gateway is readable (operational or degraded) and 503 only when critical read dependencies are unavailable.

# paths./status.get.responses.200.description
Gateway is operational or degraded but still readable.

# paths./status.get.responses.503.description
Critical gateway dependency is unavailable.

# paths./passports/{uid}.get.summary
Get the public AI Business Passport for one permanent entity

# paths./passports/{uid}.get.description
Passport existence never implies verification. verified_business=true is returned only when a separate, current EnFavori entity verification record exists. Publisher, sponsor and payment state do not create verification and do not affect organic ranking.

# paths./passports/{uid}.get.parameters[].description
Permanent EnFavori entity UID for a supported public business, accommodation, product, service or place entity.

# paths./passports/{uid}.get.responses.200.headers.Last-Modified.description
Latest observed public source/snapshot/action freshness timestamp when available.

# paths./passports/{uid}.get.responses.200.headers.Link.description
Canonical, service description and documentation links.

# paths./passports/{uid}.get.responses.404.description
Entity is missing, unsupported, inactive or not public.

# paths./actions/{uid}.get.summary
Get attribution-aware action handoffs for one public entity

# paths./actions/{uid}.get.description
Returns call, WhatsApp, website, quote, reservation, buy, affiliate and hotel-booking actions when supported by first-party EnFavori data. Targets are signed attribution handoffs. Opening a handoff records intent, not a confirmed sale or reservation. Every action requires user confirmation; this endpoint never executes a purchase or reservation.

# paths./actions/{uid}.get.parameters[].description
Permanent EnFavori entity UID for a supported public business, accommodation, product, service or place entity.

# paths./actions/{uid}.get.responses.200.description
Canonical EnFavori Action Layer document with source-aware handoffs.

# paths./actions/{uid}.get.responses.404.description
Entity is missing, unsupported, inactive or not public.

# paths./agent/tools.get.responses.404.description
Requested public resource was not found.

# paths./agent/tools.get.description
Returns tool names, arguments, trust boundaries and read-only access semantics.

# paths./agent/search.get.responses.404.description
Requested public resource was not found.

# paths./agent/search.get.parameters[].description
Search text matched against entity name, slug or UID.

# paths./agent/entities/{uid}.get.responses.404.description
Requested public resource was not found.

# paths./agent/actions/{uid}.get.summary
Get safe action targets for one public entity

# paths./agent/actions/{uid}.get.responses.404.description
Requested public resource was not found.

# paths./agent/actions/{uid}.get.description
Returns canonical Action Layer discovery only. User confirmation is required and the gateway never autonomously purchases or books.

# paths./agent/rankings/{selector}.get.responses.404.description
Requested public resource was not found.

# paths./agent/rankings/{selector}.get.parameters[].description
Published list slug or permanent list UID.

# paths./agent/evidence/{selector}.get.responses.404.description
Requested public resource was not found.

# paths./agent/evidence/{selector}.get.parameters[].description
Published list slug or permanent list UID.

# paths./agent/trends/{selector}.get.responses.404.description
Requested public resource was not found.

# paths./agent/trends/{selector}.get.parameters[].description
Published list slug or permanent list UID.

# paths./agent/compare.get.summary
Compare factual public data for two to five entities

# paths./agent/compare.get.responses.404.description
Requested public resource was not found.

# paths./agent/compare.get.parameters[].description
Comma-separated permanent entity UIDs. Maximum five.

# paths./agent/compare.get.description
Does not declare a winner across unrelated lists and does not generate an AI score.

# paths./agent/changes.get.responses.404.description
Requested public resource was not found.

# paths./commercial/insights/overview.get.summary
Get aggregate Preference Intelligence overview

# paths./commercial/insights/overview.get.description
Current aggregate snapshot facts plus observed first-to-latest changes within the requested period.

# paths./commercial/insights/overview.get.responses.403.description
Inactive, expired or insufficient-scope client.

# paths./commercial/insights/momentum.get.summary
Get observed rising and falling preference movements

# paths./commercial/insights/momentum.get.description
Ranks entity/list pairs by observed historical rank and net-score change. Direction is determined by rank change first, then net-score change when rank is flat. This is not a prediction or AI score.

# paths./commercial/insights/momentum.get.parameters[].description
Permanent category or country/province/district UID used to limit the observed list set.

# paths./commercial/insights/momentum.get.responses.403.description
Inactive, expired or insufficient-scope client.

# paths./commercial/insights/segments.get.summary
Get aggregate category or list-location segments

# paths./commercial/insights/segments.get.description
Aggregates current snapshot facts and observed interaction change by Preference Graph category or list location scope.

# paths./commercial/insights/segments.get.responses.403.description
Inactive, expired or insufficient-scope client.

# paths./commercial/insights/lists/{selector}.get.summary
Get one list historical trend and largest observed item movements

# paths./commercial/insights/lists/{selector}.get.description
Returns immutable snapshot timeline plus first-to-latest vote changes and observed item movement.

# paths./commercial/insights/lists/{selector}.get.parameters[].description
Permanent list UID, list slug or source list ID.

# paths./commercial/insights/lists/{selector}.get.responses.403.description
Inactive, expired or insufficient-scope client.

# components.securitySchemes.CommercialBearer.description
Commercial API keys are issued by EnFavori. Client credential storage contains only a prefix and SHA-256 token hash.

# externalDocs.description
EnFavori AI Data Gateway developer documentation