API de Medium
Consulta historias de Medium por etiqueta, autor o publicación. Cada acción mantiene la relación entre pieza, escritor y publicación sin confundir sus identificadores.
Tiempo de lectura, aplausos y comentarios son señales visibles. El indicador de miembros describe acceso publicado y la API no evita paywalls ni recupera borradores.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Medium, 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 |
|---|---|---|---|
Explorar historias por etiquetatag | Consulta artículos asociados al tag de Medium, conservando autor, publicación, tiempo de lectura e indicador de miembros. | $1.39 por 1.000 solicitudes | Normal |
Leer artículos de un autor de Mediumuser_posts | Obtiene artículos del username, con url compatible, y devuelve título, extracto, publicación e interacciones visibles. | $1.39 por 1.000 solicitudes | Normal |
Consultar historias de una publicaciónpublication | Lee historias de la publicación indicada en publication, aceptando su url compatible. | $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 Medium?
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 |
|---|---|---|---|---|---|---|
tagExplorar historias por etiqueta Consulta artículos asociados al | tag | — | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 25 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 · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform · tags |
user_postsLeer artículos de un autor de Medium Obtiene artículos del | username | url | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 25 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 · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform · tags |
publicationConsultar historias de una publicación Lee historias de la publicación indicada en | publication | url | Entrega síncrona | El catálogo declara defaultLimit = 10 y maxLimit = 25 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 · text · author_name · author_username · author_url · publication_name · like_count · comment_count · reading_time_minutes · is_members_only · posted_at · image_url · platform · tags |
¿Qué significan los parámetros de Medium tag?
Consulta artículos asociados al tag de Medium, conservando autor, publicación, tiempo de lectura e indicador de miembros. No evita el paywall ni garantiza todas las historias de la etiqueta.
tagObligatorio- Nombre corto de la etiqueta de tema en Medium, por ejemplo,
machine-learning. Se eliminará el#inicial, se convertirá a minúsculas y los espacios se reemplazarán por guiones. No es una consulta de búsqueda de texto completo arbitraria.Medium: perfiles, publicaciones, Topics y muro de pago — Medium documenta feeds separados para autores, publications y Topics, y aclara que el texto completo de historias de pago no se incluye en RSS. La referencia explica el objeto y la visibilidad, no habilita lectura de contenido de pago. · Consultada
¿Qué significan los parámetros de Medium user_posts?
Obtiene artículos del username, con url compatible, y devuelve título, extracto, publicación e interacciones visibles. El lote no incluye borradores ni necesariamente todo el archivo del autor.
usernameObligatorio- El handle del autor en Medium o la URL completa de su página de autor. Un handle sin URL se convertirá en
https://medium.com/@<handle>. Lee la lista de artículos de ese autor, no los detalles de su perfil.Medium: los aplausos no equivalen a lectores únicos — Medium permite que un mismo lector aplauda varias veces un artículo, por lo que el número total de `claps` no equivale al número de lectores. Esta API no proporciona el desglose de aplausos por persona que ve el autor, ni garantiza que el recuento de aplausos se devuelva siempre, aunque el campo exista. · Consultada urlOpcional- Parámetro de compatibilidad para la URL completa del autor o de la publicación en
user_postsypublication. Aún debes proporcionar los campos obligatoriosusernameopublicationpara cada acción. La lista puede incluir artículos restringidos, lo que no significa que puedas acceder al texto completo de pago.
¿Qué significan los parámetros de Medium publication?
Lee historias de la publicación indicada en publication, aceptando su url compatible. Distingue publicación y autor de cada pieza; no concede acceso a contenido exclusivo para miembros.
publicationObligatorio- Nombre corto de la publicación de Medium o la URL completa de la misma. No es el título de un artículo ni el handle de un autor. Un nombre corto sin URL se convertirá en
medium.com/<publicación>.Medium: las publicaciones y los perfiles de autor usan flujos de contenido distintos — Medium distingue entre una `Publication` y un perfil de autor `@username`, y además especifica un formato de flujo de contenido diferente para publicaciones con dominio personalizado. Esta referencia solo aclara la diferencia entre objetos; la entrada de esta API sigue usando el parámetro indicado y no requiere que pases una URL de `feed`, ni promete que todos los dominios personalizados estén validados. · Consultada urlOpcional- Parámetro de compatibilidad para la URL completa del autor o de la publicación en
user_postsypublication. Aún debes proporcionar los campos obligatoriosusernameopublicationpara cada acción. La lista puede incluir artículos restringidos, lo que no significa que puedas acceder al texto completo de pago.
Cómo usar la API de Medium
- 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":"medium","action":"tag","params":{"tag":"<tag>"}}'
Preguntas sobre la API de Medium
¿Cómo llamo a la API de Medium?
Envía POST /api/v1/social con platform igual a medium, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Medium?
Devuelve JSON estructurado. Por ejemplo, el esquema de tag incluye title, text, author_name y author_username. 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 Medium?
Medium documenta feeds separados para autores, publications y Topics, y aclara que el texto completo de historias de pago no se incluye en RSS. La referencia explica el objeto y la visibilidad, no habilita lectura de contenido de pago.
¿Qué parámetros son obligatorios?
Depende de la acción. tag requiere tag; user_posts requiere username; publication requiere publication.
¿Las acciones de Medium 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.