Web Search API

The Web Search API allows your applications to perform internet searches and retrieve instant answers, snippets, and related topics via DuckDuckGo.

Base URL

https://api.koveh.com/web-search/

Authentication

All requests require a Bearer Token in the Authorization header.

Authorization: Bearer <YOUR_API_KEY>

Endpoints

1. Perform Search

POST /search

Searches the web for the given query.

Request Body:

{
  "query": "Who is the CEO of Nvidia?",
  "save_to_history": true
}

Response:

{
  "query": "Who is the CEO of Nvidia?",
  "results": [
    {
      "title": "Jensen Huang - Wikipedia",
      "url": "https://en.wikipedia.org/wiki/Jensen_Huang",
      "snippet": "Jen-Hsun \"Jensen\" Huang is the co-founder and CEO of Nvidia...",
      "source": "DuckDuckGo"
    }
  ],
  "instant_answer": "Jensen Huang is the CEO of Nvidia.",
  "related_topics": ["Nvidia", "Jensen Huang"]
}

2. Search History

• GET /search/history: View past searches.
• GET /search/sessions: Group searches by session.
• GET /search/stats: Analyze search usage.

Service Health

GET /health

Checks connectivity to the DuckDuckGo Instant Answer API.