Content Enrichment API

The Content Enrichment API delivers rich, ready-to-use hotel content -- structured details, localized marketing texts, imagery, and more -- through a single, consistent interface. Your hotels arrive already enriched and accurate, so you can put high-quality content in front of travelers without building and maintaining your own content operation.

What You Can Do

The API gives you three things: read your enriched hotels, manage the templates that shape your marketing texts, and generate that text on demand.

Get Enriched Hotels

Retrieve your enriched hotel content whenever you need it. Fetch a single hotel by id with getEnrichedHotel or page through your full set with listEnrichedHotels. Each hotel comes back with its structured details, localized texts, and imagery ready to render.

Use getContentSettings to read your project's content configuration, such as the locales available to you, so your integration always knows what to expect.

Manage Text Templates

Your marketing texts are produced from templates that you control. Use listTextTemplates to see your current templates and saveTextTemplate to create or update one. Templates let you shape tone, structure, and emphasis so generated descriptions match your brand and surface the details that matter to your audience.

Generate Text

Produce localized marketing text from your templates in two ways.

Generate asynchronously -- Call generateText to start a generation job. It returns immediately with an id, and you poll getTextGenerationStatus with that id until the job is done. This pattern keeps long-running generation off your request path and scales cleanly across many hotels.

Preview synchronously -- Call previewText to generate and return text in a single request. Use it to review the output of a template before you commit to a full generation run.

TIP

Preview, then generate

Use previewText to iterate on a template and confirm the result reads the way you want. Once you are satisfied, run generateText to apply it at scale.

How Text Generation Flows

A typical text workflow ties the three capabilities together: shape a template with saveTextTemplate, confirm the result with previewText, then kick off generateText and poll getTextGenerationStatus until it reports completion. From there, read the finished content back with getEnrichedHotel or listEnrichedHotels.

INFO

Asynchronous by design

generateText returns an id rather than the finished text. Poll getTextGenerationStatus with that id until the job completes, then retrieve the hotel to read the generated content.

Next Steps

The OpenAPI reference in this section documents every operation, request, and response in detail, grouped by capability:

Enrichment -- getEnrichedHotel and listEnrichedHotels.

Settings -- getContentSettings.

Text Generation -- generateText, getTextGenerationStatus, and previewText.

Templates -- listTextTemplates and saveTextTemplate.

See the OpenAPI specs for request and response details. Need help? Reach our integration team at integrations@ygo.ai.

What You Can Do#

Get Enriched Hotels#

Manage Text Templates#

Generate Text#

How Text Generation Flows#

Next Steps#

What You Can Do

Get Enriched Hotels

Manage Text Templates

Generate Text

How Text Generation Flows

Next Steps