Markdown API

Convert public webpages into clean Markdown with metadata, links, images, caching, usage tracking, and structured errors.

原始信息汇总

数据集概述：Markdown API

Markdown API 是一个用于将公开网页转换为干净 Markdown 的 RESTful API，支持元数据、链接、图片、缓存、使用量追踪和结构化错误处理。

基础信息

• 分类：文本分析（Text Analysis）
• 创建者：Ali Mahmood
• 订阅用户数：1
• 基础 URL：https://markdown-api-ne1h.onrender.com

核心功能

该 API 的主要功能是将公开网页转换为 Markdown 格式，支持以下请求参数：

• url：目标网页的 URL（必填）
• include_text：是否包含纯文本
• include_links：是否包含链接
• include_images：是否包含图片
• include_metadata：是否包含元数据
• preserve_tables：是否保留表格
• preserve_code_blocks：是否保留代码块
• remove_selectors：需要移除的 CSS 选择器列表（如广告弹窗）
• only_selectors：仅提取的 CSS 选择器列表（如文章主体）
• max_content_length：最大内容长度（默认 500,000 字符）

主要端点

端点	方法	描述
/v1/extract	POST	将网页转换为 Markdown（核心功能）
/v1/usage	GET	返回当前计划、使用量、限制及计费周期
/health	GET	返回 API 基本健康状态
/ready	GET	检查数据库和 Redis 可用性

响应示例

成功响应返回结构化 JSON，包含：

• success、url、final_url、title、description
• markdown、text、word_count、character_count、reading_time_minutes
• links、images、metadata、link_count、image_count
• cache_hit、timings（包含 fetch_ms、parse_ms、total_ms）

错误响应返回结构化 JSON，包含错误码如：

• INVALID_URL、UNAUTHORIZED、PRIVATE_NETWORK_BLOCKED
• DNS_RESOLUTION_FAILED、FETCH_TIMEOUT、PAGE_TOO_LARGE
• UNSUPPORTED_CONTENT_TYPE、EXTRACTION_FAILED
• RATE_LIMIT_EXCEEDED、PLAN_LIMIT_EXCEEDED

使用注意事项

• 需通过 RapidAPI 进行身份验证（自动发送 X-RapidAPI-Key 和 X-RapidAPI-Host 标头）
• 用户需遵守网站条款、robots 规则、版权、隐私及相关法律
• API 不会绕过登录、付费墙、验证码、反爬系统、地理限制或认证要求

订阅计划

计划	价格
BASIC	$0.00/月
PRO	$10.00/月
ULTRA	$25.00/月