API de Substack
Busca publicaciones de Substack y consulta una publicación, sus entradas, comentarios, autores y Notes públicos. Handle, usuario y URL no deben intercambiarse sin atender a la acción.
Un subscriber count visible no revela suscriptores nominales ni facturación. El indicador de paywall marca acceso y la API no desbloquea contenido reservado a miembros.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Substack, 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 Substacksearch | Descubre publicaciones de Substack que coinciden con keyword, con nombre, handle, dominio propio, idioma, autor y posts destacados. | $1.39 por 1.000 solicitudes | Normal |
Consultar una publicación de Substackpublication | Abre la url de la página principal de una publicación y recoge nombre, handle, dominio, idioma, autor, posts destacados y suscriptores cuando se muestran. | $1.39 por 1.000 solicitudes | Normal |
Listar entradas de una publicaciónpublication_posts | Obtiene posts de la publicación indicada por url, con tipo y fechas opcionales. | $1.39 por 1.000 solicitudes | Normal |
Consultar una publicación de Substackpost | Consulta la url /p/ de un post concreto y devuelve título, subtítulo, texto, autor, publicación e interacciones accesibles. | $1.39 por 1.000 solicitudes | Normal |
Leer comentarios de una publicacióncomments | Lee comentarios asociados a la url de un post y conserva respuesta, fijado, autor e interacciones cuando existen. | $1.39 por 1.000 solicitudes | Normal |
Consultar el perfil de un autorprofile | Resuelve un username de Substack y devuelve perfil, biografía, avatar y publicaciones relacionadas cuando están visibles. | $1.39 por 1.000 solicitudes | Normal |
Leer Notes de un autornotes | Consulta los Notes públicos del username, con texto, tipo, autor, fecha y likes de cada uno. | $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 Substack?
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 Substack Descubre publicaciones de Substack que coinciden con | keyword | — | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 30 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 · handle · name · url · custom_domain · bio · language · subscriber_count · payments_enabled · avatar_url · cover_url · platform · author_name · author_username · top_posts |
publicationConsultar una publicación de Substack Abre la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · handle · name · url · custom_domain · bio · language · subscriber_count · payments_enabled · avatar_url · cover_url · platform · author_name · author_username · top_posts |
publication_postsListar entradas de una publicación Obtiene posts de la publicación indicada por | url | content_type, since, until | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 30 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 · title · subtitle · text · author_name · author_username · publication_name · publication_handle · publication_url · like_count · comment_count · repost_count · word_count · reading_time_minutes · post_type · audience · is_paid · podcast_url · image_url · posted_at · updated_at · tags · platform |
postConsultar una publicación de Substack Consulta la | url | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | id · url · title · subtitle · text · author_name · author_username · publication_name · publication_handle · publication_url · like_count · comment_count · repost_count · word_count · reading_time_minutes · post_type · audience · is_paid · podcast_url · image_url · posted_at · updated_at · tags · platform |
commentsLeer comentarios de una publicación Lee comentarios asociados a la | url | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 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 · text · author_name · author_username · like_count · reply_count · reply_to_id · is_reply · is_pinned · is_author · posted_at · platform |
profileConsultar el perfil de un autor Resuelve un | username | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | user_id · username · display_name · bio · avatar_url · twitter_username · platform · publications |
notesLeer Notes de un autor Consulta los Notes públicos del | username | — | Entrega síncrona | El catálogo declara defaultLimit = 25 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 · kind · text · author_username · author_name · like_count · posted_at · platform · restacked_post · attachment_urls |
¿Qué significan los parámetros de Substack search?
Descubre publicaciones de Substack que coinciden con keyword, con nombre, handle, dominio propio, idioma, autor y posts destacados. Busca publicaciones, no el texto de los posts; no evita suscripciones ni estima ingresos.
keywordObligatorio- Para
search, se usa para descubrir publicaciones (publication) o newsletters, no para buscar texto en todos los artículos.Substack: perfil, publicación y panel editorial — Substack distingue el Profile público, el sitio de una publication y el dashboard del publisher. La búsqueda pública no incluye por ello gestión de lectores, ingresos, analítica privada ni contenido cerrado. · Consultada
¿Qué significan los parámetros de Substack publication?
Abre la url de la página principal de una publicación y recoge nombre, handle, dominio, idioma, autor, posts destacados y suscriptores cuando se muestran. No accede al panel del autor ni valida suscriptores de pago.
urlObligatorio- Para
publicationopublication_posts, introduce la página de inicio de la publicación. Parapostocomments, introduce el enlace específico del artículo (/p/nombre-corto). La acciónpublicationrequiere una URL de la que se pueda extraer elhandlede Substack; no se garantiza que los dominios personalizados se reconozcan.publication_postssí admite directamente la URL completa de un dominio personalizado.Substack: el perfil de autor y el sitio de la publicación no son la misma URL — El `handle` de un autor de Substack corresponde a `substack.com/@handle`, mientras que el sitio de su publicación puede usar `subdominio.substack.com`. Aquí solo se verifica la diferencia entre el objeto y su dirección; la capacidad de resolver dominios personalizados sigue sujeta a los límites del parámetro de la acción correspondiente. · Consultada
¿Qué significan los parámetros de Substack publication_posts?
Obtiene posts de la publicación indicada por url, con tipo y fechas opcionales. Distingue autor y publicación por pieza; el lote no garantiza todo el archivo ni contenido bloqueado.
urlObligatorio- Para
publicationopublication_posts, introduce la página de inicio de la publicación. Parapostocomments, introduce el enlace específico del artículo (/p/nombre-corto). La acciónpublicationrequiere una URL de la que se pueda extraer elhandlede Substack; no se garantiza que los dominios personalizados se reconozcan.publication_postssí admite directamente la URL completa de un dominio personalizado. content_typeOpcional- Filtro para contenido de tipo artículo:
all_types(todos),newsletter_posts_only(solo artículos),podcast_episodes_only(solo pódcasts) othreads_only(solo hilos de discusión). Comprueba el resultado para ver si el filtro se aplica a la URL de un solo artículo. No desbloquea el contenido de pago.Valores permitidos:all_typesnewsletter_posts_onlypodcast_episodes_onlythreads_onlySubstack: los tipos de contenido (artículo, audio, vídeo) son independientes de los permisos de acceso — Substack clasifica las publicaciones de texto, audio y vídeo como formatos de contenido distintos, y separa el material público del privado. El parámetro `content_type` de esta API usa sus propios valores permitidos y no añade un tipo de vídeo por esta distinción, ni afirma que el filtrado y la lectura estén verificados para cada ruta de ejecución. · Consultada sinceOpcional- Fecha de inicio del periodo para artículos o notas. Usa un string de fecha. Este parámetro también aparece en los modos de perfil de publicación o autor, pero no significa que puedas filtrar por fecha de creación de la cuenta.
untilOpcional- Fecha de fin del periodo para artículos o notas. Se usa junto con
since. No es la fecha de vencimiento de la suscripción ni implica una exportación completa del historial.
¿Qué significan los parámetros de Substack post?
Consulta la url /p/ de un post concreto y devuelve título, subtítulo, texto, autor, publicación e interacciones accesibles. No desbloquea el paywall, y los comentarios se leen con la acción comments.
urlObligatorio- Para
publicationopublication_posts, introduce la página de inicio de la publicación. Parapostocomments, introduce el enlace específico del artículo (/p/nombre-corto). La acciónpublicationrequiere una URL de la que se pueda extraer elhandlede Substack; no se garantiza que los dominios personalizados se reconozcan.publication_postssí admite directamente la URL completa de un dominio personalizado.Substack: la vista previa gratuita no es el texto completo de un artículo de pago — Substack permite a los autores configurar una vista previa gratuita y la posición del muro de pago en sus artículos. Por tanto, que el campo `text` no esté vacío no demuestra que se haya obtenido el artículo completo, y el campo `is_paid` o filtrar por contenido de pago tampoco otorgan permisos de lectura. · Consultada
¿Qué significan los parámetros de Substack comments?
Lee comentarios asociados a la url de un post y conserva respuesta, fijado, autor e interacciones cuando existen. No publica ni garantiza toda la conversación.
urlObligatorio- Para
publicationopublication_posts, introduce la página de inicio de la publicación. Parapostocomments, introduce el enlace específico del artículo (/p/nombre-corto). La acciónpublicationrequiere una URL de la que se pueda extraer elhandlede Substack; no se garantiza que los dominios personalizados se reconozcan.publication_postssí admite directamente la URL completa de un dominio personalizado.Substack: un comentario oculto no es lo mismo que un comentario eliminado — Las `Reply Rules` de Substack permiten ocultar comentarios en artículos o respuestas en `Notes` en lugar de eliminarlos permanentemente. Que falte un comentario en los resultados públicos no es suficiente para darlo por eliminado; esta API no tiene acceso al panel de moderación, ni puede restaurar contenido oculto o modificar las reglas. · Consultada
¿Qué significan los parámetros de Substack profile?
Resuelve un username de Substack y devuelve perfil, biografía, avatar y publicaciones relacionadas cuando están visibles. No confunde persona y publication ni revela datos privados de suscripción.
usernameObligatorio- El
handledel autor paraprofileonotes. Puede ser@autoro un enlacesubstack.com/@autor.Notesson las publicaciones cortas de un autor, no los artículos largos de una publicación.Substack: el handle de autor, el nombre de perfil y los datos públicos — El `handle` único de Substack se usa para formar la URL del perfil de autor, mientras que el nombre de perfil y la biografía se pueden editar por separado. Esta referencia distingue así entre `username` y `display_name`, y no afirma que se puedan leer las suscripciones o la actividad de «me gusta» que el usuario haya ocultado. · Consultada
¿Qué significan los parámetros de Substack notes?
Consulta los Notes públicos del username, con texto, tipo, autor, fecha y likes de cada uno. Solo cubre a ese autor: no es una búsqueda global ni garantiza el historial completo.
usernameObligatorio- El
handledel autor paraprofileonotes. Puede ser@autoro un enlacesubstack.com/@autor.Notesson las publicaciones cortas de un autor, no los artículos largos de una publicación.Substack: definición de Notes y Restacks — Substack define las `Notes` como una actividad de contenido corto y un `Restack` como la acción de compartir contenido en `Notes`; es un formato distinto al envío de `newsletters` por correo. Las funciones oficiales de publicación, interacción y estadísticas de ingresos no implican que esta API de lectura de `notes` ya disponga de esas operaciones o métricas. · Consultada
Cómo usar la API de Substack
- 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":"substack","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Substack
¿Cómo llamo a la API de Substack?
Envía POST /api/v1/social con platform igual a substack, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Substack?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye handle, name, custom_domain y bio. 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 Substack?
Substack distingue el Profile público, el sitio de una publication y el dashboard del publisher. La búsqueda pública no incluye por ello gestión de lectores, ingresos, analítica privada ni contenido cerrado.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; publication requiere url; publication_posts requiere url; consulta las demás acciones en la lista de funciones.
¿Las acciones de Substack 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.