MarkUDown

Search API — MarkUDown web search and scrape API docs

POST/api/search

Search

Run a Google search via a stealth browser and return the top results. Optionally scrape the full content of each result page.

ParameterTypeRequiredDefaultDescription
querystringrequired—Search query.
limitintegeroptional5Number of results to return (1–50).
langstringoptional"en"Language code, e.g. "en", "pt", "es".
countrystringoptional"us"Country code for localized results, e.g. "us", "br", "de".
scrape_resultsbooleanoptionaltrueAlso scrape the full content of each result page.
enginestringoptional"google""google", "bing", "duckduckgo" or "all".
timeoutintegeroptional60Timeout in seconds.
callback_urlstringoptionalnullWebhook 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..."
    }
  ]
}