enigma-api-client

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 on this page — 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

enigma-api-client on PyPI

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

Evidence: enigma_api_client-0.7.11-py3-none-any.whl

Tags

More WWW/HTTP packages