Content Enrichment API
What You Can Do
Get Enriched Hotels
getEnrichedHotel, page through your full set with listEnrichedHotels, and each hotel arrives ready to render, with its structured details, localized texts, and imagery.ExternalHotelID selector using productid (the hotel's id in your own product system, the identifier you use internally) or giata, with no pre-mapping to our ids needed. Our direct selectors HotelID and GlobalHotelID stay available whenever you already hold them.ExternalHotelIDs filter, a list of selector groups that is resolved to the matching hotels, so you can pull exactly your set of hotels by your own codes in one call.ID and GlobalHotelID plus the ExternalHotelIDs map of external ids as strings, today "ProductID" (the hotel's id in your own product system, the identifier you use internally, stored per project when a mapping exists) and "Giata" (when the hotel has one). The map is extensible, so read the keys you need and ignore the rest.ExternalHotelID and receive ExternalHotelIDs, the same concept in both directions.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
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.Analyze Your Own Images
Generate Text
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.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
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 Content Enrichment Works
GTCodes), including free-of-charge qualifiers (IsFree), so your integration filters and renders without per-hotel special cases.AI-Generated Content Marking
Compliance envelope, on each generated text cell and on every image. Alongside its Text, each entry in GeneratedTexts (hotel-level and per-room) carries the envelope, and each entry in Images carries the identical one.INFO
Compliance is deliberately an object rather than a bare AIGenerated boolean, because future markers will arrive as new keys inside this envelope. Check for the specific key you need (Compliance.AIGenerated) rather than matching the whole object, and future obligations will not break your integration.How Text Generation Flows
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
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.integrations@ygo.ai.Modified at 2026-09-14 07:25:30