API de plataforma de EveryData

API de Substack

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

Q: ¿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 de origen contengan un valor.

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

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.

Empieza gratis Ver el catálogo público

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

Funciones disponibles

Compara las acciones de Substack 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
`search` Buscar publicaciones en Substack Busca publicaciones de Substack mediante `keyword` y permite excluir términos, filtrar paywall o acotar fechas. Devuelve páginas de publicación visibles; no evita suscripciones ni estima ingresos.	keyword	exclude_keywords, paywall, 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 · handle · name · url · custom_domain · bio · language · subscriber_count · payments_enabled · avatar_url · cover_url · platform · title
`publication` Consultar una publicación de Substack Abre la `url` de una publicación, con handle o nombre compatibles, y recoge identidad, dominio, idioma y contadores publicados. No accede al panel del autor ni valida suscriptores de pago.	url	exclude_keywords, handle, paywall, publication, since, until	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 · title
`publication_posts` Listar entradas de una publicación 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.	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
`post` Consultar una publicación de Substack Consulta la `url` de un post concreto y devuelve título, subtítulo, texto y autor accesibles. Los filtros compatibles no desbloquean el paywall ni añaden comentarios automáticamente.	url	content_type, since, until	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
`comments` Leer comentarios de una publicación 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.	url	content_type, since, until	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
`profile` Consultar el perfil de un autor 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.	username	exclude_keywords, paywall, since, until	Entrega síncrona	—	$1.39 por 1.000 solicitudes	user_id · username · display_name · bio · avatar_url · twitter_username · platform · name · handle · url · role
`notes` Leer Notes de un autor Consulta Notes públicos del `username`, con texto, autor, fecha y likes. Los filtros compatibles no convierten la acción en búsqueda global ni garantizan el historial completo.	username	exclude_keywords, paywall, since, until	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 · title · url

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

¿Qué significan los parámetros de Substack `search`?

Busca publicaciones de Substack mediante keyword y permite excluir términos, filtrar paywall o acotar fechas. Devuelve páginas de publicación visibles; 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 editorialSubstack 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 2026-09-04
exclude_keywordsOpcional: Palabras clave de contenido a excluir, para el descubrimiento de contenido. No es una lista negra de autores. No se ha confirmado si este filtro se aplica en los modos que solo devuelven datos de autor o de publicación.
paywallOpcional: Atributo de pago del contenido: any (cualquiera), free_posts_only (solo contenido gratuito) o paid_posts_only (solo contenido de pago). Filtrar por contenido de pago no da acceso para leerlo. No se ha confirmado el efecto de este filtro en los modos de búsqueda de perfiles o publicaciones.
Valores permitidos:anyfree_posts_onlypaid_posts_only
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 `publication`?

Abre la url de una publicación, con handle o nombre compatibles, y recoge identidad, dominio, idioma y contadores publicados. No accede al panel del autor ni valida suscriptores de pago.

urlObligatorio: Para publication o publication_posts, introduce la página de inicio de la publicación. Para post o comments, introduce el enlace específico del artículo (/p/nombre-corto). La acción publication requiere una URL de la que se pueda extraer el handle de Substack; no se garantiza que los dominios personalizados se reconozcan. publication_posts sí 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 URLEl `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 2026-09-04
exclude_keywordsOpcional: Palabras clave de contenido a excluir, para el descubrimiento de contenido. No es una lista negra de autores. No se ha confirmado si este filtro se aplica en los modos que solo devuelven datos de autor o de publicación.
handleOpcional: Entrada de compatibilidad para el handle (nombre corto en la ruta) del autor o la publicación. No es el nombre de visualización. Da prioridad a los parámetros username o url de la acción correspondiente.
paywallOpcional: Atributo de pago del contenido: any (cualquiera), free_posts_only (solo contenido gratuito) o paid_posts_only (solo contenido de pago). Filtrar por contenido de pago no da acceso para leerlo. No se ha confirmado el efecto de este filtro en los modos de búsqueda de perfiles o publicaciones.
Valores permitidos:anyfree_posts_onlypaid_posts_only
publicationOpcional: Entrada de compatibilidad para el nombre corto o el enlace de la publicación. No es una búsqueda por nombre aproximado. No elimina el requisito de que url sea un campo obligatorio.
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 `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 publication o publication_posts, introduce la página de inicio de la publicación. Para post o comments, introduce el enlace específico del artículo (/p/nombre-corto). La acción publication requiere una URL de la que se pueda extraer el handle de Substack; no se garantiza que los dominios personalizados se reconozcan. publication_posts sí 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) o threads_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_only
Substack: los tipos de contenido (artículo, audio, vídeo) son independientes de los permisos de accesoSubstack 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 2026-09-04
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 de un post concreto y devuelve título, subtítulo, texto y autor accesibles. Los filtros compatibles no desbloquean el paywall ni añaden comentarios automáticamente.

urlObligatorio: Para publication o publication_posts, introduce la página de inicio de la publicación. Para post o comments, introduce el enlace específico del artículo (/p/nombre-corto). La acción publication requiere una URL de la que se pueda extraer el handle de Substack; no se garantiza que los dominios personalizados se reconozcan. publication_posts sí admite directamente la URL completa de un dominio personalizado.
Substack: la vista previa gratuita no es el texto completo de un artículo de pagoSubstack 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 2026-09-04
content_typeOpcional: Filtro para contenido de tipo artículo: all_types (todos), newsletter_posts_only (solo artículos), podcast_episodes_only (solo pódcasts) o threads_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_only
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 `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 publication o publication_posts, introduce la página de inicio de la publicación. Para post o comments, introduce el enlace específico del artículo (/p/nombre-corto). La acción publication requiere una URL de la que se pueda extraer el handle de Substack; no se garantiza que los dominios personalizados se reconozcan. publication_posts sí admite directamente la URL completa de un dominio personalizado.
Substack: un comentario oculto no es lo mismo que un comentario eliminadoLas `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 2026-09-04
content_typeOpcional: Filtro para contenido de tipo artículo: all_types (todos), newsletter_posts_only (solo artículos), podcast_episodes_only (solo pódcasts) o threads_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_only
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 `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 handle del autor para profile o notes. Puede ser @autor o un enlace substack.com/@autor. Notes son 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úblicosEl `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 2026-09-04
exclude_keywordsOpcional: Palabras clave de contenido a excluir, para el descubrimiento de contenido. No es una lista negra de autores. No se ha confirmado si este filtro se aplica en los modos que solo devuelven datos de autor o de publicación.
paywallOpcional: Atributo de pago del contenido: any (cualquiera), free_posts_only (solo contenido gratuito) o paid_posts_only (solo contenido de pago). Filtrar por contenido de pago no da acceso para leerlo. No se ha confirmado el efecto de este filtro en los modos de búsqueda de perfiles o publicaciones.
Valores permitidos:anyfree_posts_onlypaid_posts_only
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 `notes`?

Consulta Notes públicos del username, con texto, autor, fecha y likes. Los filtros compatibles no convierten la acción en búsqueda global ni garantizan el historial completo.

usernameObligatorio: El handle del autor para profile o notes. Puede ser @autor o un enlace substack.com/@autor. Notes son las publicaciones cortas de un autor, no los artículos largos de una publicación.
Substack: definición de Notes y RestacksSubstack 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 2026-09-04
exclude_keywordsOpcional: Palabras clave de contenido a excluir, para el descubrimiento de contenido. No es una lista negra de autores. No se ha confirmado si este filtro se aplica en los modos que solo devuelven datos de autor o de publicación.
paywallOpcional: Atributo de pago del contenido: any (cualquiera), free_posts_only (solo contenido gratuito) o paid_posts_only (solo contenido de pago). Filtrar por contenido de pago no da acceso para leerlo. No se ha confirmado el efecto de este filtro en los modos de búsqueda de perfiles o publicaciones.
Valores permitidos:anyfree_posts_onlypaid_posts_only
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.

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 devuelto si la acción es asíncrona.
04Guarda los campos de la respuesta estructurada que necesita tu aplicación.

substack_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":"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 de origen contengan 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.

Behance API Bilibili API Bluesky API Dailymotion API DeviantArt API Discord API Douban API Douyin API Ver el catálogo público →