API de plataforma de EveryData

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 contrato público.

Endpoint
POST /api/v1/social
Funciones
4
Por 1.000
1,389 US$

Funciones disponibles

Compara las acciones de Tumblr por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.

AcciónObligatoriosOpcionalesEntregaLímitePor 1.000Campos de respuesta
search

Buscar posts en Tumblr

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.

keywordpost_typeEntrega síncronaEl 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 solicitudesid · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform
tag

Consultar publicaciones por etiqueta

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.

taghashtag, keyword, post_typeEntrega síncronaEl 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 solicitudesid · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform
user_posts

Listar posts de un blog

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.

usernamepost_typeEntrega síncronaEl 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 solicitudesid · url · text · post_type · author_username · author_name · author_url · note_count · posted_at · platform
profile

Consultar un perfil de Tumblr

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.

usernameEntrega síncrona$1.39 por 1.000 solicitudesusername · display_name · bio · url · latest_post_at · platform

¿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.

¿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ón tag, 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 etiquetaTumblr 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, tag o user_posts: any (cualquiera), text (texto), photo (foto), video (vídeo), quote (cita), link (enlace) o audio (audio). No es un array. profile no utiliza este filtro.
Tumblr: Las notas en los distintos tipos de publicaciones no son solo recuentos de me gustaLa 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 textoLa 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 que tag.
keywordOpcional
Término de búsqueda para publicaciones públicas en search. Este parámetro también es compatible con la acción tag, pero en ese caso busca por etiqueta y no funciona como una búsqueda general.
post_typeOpcional
Tipo de publicación único para search, tag o user_posts: any (cualquiera), text (texto), photo (foto), video (vídeo), quote (cita), link (enlace) o audio (audio). No es un array. profile no 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 con https:// en este campo; la URL completa debe ir en el parámetro url. profile solo obtiene datos públicos del blog y no garantiza el número de seguidores.
Tumblr: Reblogueos en blogs y fuentes originalesLa 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, tag o user_posts: any (cualquiera), text (texto), photo (foto), video (vídeo), quote (cita), link (enlace) o audio (audio). No es un array. profile no 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 con https:// en este campo; la URL completa debe ir en el parámetro url. profile solo obtiene datos públicos del blog y no garantiza el número de seguidores.
Tumblr: Blogs principales, blogs secundarios y blogs grupalesLa 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

  1. 01Consulta el catálogo público y elige una acción de la plataforma.
  2. 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
  3. 03Procesa el resultado síncrono o consulta el identificador de trabajo devuelto si la acción es asíncrona.
  4. 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
tumblr_search.sh
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 de origen contengan 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.