# SavvyIQ documentation

AI agents research and resolve business entities in real-time, going beyond static databases to find hard-to-locate businesses with minimal web presence.

## Getting started

- [Quickstart](https://savvyiq.ai/docs/quickstart.md) — Resolve a company name to a verified legal entity, read its full record, and look up the business behind a domain. Three calls, five minutes.
- [Authentication](https://savvyiq.ai/docs/authentication.md) — Authenticate with the SavvyIQ APIs using an API key sent in the apikey header of every request.
- [Understanding API responses](https://savvyiq.ai/docs/handling-responses.md) — How to read a resolution result. Which of entity and candidate is populated, what status and match_confidence mean, and what factors, actions and basis carry.
- [Rate limits](https://savvyiq.ai/docs/rate-limits.md) — 600 requests per minute per account, counted per endpoint; 100 per minute on run polling.

## APIs

- [Entity Resolution API](https://savvyiq.ai/docs/apis/entity-resolution.md) — Turn a company name plus context into one verified legal entity, anchored to a government registration, with a match confidence, the factors behind it, and per-field citations.
- [Business Intelligence API](https://savvyiq.ai/docs/apis/business-intelligence.md) — Read the full record for a resolved entity by its siq_ ID. Firmographics, industry codes, operational presence, social profiles, identifiers. One GET, never blocks.
- [Domain Intelligence API](https://savvyiq.ai/docs/apis/domain-intelligence.md) — Identify the legal entity that operates a domain, website URL, or email address, and what the domain itself is for. One GET; answers in seconds for a domain we hold.
- [Entity Hierarchy API](https://savvyiq.ai/docs/apis/entity-hierarchy.md) — AI-researched upward ownership for any resolved entity. Ownership chains, parent companies, and the ultimate controlling entity, with evidence sources.

## Guides

- [Batch processing](https://savvyiq.ai/docs/guides/batch-processing.md) — Resolve thousands of company names with the v3 async API. Submit with custom_id, collect by polling or by webhook, and keep every row accounted for. Complete scripts in JavaScript and Python.
- [Handling messy data](https://savvyiq.ai/docs/guides/handling-messy-data.md) — Entity names arrive embedded in legal documents, concatenated with tax IDs, or in mixed scripts. Examples of inputs Entity Resolution parses, and how to phrase a query.
- [Migrate from BigPicture to SavvyIQ](https://savvyiq.ai/docs/guides/migration-from-bigpicture.md) — Move your BigPicture API integration to SavvyIQ. Endpoint mapping, auth changes, response shapes, and side-by-side code samples.
- [Webhooks](https://savvyiq.ai/docs/guides/webhooks.md) — A v3 feature. Pass webhook_url on a v3 request and we POST a signed event when it finishes, instead of you polling.

## Concepts

- [Entities and candidates](https://savvyiq.ai/docs/concepts/entities-and-candidates.md) — Every resolution response carries an entity or a candidate. Which one you get, and what it means for your integration.
- [Confidence scoring](https://savvyiq.ai/docs/concepts/confidence-and-explainability.md) — Understanding how SavvyIQ calculates confidence scores for entity matches
- [Identifiers](https://savvyiq.ai/docs/concepts/identifiers.md) — Understanding SavvyIQ's three-level identifier system and how to use entity IDs consistently across all APIs
- [Data sources](https://savvyiq.ai/docs/concepts/data-sources.md) — Understanding how SavvyIQ sources and maintains business entity data through government databases, AI agents, and real-time research

## API reference

- [All endpoints](https://savvyiq.ai/docs/reference/index.md)