Te recomendamos que uses content_description para las funciones de accesibilidad del usuario.
itemurl
string
Es la URL completa para ver la publicación en tenor.com.
hascaption
boolean
Devuelve true si esta publicación contiene subtítulos.
flags
string
Lista separada por comas para indicar si el contenido es una calcomanía o una imagen estática, si tiene audio o si es cualquier combinación de estos elementos. Si no están presentes sticker y static, el contenido es un GIF. Un campo flags en blanco significa que el GIF no tiene audio.
bg_color
string
El color de píxel de fondo más común del contenido
url
string
Es una URL corta para ver la publicación en tenor.com.
Objeto Category
En la siguiente tabla, se proporcionan detalles sobre las propiedades de los objetos de categoría:
Propiedades
searchterm
string
Es el término de búsqueda que corresponde a la categoría. El término de búsqueda se traduce para que coincida con el locale de la solicitud correspondiente.
path
string
Es la URL de búsqueda que se solicitará si el usuario selecciona la categoría.
image
string
URL de la fuente de contenido multimedia del GIF de ejemplo de la categoría
name
string
Es el nombre de la categoría que se superpondrá en la imagen. El nombre se traduce para que coincida con el locale de la solicitud correspondiente.
Objeto de medios
En la siguiente tabla, se proporcionan detalles sobre las propiedades de los objetos multimedia:
Propiedades
url
string
URL de la fuente de contenido multimedia
dims
int[]
Ancho y altura del contenido multimedia en píxeles
duration
float
Representa el tiempo en segundos de un bucle del contenido. Si el contenido es estático, la duración se establece en 0.
size
int
Tamaño del archivo en bytes
Formatos de contenido
La API de Tenor ofrece los siguientes cinco formatos básicos en una variedad de tamaños:
GIF
MP4
WebM
WebP transparente
GIF transparente
Los formatos MP4 y WebM reproducen el clip solo una vez, con la excepción de loopedmp4, que lo reproduce varias veces. El formato GIF reproduce su clip en un bucle continuo. Los formatos transparentes son para el contenido de calcomanías y no están disponibles en los resultados de la búsqueda de GIFs.
Tipos de formato
En la siguiente tabla, se proporcionan detalles sobre los tipos de formatos de medios disponibles para Tenor:
Tipos de formato
preview
Resolución y tamaño: Formato GIF de un solo fotograma de alta calidad; más pequeño que el formato GIF
Dimensiones: Dimensiones de carga originales (sin límites)
Notas de uso: Haz que este sea el primer fotograma del contenido. Está diseñada para usarse como vista previa de la miniatura.
Este formato es compatible con GIFs y calcomanías.
gif
Resolución y tamaño: Formato GIF de alta calidad; el tamaño de archivo más grande disponible
Dimensiones: Dimensiones de carga originales (sin límites)
Notas de uso: Usa este tamaño para compartir GIFs en computadoras.
Este formato es compatible con GIFs y calcomanías.
mediumgif
Resolución y tamaño: Se redujo ligeramente el tamaño del formato GIF.
Dimensiones: Dimensiones de carga originales (sin límites), pero con una tasa de compresión mucho más alta
Notas de uso: Usa este tamaño para las vistas previas de GIF en computadoras.
Este formato es compatible con GIFs y calcomanías.
tinygif
Resolución y tamaño: Se redujo el tamaño del formato GIF.
Dimensiones: Hasta 220 píxeles de ancho. Altura ajustada para conservar la relación de aspecto.
Notas de uso: Usa este tamaño para las vistas previas y el uso compartido de GIFs en dispositivos móviles.
Este formato es compatible con GIFs y calcomanías.
nanogif
Resolución y tamaño: El tamaño más pequeño del formato GIF
Dimensiones: Hasta 90 píxeles de alto El ancho se ajusta para conservar la relación de aspecto.
Notas de uso: Usa este tamaño para las vistas previas de GIF en dispositivos móviles.
Este formato es compatible con GIFs y calcomanías.
mp4
Resolución y tamaño: Es el formato de video de mayor calidad y el más grande de los formatos de video, pero más pequeño que el GIF.
Dimensiones: Similar a los GIFs, pero con relleno para ajustarse a las especificaciones del contenedor de video, que suelen ser incrementos de 8 píxeles.
Notas de uso: Usa este tamaño para las vistas previas y el contenido compartido en MP4 en computadoras.
Este formato es compatible con GIFs y calcomanías.
loopedmp4
Resolución y tamaño: Es el formato de video de mayor calidad y tiene un tamaño mayor que el MP4.
Dimensiones: Similar a los GIFs, pero con relleno para ajustarse a las especificaciones del contenedor de video, que suelen ser incrementos de 8 píxeles.
Notas de uso: Usa este tamaño para los videos compartidos en formato MP4 cuando quieras que el clip de video se ejecute varias veces en lugar de solo una.
Este formato es compatible con GIFs y calcomanías.
tinymp4
Resolución y tamaño: Tamaño reducido del formato MP4
Dimensiones: Ancho y altura variables, con un cuadro delimitador máximo de 320 × 320 píxeles
Notas de uso: Usa este tamaño para las vistas previas y el contenido compartido en formato MP4 en dispositivos móviles.
Este formato es compatible con GIFs y calcomanías.
nanomp4
Resolución y tamaño: El tamaño más pequeño del formato MP4
Dimensiones: Ancho y alto variables, con un cuadro delimitador máximo de 150 x 150 píxeles
Notas de uso: Usa este tamaño para las vistas previas en MP4 en dispositivos móviles.
Este formato es compatible con GIFs y calcomanías.
webm
Resolución y tamaño: Formato de video de menor calidad y tamaño que el MP4
Dimensiones: Similar a los GIFs, pero con relleno para ajustarse a las especificaciones del contenedor de video, que suelen ser incrementos de 8 píxeles.
Notas de uso: Usa este tamaño para las vistas previas y el contenido compartido de WebM en computadoras.
Este formato es compatible con GIFs y calcomanías.
tinywebm
Resolución y tamaño: Tamaño reducido del formato WebM
Dimensiones: Ancho y alto variables, con un cuadro delimitador máximo de 320 × 320 píxeles
Notas de uso: Usa este tamaño para compartir GIFs en dispositivos móviles.
Este formato es compatible con GIFs y calcomanías.
nanowebm
Resolución y tamaño: El tamaño más pequeño del formato WebM
Dimensiones: Ancho y alto variables, con un cuadro delimitador máximo de 150 x 150 píxeles
Notas de uso: Usa este tamaño para las vistas previas de GIF en dispositivos móviles.
Este formato es compatible con GIFs y calcomanías.
webp_transparent
Resolución y tamaño: Formato de calcomanía WebP de alta calidad; el tamaño de archivo más grande disponible
Dimensiones: Dimensiones de carga originales (sin límites)
Notas de uso: Usa este tamaño para compartir calcomanías con usuarios que tengan un ancho de banda alto.
Este formato es compatible con las calcomanías.
tinywebp_transparent
Resolución y tamaño: Tamaño reducido del formato de calcomanía WebP; tamaño máximo de 500 KB
Dimensiones: Hasta 220 × 220 píxeles, con la altura ajustada para conservar la relación de aspecto.
Notas de uso: Usa este tamaño para las vistas previas de calcomanías para los usuarios con un ancho de banda alto y para los recursos compartidos para los usuarios con un ancho de banda bajo.
Este formato es compatible con las calcomanías.
nanowebp_transparent
Resolución y tamaño: El tamaño más pequeño del formato de calcomanía WebP; tamaño máximo de 100 KB
Dimensiones: Hasta 90 x 90 píxeles, con el ancho ajustado para conservar la proporción de aspecto.
Notas de uso: Usa este tamaño para las vistas previas de calcomanías para los usuarios con poco ancho de banda.
Este formato es compatible con las calcomanías.
gif_transparent
Resolución y tamaño: Formato de calcomanía en GIF de alta calidad; el tamaño de archivo más grande disponible
Dimensiones: Dimensiones de carga originales (sin límites)
Notas de uso: Usa este tamaño para compartir calcomanías con usuarios que tengan un ancho de banda alto.
Este formato es compatible con las calcomanías.
tinygif_transparent
Resolución y tamaño: Tamaño reducido del formato de calcomanía en GIF; tamaño máximo de 500 KB
Dimensiones: Hasta 220 × 220 píxeles, con la altura ajustada para conservar la relación de aspecto.
Notas de uso: Usa este tamaño para las vistas previas de calcomanías para los usuarios con un ancho de banda alto y para los recursos compartidos para los usuarios con un ancho de banda bajo.
Este formato es compatible con las calcomanías.
nanogif_transparent
Resolución y tamaño: Tamaño más pequeño del formato de calcomanía en GIF; tamaño máximo de 100 KB
Dimensiones: Hasta 90 x 90 píxeles, con el ancho ajustado para conservar la proporción de aspecto.
Notas de uso: Usa este tamaño para las vistas previas de calcomanías para los usuarios con poco ancho de banda.
Este formato es compatible con las calcomanías.
Prácticas recomendadas
En el caso de los dispositivos móviles, usa los archivos de tamaño nano o muy pequeño para las vistas previas y los archivos de tamaño muy pequeño para los recursos compartidos.
Establece el parámetro media_filter en los formatos que deseas usar. Esto puede reducir el tamaño de la respuesta de la API en un 70%.
Tamaños de formato
El tamaño de archivo de cada formato de contenido depende de las dimensiones y la duración del GIF específico seleccionado. Por lo tanto, considera las medias y las medianas que se proporcionan en la siguiente tabla como lineamientos generales y no como valores exactos.
Formato de archivo
Tamaño medio del archivo (KB)
Mediana del tamaño del archivo (KB)
gif
3,356
956
mediumgif
2,548
574
tinygif
521
101
nanogif
175
56
mp4
207
91
loopedmp4
515
228
tinymp4
84
81
nanomp4
37
28
webm
76
61
tinywebm
57
45
nanowebm
35
25
webp_transparent
530
95
tinywebp_transparent
249
60
nanowebp_transparent
107
25
gif_transparent
643
35
tinygif_transparent
349
20
nanogif_transparent
116
10
Códigos de respuesta
En la siguiente tabla, se proporcionan los códigos de respuesta de estado HTTP que se usan para indicar una solicitud exitosa:
Código de estado HTTP
200 o 202
Aceptar
Errores
La API de Tenor devuelve errores con los códigos de respuesta HTTP 4xx o 5xx y en el formato de error estándar de la API de Google. Para obtener más información, consulta Errores.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-07-25 (UTC)"],[],["The Tenor API uses JSON response objects, including Response, Category, and Media objects. Response objects contain properties like `id`, `created`, `media_formats`, and `tags`. Category objects have `searchterm`, `path`, `image`, and `name`. Media objects hold `url`, `dims`, `duration`, and `size` data. The API supports GIF, MP4, WebM, and transparent WebP/GIF formats, offering various sizes (e.g., nano, tiny, medium). Format sizes and best practices are detailed, and success is indicated by HTTP status codes 200 or 202, with errors using 4xx or 5xx codes.\n"]]
