API de Tumblr
Busca posts y etiquetas de Tumblr y consulta publicaciones o perfiles públicos de un blog. Palabra, tag y nombre de usuario identifican colecciones diferentes.
Notas y fecha describen el post observado; no equivalen a audiencia o alcance. Blogs privados, borradores y mensajes quedan fuera del alcance público.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Tumblr, 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 posts en Tumblrsearch | Busca posts de Tumblr mediante keyword y tipo opcional, devolviendo autor, texto, formato y notas visibles. | $1.39 por 1.000 solicitudes | Normal |
Consultar publicaciones por etiquetatag | Consulta publicaciones de tag, con alias compatibles y filtro de tipo. | $1.39 por 1.000 solicitudes | Normal |
Listar posts de un bloguser_posts | Obtiene posts públicos del username, con tipo opcional, y conserva autor y fecha por pieza. | $1.39 por 1.000 solicitudes | Normal |
Consultar un perfil de Tumblrprofile | Resuelve un username de Tumblr y devuelve nombre, biografía, URL y fecha del post más reciente cuando existe. | $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 Tumblr?
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 posts en Tumblr Busca posts de Tumblr mediante | keyword | post_type | 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 · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform · tags |
tagConsultar publicaciones por etiqueta Consulta publicaciones de | tag | hashtag, post_type | 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 · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform · tags |
user_postsListar posts de un blog Obtiene posts públicos del | username | post_type | 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 · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform · tags |
profileConsultar un perfil de Tumblr Resuelve un | username | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | username · display_name · bio · url · latest_post_at · platform |
¿Qué significan los parámetros de Tumblr search?
Busca posts de Tumblr mediante keyword y tipo opcional, devolviendo autor, texto, formato y notas visibles. No incluye blogs privados ni garantiza todas las coincidencias.
keywordObligatorio- Término de búsqueda para publicaciones públicas en
search. Este parámetro también es compatible con la accióntag, pero en ese caso busca por etiqueta y no funciona como una búsqueda general.Tumblr: página de búsqueda y página de etiqueta — Tumblr diferencia una búsqueda por palabras de una página que agrupa posts con una etiqueta concreta. Las recomendaciones, operadores y ordenamientos de la web no se convierten automáticamente en parámetros admitidos. · Consultada post_typeOpcional- Tipo de publicación único para
search,tagouser_posts:any(cualquiera),text(texto),photo(foto),video(vídeo),quote(cita),link(enlace) oaudio(audio). No es un array.profileno utiliza este filtro.Tumblr: Las notas en los distintos tipos de publicaciones no son solo recuentos de me gusta — La documentación oficial de Tumblr define las `notes` como los me gusta, reblogueos y comentarios que recibe una publicación. Cambiar el tipo de publicación no hará que el `note_count` de esta API se divida automáticamente en tres métricas, ni permite interpretar el total de interacciones como el número de usuarios únicos. · Consultada
¿Qué significan los parámetros de Tumblr tag?
Consulta publicaciones de tag, con alias compatibles y filtro de tipo. La etiqueta no prueba el tema real ni convierte las notas en una medida de alcance.
tagObligatorio- Nombre del tema para
tag. Puede incluir#. Devuelve el contenido público de la etiqueta.Tumblr: La búsqueda por etiquetas no es una búsqueda de palabras clave en el texto — La documentación oficial explica que las páginas de etiquetas organizan las publicaciones en torno a un `tag` específico ya añadido, mientras que la página de búsqueda muestra resultados según los términos consultados. Aquí solo se explica el objeto de la etiqueta; no se promete una indexación en tiempo real, resultados exhaustivos ni la disponibilidad de todos los filtros de la página web. · Consultada hashtagOpcional- Parámetro compatible con
tag. Tiene menor prioridad quetag. post_typeOpcional- Tipo de publicación único para
search,tagouser_posts:any(cualquiera),text(texto),photo(foto),video(vídeo),quote(cita),link(enlace) oaudio(audio). No es un array.profileno utiliza este filtro.
¿Qué significan los parámetros de Tumblr user_posts?
Obtiene posts públicos del username, con tipo opcional, y conserva autor y fecha por pieza. El lote no garantiza todo el archivo del blog.
usernameObligatorio- Nombre corto del blog o dominio
nombre.tumblr.com. No incluyas un enlace completo conhttps://en este campo; la URL completa debe ir en el parámetrourl.profilesolo obtiene datos públicos del blog y no garantiza el número de seguidores.Tumblr: Reblogueos en blogs y fuentes originales — La documentación oficial indica que un `reblog` hace que una publicación existente aparezca en otro blog, pudiendo añadir contenido adicional; los reblogueos con contenido nuevo pueden aparecer en la búsqueda general, pero no en la búsqueda por etiquetas. Esta API no incluye la cadena completa de reblogueos, por lo que no se puede deducir el autor original basándose únicamente en la identidad del blog actual. · Consultada post_typeOpcional- Tipo de publicación único para
search,tagouser_posts:any(cualquiera),text(texto),photo(foto),video(vídeo),quote(cita),link(enlace) oaudio(audio). No es un array.profileno utiliza este filtro.
¿Qué significan los parámetros de Tumblr profile?
Resuelve un username de Tumblr y devuelve nombre, biografía, URL y fecha del post más reciente cuando existe. No accede a mensajes, borradores o blogs protegidos.
usernameObligatorio- Nombre corto del blog o dominio
nombre.tumblr.com. No incluyas un enlace completo conhttps://en este campo; la URL completa debe ir en el parámetrourl.profilesolo obtiene datos públicos del blog y no garantiza el número de seguidores.Tumblr: Blogs principales, blogs secundarios y blogs grupales — La documentación oficial explica que una cuenta puede tener un blog principal y blogs secundarios, y que estos últimos pueden ser gestionados por varias personas o estar protegidos con contraseña. Por tanto, el nombre del blog no equivale a la identidad de un individuo único; la información de esta página no ofrece identificación de relaciones entre cuentas ni permisos de acceso a contenido protegido por contraseña. · Consultada
Cómo usar la API de Tumblr
- 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":"tumblr","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Tumblr
¿Cómo llamo a la API de Tumblr?
Envía POST /api/v1/social con platform igual a tumblr, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Tumblr?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye text, post_type, author_username y author_name. 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 Tumblr?
Tumblr diferencia una búsqueda por palabras de una página que agrupa posts con una etiqueta concreta. Las recomendaciones, operadores y ordenamientos de la web no se convierten automáticamente en parámetros admitidos.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; tag requiere tag; user_posts requiere username; consulta las demás acciones en la lista de funciones.
¿Las acciones de Tumblr 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.