MarkUDown
Search API — MarkUDown 网页搜索与抓取 API 文档
POST
/api/searchSearch
通过隐身浏览器进行 Google 搜索并返回最佳结果。可选择抓取每个结果页面的完整内容。
| 参数 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
| query | string | 必填 | — | 搜索关键词。 |
| limit | integer | 可选 | 5 | 返回的结果数量(1–50)。 |
| lang | string | 可选 | "en" | 语言代码,例如 "en"、"pt"、"es"。 |
| country | string | 可选 | "us" | 本地化结果的国家代码,例如 "us"、"br"、"de"。 |
| scrape_results | boolean | 可选 | true | 同时抓取每个结果页面的完整内容。 |
| engine | string | 可选 | "google" | "google"、"bing"、"duckduckgo" 或 "all"。 |
| timeout | integer | 可选 | 60 | 超时时间(秒)。 |
| callback_url | string | 可选 | null | 任务完成时接收结果(POST)的 webhook URL。 |
请求
{
"query": "best web scraping libraries 2025",
"limit": 5,
"lang": "en",
"country": "us",
"scrape_results": true
}响应
// POST returns { "success": true, "id": "abc123", "url": "/api/search/abc123" }
// Poll GET /api/search/{id} — "data" when completed:
{
"success": true,
"query": "best web scraping libraries 2025",
"total": 5,
"data": [
{
"title": "Top Scraping Libraries",
"url": "https://example.com/article",
"snippet": "Discover the best...",
"markdown": "# Top Scraping Libraries..."
}
]
}