MarkUDown
Search API — MarkUDown web search and scrape API docs
POST
/api/searchSearch
Run a Google search via a stealth browser and return the top results. Optionally scrape the full content of each result page.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| query | string | required | — | Search query. |
| limit | integer | optional | 5 | Number of results to return (1–50). |
| lang | string | optional | "en" | Language code, e.g. "en", "pt", "es". |
| country | string | optional | "us" | Country code for localized results, e.g. "us", "br", "de". |
| scrape_results | boolean | optional | true | Also scrape the full content of each result page. |
| engine | string | optional | "google" | "google", "bing", "duckduckgo" or "all". |
| timeout | integer | optional | 60 | Timeout in seconds. |
| callback_url | string | optional | null | Webhook URL to POST the result to when the job completes. |
Request
{
"query": "best web scraping libraries 2025",
"limit": 5,
"lang": "en",
"country": "us",
"scrape_results": true
}Response
// 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..."
}
]
}