Gensee Search API
Powerful search capabilities for querying information across the internet
Overview
The Gensee Search API employs LLM agents to retrieve the most relevant information based on your search query, saving you from manual crawling, browsing and extraction.
The API returns structured search results with titles, URLs, and content snippets tailored to your query.
Authentication
All API requests require authentication using a Bearer token in the Authorization header:
Authorization: Bearer YOUR_API_TOKEN
You can obtain your API token from the dashboard.
Endpoint
POST /api/search
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| session_id | string | Optional | Unique session identifier for tracking requests. Auto-generated if not provided. |
| query | string | Required | Search query string |
| max_results | integer | Optional | Number of results to return. Default: 5 |
| mode | string | Optional | Search mode: "evidence" or "digest". Default: "digest" |
| timeout_seconds | number | Optional | Maximum time to wait for search results in seconds. Default: 30 |
| multilingual | boolean | Optional | Enable multilingual search. Default: false |
Search Modes
The API supports two search modes, optimized for different use cases:
Evidence Mode
Use case: Raw content extraction for downstream LLM processing
Returns selected chunks of raw page content without summarization. This mode provides unprocessed text segments that are most relevant to your query, ideal for feeding into language models or when you need the original source material.
Set: "mode": "evidence"
Digest Mode (Default)
Use case: Human-readable summaries and answers
Returns summarized content tailored to your search query. The API processes and condenses information to provide concise, relevant answers that are easy to read and understand.
Set: "mode": "digest"
Response Format
Response Object
| Field | Type | Description |
|---|---|---|
| session_id | string | The session identifier for this request |
| search_response | array | Array of search result objects |
| elapsed_time | number | Time taken to process the request in seconds |
Search Result Object
| Field | Type | Description |
|---|---|---|
| title | string | Title of the webpage |
| url | string | URL of the webpage |
| content | string | Content snippet specific to the search query |
Error Codes
| Status Code | Description |
|---|---|
| 200 | Success - Request processed successfully |
| 401 | Unauthorized - Missing or invalid API token |
| 402 | Payment Required - Insufficient account balance |
| 500 | Internal Server Error - Server-side processing error |
| 502 | Bad Gateway - Search backend error |