MarkUDown

Search API — MarkUDown 网页搜索与抓取 API 文档

POST/api/search

Search

通过隐身浏览器进行 Google 搜索并返回最佳结果。可选择抓取每个结果页面的完整内容。

参数类型必填默认值描述
querystring必填—搜索关键词。
limitinteger可选5返回的结果数量(1–50)。
langstring可选"en"语言代码,例如 "en"、"pt"、"es"。
countrystring可选"us"本地化结果的国家代码,例如 "us"、"br"、"de"。
scrape_resultsboolean可选true同时抓取每个结果页面的完整内容。
enginestring可选"google""google"、"bing"、"duckduckgo" 或 "all"。
timeoutinteger可选60超时时间(秒)。
callback_urlstring可选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..."
    }
  ]
}