Respuestas instantáneas

Última actualización July 20, 2026

Calcula una respuesta instantánea — calculadora, conversión de unidades y divisas, hora mundial, definiciones de diccionario, hashes, códigos QR y más de dos docenas de familias — por completo en Suede: cero llamadas externas, la pregunta nunca llega a un tercero.

Code

GET /v1/answers?q=100+usd+a+eur
Authorization: Bearer suede_live_…

Incluido con la membresía por defecto: las llamadas aparecen en /v1/usage bajo requests con 0 billable_units y no consumen créditos. (La plataforma puede pasar a facturación — 1 unidad por llamada, como la búsqueda; entonces aplican las cabeceras X-Credits-* e insufficient_credits.)

Parámetros

Param	Requerido	Significado
`q`	sí	La pregunta. Hasta 512 caracteres.
`hl`	no	El idioma de análisis: `en`, `ar`, `de`, `es`, `fr`, `ja`. Valores desconocidos caen a `en`. `3,5 km a mi` se analiza con `hl=es` (los formatos numéricos siguen el idioma).
`gl`	no	Sesgo regional para respuestas que dependen de la región.

La respuesta

answered: false (con HTTP 200) es el resultado común y correcto — la mayoría de consultas son búsquedas web. Cuando answered es true, answer contiene:

kind — la familia (calculator, currency, time_zone, definitions, …). Pueden añadirse familias nuevas sin cambio de versión: trata las desconocidas como una tarjeta genérica.
primary, expression, secondary, items[] — el contenido de la tarjeta, formato invariante.
Identificadores estables — primary_label, items[].label, disclosure.key (y primary cuando primary_is_key es true) son identificadores answers.* estables: nunca se renombran; pueden aparecer nuevos.
copy_text — la forma máquina (número, instante ISO, digest); null ⇒ usa primary.
svg — SVG en línea para familias visuales (QR, muestra de color). Aíslalo como imagen no fiable.
is_error — una TARJETA de error (división por cero): respondida, con el diagnóstico en primary_label (answers.err.*).
timezone — el modelo de reloj mundial para kind: time_zone: filas por lugar (zona, hora y fecha locales, desfase UTC, horario de verano, día/noche, desfase de fecha, próximo cambio) más un meeting_strip de 24 caracteres (n noche, d día, b horario laboral).
definitions — el modelo de diccionario para kind: definitions: lema, IPA, acepciones por categoría gramatical, con source_url + license (CC BY-SA 4.0 — muestra o enlaza la fuente al presentar este contenido). Las entradas árabes llevan por ahora definiciones en inglés (gloss_lang: "en").

Conviene saber:

client_info describe al llamante de la API — tu servidor, no tu usuario final.
Las divisas usan los tipos de referencia del BCE; disclosure lleva la fecha del tipo. Solo informativo.
Los temporizadores son un widget web y nunca responden por la API.

Aplican los límites de velocidad habituales. El esquema completo está en el documento OpenAPI.