---
id: enigma-api-client
version: "0.7.11"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# enigma-api-client — Enigma's Public API SDK

License: permissive · Maintenance: active · Downloads: 95.7K/mo

## What it is and what it does

Enigma API Client is a Python SDK that wraps Enigma's GraphQL business intelligence API, letting you query a large business database either by writing raw GraphQL or by submitting natural language prompts. The library handles connection lifecycle, async I/O, and response parsing through httpx, pydantic, and graphql-core.

The package offers four query strategies: ServiceStrategy (default, server-side generation), TemplateStrategy (LLM-classified into 12 pre-defined templates), GenerativeStrategy (end-to-end LLM generation), and AgentStrategy (Claude agent with skill access). Most callers use the default server-side strategy; local strategies require an Anthropic API key and trade speed for control. The client is designed as an async context manager to maintain reusable keep-alive connections.

Use it for:

- Brand and company profile lookups: search for business details by name or website.
- Location discovery: find retail or office locations for a brand within a geographic region.
- Person and ownership search: identify companies owned by or associated with a specific individual.
- KYB verification: verify legal entity status and corporate structure for compliance or due diligence.
- Watchlist screening: check entities against risk or compliance watchlists.
- Custom queries: use raw GraphQL or generative strategies for complex business intelligence queries not covered by templates.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python SDK for querying Enigma's GraphQL business intelligence API, supporting both raw GraphQL and natural language prompts to search a database of 250M+ businesses.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and offers a clean async API with multiple query strategies. It is worth installing if you need programmatic access to Enigma's business database and can provide an API key. The default server-side strategy requires no local LLM setup; local strategies add flexibility at the cost of Anthropic API calls and latency.

## Install

pip install enigma-api-client
uv add enigma-api-client
poetry add enigma-api-client

## Installing enigma-api-client

Before you install: Low install friction with a pure-Python wheel and four lightweight runtime dependencies. Active maintenance with a release 2 days old as of the fact sheet date.

License in practice: Apache-2.0 permissive license allows commercial use, modification, and distribution with minimal restrictions.

Quickstart:

pip install enigma-api-client

import asyncio
from enigma_api_client import Client, ClientConfig

async def main():
    config = ClientConfig(enigma_api_key="your-api-key")
    async with Client(config) as client:
        response = await client.search(prompt="Tell me about Chipotle")
        print(response.data)

asyncio.run(main())

Requires Python 3.11 or later. Enigma API key required; optional Anthropic API key for local LLM-based query generation strategies.

Verify before relying:

- Whether the 250M+ business database figure is current or a historical snapshot.
- Specific rate limits, latency characteristics, or SLA guarantees for the GraphQL endpoint.
- Whether AgentStrategy's iterative refinement actually improves query quality in practice for edge cases.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 95.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

graphql business intelligence api client, enigma api python sdk, natural language business data queries, company database search sdk, kyb verification and entity lookup, graphql-client, business-intelligence, async-api

[View on SkillFed](https://skillfed.io/packages/enigma-api-client) · [View on PyPI](https://pypi.org/project/enigma-api-client/)