Semantic API CLI

Query 700+ APIs with natural language from your terminal. Zero dependencies.

pip install semanticapi-cli

✨ Auto-Discover & Auto-Heal

Auto-Discover: Ask for any API — even ones not in the catalog. Semantic API automatically finds the docs, generates a provider config, and returns endpoint details. No manual setup.

semanticapi query "send a message with Discord"
# → Auto-discovers Discord API, returns endpoint + auth details

Auto-Heal: If an API's config goes stale (endpoints change, versions update), Semantic API detects the failure, re-discovers from current docs, and retries — all in a single request.

Quick Start

# Save your API key
semanticapi config set-key sapi_your_key

# Query any API
semanticapi query "send an SMS via Twilio"

# Search for capabilities
semanticapi search "weather forecast"

# Browse the catalog
semanticapi catalog list --search payments
semanticapi catalog stats

# Pre-check what you'll need (free, no LLM cost)
semanticapi preflight "send an email"

# Discover a provider
semanticapi discover stripe

# Batch queries
semanticapi batch "send email" "upload file" "translate text"

Commands

Authentication

API key priority (first found wins):

1. --key sapi_xxx flag
2. SEMANTICAPI_KEY environment variable
3. ~/.semanticapi/config.json (saved via config set-key)

Get your key at semanticapi.dev.

Output Modes

# Pretty-printed (default)
semanticapi query "get weather"

# Raw JSON (for piping)
semanticapi --raw query "get weather"

# Minimal output
semanticapi --quiet query "get weather"

Exit Codes

What You Get Back

Every query returns:

• Provider and endpoint details
• Code snippets (curl + Python) ready to copy-paste
• Auth requirements and setup instructions
• Alternative providers ranked by relevance

Related

• Semantic API — The API
• MCP Server — For Claude Desktop / ChatGPT
• Agent Skill — For autonomous agents
• Open Source Engine — AGPL-3.0

License

MIT