kagi CLI
Commands

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 currently uses Kagi's legacy /api/v0 API with Bot auth. It requires API access and consumes 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

fastgpt

Complete reference for *kagi* fastgpt command - get quick answers using Kagi's FastGPT API.

lens

Complete reference for *kagi* lens command - list, inspect, create, update, enable, disable, and delete Kagi search lenses.

On this page

kagi enrichSynopsisDescriptionAuthenticationSubcommandsenrich webenrich newsOptions<QUERY> (Required)Output FormatWeb Enrichment OutputNews Enrichment OutputExamplesWeb EnrichmentNews EnrichmentResearch WorkflowComparison with Standard SearchExit CodesSee Also