Search Parameters →
Configure query behavior, filtering, sorting, and AI context for the Aevum Encyclopedia search endpoint. All parameters are URL-encoded query strings.
Base URL & Structure
All search requests are made to the unified search endpoint. Parameters are appended as query strings. Authentication requires a valid Bearer token in the Authorization header.
GET https://api.aevumencyclopedia.com/v2/search?q={query}&{parameters}
Core Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| q | String | — | Required. The search query string. Supports boolean operators (AND, OR, -) and exact phrase matching with quotes. |
| lang | String | en | ISO 639-1 language code. Filters results to match the specified language or returns translated summaries. |
| type | Array | all | Content types to include: article, dataset, timeline, graph, multimedia. |
| verify | String | standard | Verification tier: community, standard, expert, peer-reviewed. |
| limit | Integer | 20 | Number of results per page. Max: 100. Set to -1 for full dataset export (requires premium tier). |
| offset | Integer | 0 | Number of results to skip for pagination. |
Advanced & AI Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| ai_mode | String | balanced | Controls AI interpretation: strict (literal match), balanced (contextual), expansive (conceptual/semantic). |
| sort | String | relevance | Ranking strategy: relevance, recency, popularity, verification_score, alphabetical. |
| timeframe | String | any | Date range filter: today, week, month, year, or custom ISO range 2020-01-01..2023-12-31. |
| fields | Array | all | Select response fields to reduce payload: id, title, summary, author, tags, graph_links. |
| exclude | Array | [] | Comma-separated list of article IDs or tags to exclude from results. |
| explain | Boolean | false | Returns AI-generated reasoning for why results match the query. Useful for research transparency. |
Interactive Query Builder
Construct and preview your search parameters in real-time.
Example Requests
1. Basic Semantic Search
/v2/search?q=renaissance%20architecture&lang=en&type=article,graph&ai_mode=expansive
2. Filtered & Sorted with Field Selection
/v2/search?q=crispr%20gene%20editing&verify=peer-reviewed&sort=recency&limit=5&fields=title,summary,author,tags
3. AI Explanation Enabled
/v2/search?q=causes%20of%20byzantine%20economic%20decline&explain=true&ai_mode=balanced&lang=en
Important Notes
⚡ Rate Limits
Free tier: 60 requests/minute. Pro: 500/min. Enterprise: Custom. Exceeding limits returns 429 Too Many Requests.
🌐 Language Fallback
If a requested language lacks coverage, the engine returns English results with an AI-generated translation summary.
🧠 AI Caching
Explanations and contextual expansions are cached for 24 hours. Append _cache=false to force regeneration.
🔒 Privacy & Compliance
Query logs are anonymized after 30 days. Enterprise clients can enable zero-retention mode via dashboard settings.