# HG Insights API Documentation

## Explore the Docs

- **[Guides](/v2/guides/overview)** — Authentication, rate limiting, error handling, and integration patterns to get you up and running.
- **[API Reference](/v2/openapi)** — Full endpoint documentation with request/response schemas, parameter descriptions, and interactive console.
- **[Legacy v1 API](/v1/openapi)** — The v1 API is still supported. For new integrations, we recommend using the v2 API.


## Built for Modern Workflows

- **AI Agents & Copilots** — Give your AI agents real-time access to company intelligence for sales copilots, research agents, and lead scoring systems.
- **MCP Compatible** — Works with the [Model Context Protocol](https://modelcontextprotocol.io) — expose company data as a tool any MCP-compatible agent can call directly.
- **On-Demand Enrichment** — Look up company data at the point of need: when a lead comes in, a rep preps for a call, or your app needs fresh context.
- **Batch Processing** — Enrich up to 25 companies per request. Rate limited at 25 requests per second — plenty for real-time and batch workloads.


## HG Data

| Data | Description |
|  --- | --- |
| **Firmographics** | Company name, domain, location, industry, revenue, employee count, and HG rankings |
| **Technographics** | Technology installations including products, vendors, usage intensity, and install dates |
| **IT Spend** | Spending estimates by technology category with detailed category breakdowns |


## FAQ

### Why should I use v2 instead of v1?

v2 was redesigned from the ground up to be simpler, faster, and more flexible.

|  | v1 | v2 |
|  --- | --- | --- |
| **Get company data** | Call separate endpoints for firmographics, installs, and spend | One call to `/companies/enrich` returns everything you need |
| **Find a company** | HG ID only | HG ID or domain like `walmart.com` |
| **Batch enrichment** | One company at a time | Up to 25 companies per request |
| **Manage your keys** | Ask your CSM | Self-serve from [our new platform](https://admin.hginsights.com) |
| **Track usage** | Contact your account team | Self-serve credit usage dashboard |


Already on v1? No rush, your integration keeps working. The [v1 API reference](/v1/openapi) is still fully supported. When you're ready, migrating is straightforward: consolidate your calls into a single enrichment request and generate a new API key from the admin portal.

### What's coming next for v2?

FAI, Intent, and Search endpoints are all coming to v2 in **April 2026**. If you're building a new integration today, start with v2 and you'll get access to these datasets automatically when they launch.

## Feedback & Support

Have questions, feedback, or need help? Reach out to us at [platform@hginsights.com](mailto:platform@hginsights.com).