Search API Quick Start

Execute web searches and retrieve clean, parsed content from the top results.

Sample Request

curl -X POST https://nimble-retriever.webit.live/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "latest AI trends 2025",
    "num_results": 5,
    "parsing_type": "markdown",
    "country": "US",
    "locale": "en"
  }'

Sample Response

{
  "message": "Request processed successfully",
  "body": [
    {
      "page_content": "# Latest AI Trends in 2025\n\nThe artificial intelligence landscape has evolved dramatically...",
      "metadata": {
        "title": "Top AI Trends Shaping 2025 - Tech Insights",
        "snippet": "Explore the latest artificial intelligence trends transforming industries in 2025...",
        "url": "https://example.com/ai-trends-2025",
        "position": 1,
        "entity_type": "OrganicResult",
        "country": "US",
        "locale": "en"
      }
    },
    {
      "page_content": "...",
      "metadata": {
        "title": "AI Revolution: What to Expect in 2025",
        "snippet": "From generative AI to autonomous systems...",
        "url": "https://example.com/ai-revolution",
        "position": 2,
        "entity_type": "OrganicResult",
        "country": "US",
        "locale": "en"
      }
    }
  ]
}

---

Request Body Parameters

Parameter	Type	Required	Default	Description
query	string	Yes	-	The search query to execute
num_results	integer	No	3	Number of search results to return (max: 100)
parsing_type	enum	No	plain_text	Output format. Options: plain_text, markdown, simplified_html
locale	string	No	en	Locale for search results (e.g., en, fr, de)
country	string	No	US	Country code for search results (e.g., US, FR, GB)
render	boolean	No	true	Enable JavaScript rendering for dynamic content
driver	string	No	vx6	Browser driver version to use
wait	integer	No	null	Wait time in milliseconds before extracting content (useful for JavaScript-rendered pages)