Bonafide APIs — FAQ JSON Feed

Schema.org JSON-LD FAQ ingestion contract.

1. Overview

The Bonafide APIs expose per-business-entity FAQ content as Schema.org JSON-LD for partner ingestion. Partners consume this feed to power FAQ-rich result eligibility, AI-overview surfacing, and on-page structured-data embedding across their portfolio. The integration target is a single endpoint that returns either:

• a bulk @graph envelope covering an entire hotel BusinessEntity (e.g. an entire hotel brand), or
• a bare QAPage envelope for a single hotel property.

The endpoint infers which shape to return from the supplied entityId — there is no separate URL per shape. Responses are deterministic for a given backing dataset and carry a weak ETag so polling ingestion can use conditional requests. The shape mirrors what Google, Bing, and the major LLM crawlers ingest for QAPage structured data, so the same payload that drives your CMS embeds is also valid for direct search-console submission.

Contents

1. Overview
2. Base URL
3. Authentication
4. Endpoint — FAQ JSON-LD feed
   • 4A. Endpoint — Brand property list
5. Response schemas
6. Worked example
7. Error envelopes
8. Caching, ETags & rate limits
9. Implementation guidance
10. Versioning & change policy
11. Contact & escalation