Documentation Index
Fetch the complete documentation index at: https://kagi.micr.dev/llms.txt
Use this file to discover all available pages before exploring further.
kagi enrich
Query Kagi’s enrichment indexes (Teclis for web, TinyGem for news) for enhanced search capabilities.
Synopsis
kagi enrich <SUBCOMMAND> [OPTIONS]
Description
The kagi enrich command provides access to Kagi’s specialized enrichment APIs:
- Teclis - Web enrichment index
- TinyGem - News enrichment index
These endpoints provide enhanced search capabilities beyond standard search, offering additional context and metadata.
Authentication
Required: KAGI_API_TOKEN
Enrichment APIs require API access and consume API credit.
Subcommands
enrich web
Query the Teclis web enrichment index.
Example:
kagi enrich web "artificial intelligence"
enrich news
Query the TinyGem news enrichment index.
Example:
kagi enrich news "climate change"
Options
<QUERY> (Required)
The search query for the enrichment index.
Example:
kagi enrich web "machine learning frameworks"
kagi enrich news "tech industry layoffs"
Web Enrichment Output
{
"meta": {
"id": "req-123",
"node": "us-east",
"ms": 120
},
"data": [
{
"title": "Result Title",
"url": "https://example.com",
"snippet": "Description...",
"published": "2024-03-15T10:30:00Z",
"domain": "example.com"
}
]
}
News Enrichment Output
{
"meta": {
"id": "req-456",
"node": "us-east",
"ms": 140
},
"data": [
{
"title": "News Headline",
"url": "https://news.example.com/story",
"snippet": "Article summary...",
"published": "2024-03-15T10:30:00Z"
}
]
}
Examples
Web Enrichment
# Search web enrichment
kagi enrich web "python web frameworks"
# Process results
kagi enrich web "cloud computing" | jq -r '.data[].url'
# Filter by domain
kagi enrich web "kubernetes" | jq '.data | map(select(.domain == "kubernetes.io"))'
News Enrichment
# Search news enrichment
kagi enrich news "artificial intelligence"
# Get recent news on topic
kagi enrich news "cryptocurrency regulation" | jq -r '.data[0:5] | .[].title'
# Filter by date
kagi enrich news "tech layoffs" | jq '.data | map(select(.published > "2024-01-01"))'
Research Workflow
#!/bin/bash
# Research a topic using both indexes
TOPIC="$1"
[ -z "$TOPIC" ] && { echo "Usage: research.sh <topic>"; exit 1; }
echo "🔍 Researching: $TOPIC"
echo ""
echo "Web Resources:"
kagi enrich web "$TOPIC" | jq -r '.data[0:5] | .[] | "• \(.title)\n \(.url)"'
echo ""
echo "News Coverage:"
kagi enrich news "$TOPIC" | jq -r '.data[0:5] | .[] | "• \(.title)\n \(.url)"'
Comparison with Standard Search
| Feature | kagi search | kagi enrich web |
|---|
| Token | API or Session | API only |
| Index | General search | Teclis enrichment |
| Focus | Broad results | Enhanced metadata |
| Cost | Varies | API credit |
Exit Codes
| Code | Meaning |
|---|
| 0 | Success |
| 1 | Error |
- Missing API token
- Insufficient credit
- Rate limiting
See Also
