What is AggKnowledge?
Pick an endpoint by the question you are asking. Behind the API sits a continuously refreshed graph of people, the companies they work for, and the products those companies buy and sell. Every endpoint answers one of three questions:
- Who is this? You have an identifier (a professional social media URL, an email, a domain) and want the full record. That is enrichment: the Enrich and Match families.
- Who is out there? You have criteria instead of identities and want a list. That is Discover.
- What do they use? You want the vendor–customer relationships around a person or company. That is Vendorgraphics.
Which API should I use?#
| I want to… | Start with |
|---|---|
| Fill in missing fields for a person I already know | Person Enrich |
| Resolve a name + employer to a specific person | Person Match |
| Resolve a name to an AggKnowledge Person ID | Person Match |
| Build a list of people matching my ICP (ideal customer profile) | Discover People |
| Get firmographics (company size, industry, revenue…) from a website domain | Company Enrich |
| Find companies that use a specific product | Vendorgraphics |
| Clean up job titles or professional social media URLs first | Normalize Job Title · Normalize LinkedIn URL |
Auth is one header. Every request carries an x-api-key issued by your AggKnowledge account team. The Authentication pages cover keys, headers, and environments.
v2 or v3?#
Start new integrations on v2. v3 launched in June 2026 and gains v2’s support and SLA guarantees only at general availability, planned for January 4, 2027.
Moving later is cheap. The version is a path segment (/v2/ or /v3/) and can be mixed endpoint by endpoint. v3 keeps v2’s request shapes and adds fields, so for most endpoints the move is a path change, not a rewrite.
Exception: the healthcare entities and webhooks exist only on v3. They are available today and mix freely with v2 endpoints. Details in the migration guide.
test environment with deterministic mock responses, so you can build the integration end to end before spending a credit. The Quickstart makes your first call; Credits, Tiers & Environments explains how the environments work.