Skip to main content

​
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"

​
Output Format

​
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)"'
Featurekagi searchkagi enrich web
TokenAPI or SessionAPI only
IndexGeneral searchTeclis enrichment
FocusBroad resultsEnhanced metadata
CostVariesAPI credit

​
Exit Codes

CodeMeaning
0Success
1Error
Common errors:
  • Missing API token
  • Insufficient credit
  • Rate limiting

​
See Also