> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryhuntr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Choose the right Huntr API workflow for your GTM goal.

> ## Documentation Index
>
> Fetch the complete documentation index at `/llms.txt` on your docs host.
> Use this file to discover all available pages before exploring further.

## Start with your goal

Huntr is a **GTM intelligence API** — one layer for company and people discovery, contact enrichment, web research, and agent-led research. You can call it from your product, Clay table, n8n flow, or AI agent.

There are two ways to work with Huntr:

1. **`POST /research`** — give one focused objective; Huntr investigates and returns an answer (free text or structured fields).
2. **Direct endpoints** — when you already know the exact data you need (a company list, a work email, a tech stack, a careers page).

<Note>
  `/research` is for **one account, person, team, or business question**. If you need to discover and enrich **many** companies or people, use list-building and enrichment endpoints instead. Bulk workflows that exceed the research budget return `422 BULK_ENRICHMENT_REQUIRED` and are **not charged**.
</Note>

<Columns cols={2}>
  <Card title="Research Agent" icon="file-magnifying-glass" href="/guides/research-agent" cta="Open guide">
    Turn an account plan, buyer brief, diligence question, or buying-signal investigation into a researched answer — markdown or structured to your field map.
  </Card>

  <Card title="Company Search" icon="building" href="/guides/company-search" cta="Open guide">
    Build targeted company lists with structured filters — industry, location, headcount, domain, and more. Preview counts for free.
  </Card>

  <Card title="Person Search" icon="users" href="/guides/person-search" cta="Open guide">
    Find people by title, employer, skills, school, and location. Prefer `currentCompanyWebsite` when you know the domain.
  </Card>

  <Card title="Company Enrichment" icon="chart-line" href="/guides/company-enrichment" cta="Open guide">
    Pull LinkedIn company profiles, tech stack, site contacts, and job listings for accounts you already have.
  </Card>

  <Card title="Contact Enrichment" icon="envelope" href="/guides/contact-enrichment" cta="Open guide">
    Find work emails and LinkedIn profile data for individuals — repeatable, per-person lookups for outbound workflows.
  </Card>

  <Card title="Web Research" icon="globe" href="/guides/web-research" cta="Open guide">
    Find relevant pages on a domain, scrape public page content, or run structured analysis on a single URL.
  </Card>

  <Card title="Huntr MCP" icon="robot" href="/build-with-ai/huntr-mcp" cta="Connect MCP">
    Give Cursor, Claude, Codex, or ChatGPT the full Huntr API as MCP tools — research, search, enrichment, and page ops from your editor.
  </Card>

  <Card title="Huntr Skills" icon="wand-magic-sparkles" href="/build-with-ai/huntr-skills" cta="Explore skills">
    Install ready-made GTM workflows that plan Huntr tool calls, quote costs, wait for approval, and update CSV after every result.
  </Card>

  <Card title="Clay & Automations" icon="puzzle-piece" href="/integrations/clay" cta="See integrations">
    Use Huntr inside Clay, n8n, Make, or Zapier without moving your workflow into another platform.
  </Card>
</Columns>

## Typical GTM workflows

**Account research before outreach**

1. `POST /research` for a concise account brief on one target, **or**
2. `POST /company-linkedin` + `POST /company-jobs` + `POST /company-tech-stack` when you want deterministic fields.

**Build a prospect list**

1. `POST /company-search-count` to preview list size (free).
2. `POST /company-search` with pagination tokens to walk results.
3. `POST /person-search` scoped to each company's domain.
4. `POST /person-email` for contacts you want to reach.

**Power an AI agent or internal tool**

1. Connect [Huntr MCP](/build-with-ai/huntr-mcp) in your editor or agent runtime.
2. Use the `research` tool for open-ended questions and direct tools for known lookups.

## Authentication

```bash theme={null}
export HUNTR_API_KEY="hntr_live_xxxxxxxxxxxx"

curl https://api.tryhuntr.com/balance \
  -H "x-api-key: ${HUNTR_API_KEY}"
```

Create a key from the [dashboard](https://tryhuntr.com/dashboard) or via email verification. See [Authentication](/authentication) for the full signup and recovery flow.

## Base URL

```text theme={null}
https://api.tryhuntr.com
```

Authenticated endpoints require `x-api-key`. Public endpoints (`/pricing`, `/health`, `/keys/create`) work without a key.

## Next step

* [Quickstart](/quickstart) — first API call in under 5 minutes
* [Choose your workflow](/concepts/choose-your-workflow) — research agent vs direct endpoints
* [Research Agent guide](/guides/research-agent) — account and buyer briefs
* [Company Search guide](/guides/company-search) — build ICP lists
* [Huntr MCP](/build-with-ai/huntr-mcp) — use from Cursor or Claude
* [Huntr Skills](/build-with-ai/huntr-skills) — ready-made GTM workflows for AI agents
* [API Reference](/api-reference) — full request and response schemas