La documentación para desarrolladores está en inglés.
Docs
Card types
A matched answer usually carries one of these cards in card.type, with data that follows the card's JSON Schema. card is null when the best type isn't in your accept list, and new types can appear: show text for any card you don't render.
card.type | Used for | Layouts |
|---|---|---|
quick_answer | One value with context: math, conversions, dice, countdowns, clocks, distances, short facts, weather advice. data.kind names which. | full, glance |
translation | A phrase in another language, with transliteration and alternatives. | full, glance |
definition | A word with pronunciation, senses, examples and origin. | full, glance |
weather.forecast | Current conditions, the next hours and the next days. data.focus says which part was asked about. | full, glance, strip, table, chart, headline |
sun_moon | Sunrise, sunset, daylight and moon phase for a place and date. | full, glance |
nutrition.facts | Energy and nutrients for a food and serving, with alternative servings. | full, label, glance, macros |
recipe | Ingredients and steps; steps may carry timers. | full, glance |
timer | A countdown the client runs. Comes with a timer.start action. | full, glance |
comparison | Two or more subjects compared row by row. | full, glance |
quiz | One multiple-choice question with the answer key, so the client grades locally. The next question, and the grading of the reply, come when the user's reply follows our question's text unchanged; the last answer, or stopping, is a text-only answer (with the score once a question was answered). | full |
gallery | Licensed images with credits. | full, glance |
audio | Live radio, a podcast episode or a sound. | full, strip |
video | A video or music video with provider and id. | full, glance |
snippet | A joke, fun fact, quote, affirmation or life hack. | full, glance |
on_this_day | Historical events and observances for a date. | full, glance |
movies | A list of films. | full, glance |
Not answered yet: the API sends no quiz or movies cards for now, and such questions come back matched: false (not billed). Both types stay in the contract, so handle them like any other type, or show text.
How the catalog is cut: a new type when the data shape differs; a new layout when only the presentation differs; a new kind when only the meaning differs.
Times inside card data are ISO 8601 with the location's offset, or local HH:MM where the schema says so. Values a source does not provide are null, never guessed: MET Norway, for example, gives precipitation amounts but no probabilities outside the Nordics. Amounts follow the card's own units (weather.forecast reports precipitation in units.precipitation).