Saltar al contenido principal

Descripción general

La API REST de Web2MD te permite convertir cualquier página web o HTML sin procesar a Markdown limpio de forma programática. Úsala para crear pipelines, automatizar la ingesta de contenido o integrar Web2MD en tus propias herramientas.
La API REST requiere un plan PRO. Genera tu clave de API desde el panel de Web2MD.

Especificaciones legibles por máquina

Usa la especificación OpenAPI para generar automáticamente SDKs de cliente o importarla en herramientas como Postman, Swagger UI o frameworks de agentes de IA.

Autenticación

Todas las solicitudes deben incluir tu clave de API en el encabezado Authorization:
Las claves de API tienen el prefijo w2m_ y están vinculadas a tu cuenta.

Endpoint

POST https://web2md.org/api/v1/convert

Cuerpo de la solicitud

Proporciona url o html, no ambos. La solicitud fallará con un error 400 si ambos están presentes o si no se proporciona ninguno.

Opciones

Respuesta

Una respuesta exitosa devuelve:

Límites de tasa

Las solicitudes a la API están limitadas a 60 solicitudes por minuto por clave de API. Si superas el límite, la API devuelve un código de estado 429. Espera a que se restablezca la ventana antes de volver a intentarlo.

Respuestas de error

Todas las respuestas de error siguen esta estructura:

Ejemplos

Convertir una URL con curl

Convertir HTML sin procesar con curl

JavaScript (fetch)

Guarda tu clave de API en una variable de entorno en lugar de escribirla directamente en el código. Por ejemplo, usa process.env.WEB2MD_API_KEY en Node.js.