API de Odysee
Busca publicaciones, tendencias, canales y etiquetas de Odysee mediante palabras o identificadores públicos. Cada resultado conserva el canal y la URL de la pieza.
Vistas, likes y fecha describen una observación, no un historial. La API no reproduce, descarga ni concede derechos sobre el video o su miniatura.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Odysee, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar publicaciones en Odyseesearch | Busca publicaciones de Odysee mediante keyword, devolviendo canal, descripción, duración y métricas visibles. | $1.39 por 1.000 solicitudes | Normal |
Explorar contenido en tendenciatrending | Obtiene una selección en tendencia sin entrada obligatoria y conserva posición implícita, canal e interacciones observadas. | $1.39 por 1.000 solicitudes | Normal |
Listar publicaciones de un canaluser_posts | Consulta publicaciones del username, con orden opcional, y devuelve metadatos de cada pieza. | $1.39 por 1.000 solicitudes | Normal |
Consultar contenido por etiquetatag | Lee contenido asociado al tag, con sort opcional, distinguiendo publicación y canal. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Odysee?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar publicaciones en Odysee Busca publicaciones de Odysee mediante | keyword | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · duration_sec · view_count · like_count · published_at · media_type · languages · tags · platform |
trendingExplorar contenido en tendencia Obtiene una selección en tendencia sin entrada obligatoria y conserva posición implícita, canal e interacciones observadas. No explica el algoritmo ni mantiene un historial automático. | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · duration_sec · view_count · like_count · published_at · media_type · languages · tags · platform | |
user_postsListar publicaciones de un canal Consulta publicaciones del | username | sort | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · duration_sec · view_count · like_count · published_at · media_type · languages · tags · platform |
tagConsultar contenido por etiqueta Lee contenido asociado al | tag | sort | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · duration_sec · view_count · like_count · published_at · media_type · languages · tags · platform |
¿Qué significan los parámetros de Odysee search?
Busca publicaciones de Odysee mediante keyword, devolviendo canal, descripción, duración y métricas visibles. No reproduce ni descarga el contenido y el lote no es un índice completo.
keywordObligatorio- Palabras clave de video para
search;trendingno requiere palabras clave.searchno admite el parámetrosortde las listas de canales.Odysee: el título mostrado no equivale a la URL del contenido — Odysee distingue claramente entre el `Title`, la `URL` y la `Description` del contenido subido, ya que tienen propósitos diferentes. Los resultados de búsqueda deben conservar el enlace y el título originales, sin deducir la dirección a partir del título; el texto de la descripción tampoco constituye la transcripción completa del vídeo. · Consultada
¿Qué significan los parámetros de Odysee trending?
Obtiene una selección en tendencia sin entrada obligatoria y conserva posición implícita, canal e interacciones observadas. No explica el algoritmo ni mantiene un historial automático.
Referencia completa: parámetros, ejemplos de código, respuesta de ejemplo y salud →Esta acción no tiene parámetros de negocio. Envía únicamente los identificadores de plataforma y acción.
¿Qué significan los parámetros de Odysee user_posts?
Consulta publicaciones del username, con orden opcional, y devuelve metadatos de cada pieza. No incluye contenido no público ni garantiza todo el archivo del canal.
usernameObligatorio- Para
user_posts, es el nombre del canal. Puedes escribirname,@nameo un enlace de canal de Odysee que contenga@name. Se usa el nombre del canal y se descarta el identificadorclaimque va después de los dos puntos. Para la localización precisa de canales con el mismo nombre, debes verificar el resultado devuelto.Odysee: nombre de canal e identificador Claim — Odysee explica que la parte situada tras los dos puntos en una URL identifica un Claim concreto y permite distinguir nombres iguales. Si la entrada elimina esa parte, no debe presentarse como resolución exacta del Claim. · Consultada sortOpcional- Orden para
user_postsytag:newestpor fecha de publicación,popularpor un indicador de orden relacionado con el importe de apoyo al contenido.popularno equivale al mayor número de reproducciones o «me gusta».Valores permitidos:newestpopular
¿Qué significan los parámetros de Odysee tag?
Lee contenido asociado al tag, con sort opcional, distinguiendo publicación y canal. La etiqueta no certifica el tema ni convierte la selección en tendencia global.
tagObligatorio- Para
tag, es la etiqueta de contenido, con o sin el#inicial. Lista el contenido por etiqueta, lo que no es equivalente a una búsqueda por palabras clave de texto completo.Odysee: etiquetas de contenido, etiquetas de control y ajustes de idioma — Odysee separa las etiquetas temáticas de aquellas que controlan la interacción, y clasifica el idioma del contenido y la licencia de derechos de autor como ajustes distintos. Los campos `tags` y `languages` devueltos por esta API solo describen la información obtenida realmente; no implican que se ofrezcan funciones de subida, control de interacción, traducción o permisos para republicar el contenido. · Consultada sortOpcional- Orden para
user_postsytag:newestpor fecha de publicación,popularpor un indicador de orden relacionado con el importe de apoyo al contenido.popularno equivale al mayor número de reproducciones o «me gusta».Valores permitidos:newestpopular
Cómo usar la API de Odysee
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"odysee","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Odysee
¿Cómo llamo a la API de Odysee?
Envía POST /api/v1/social con platform igual a odysee, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Odysee?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, description, channel_name y channel_id. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Odysee?
Odysee explica que la parte situada tras los dos puntos en una URL identifica un Claim concreto y permite distinguir nombres iguales. Si la entrada elimina esa parte, no debe presentarse como resolución exacta del Claim.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; trending no requiere parámetros obligatorios; user_posts requiere username; consulta las demás acciones en la lista de funciones.
¿Las acciones de Odysee responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.