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ó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 |
tagConsultar publicaciones por etiqueta Consulta publicaciones de | tag | hashtag, 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 |
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 |
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é 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ó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 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,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 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 quetag. keywordOpcional- 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. 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 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,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 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
- 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 devuelto si la acción es 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 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.