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

# Company Research v2

> Deep, cached company intelligence with per-section research, tracking, and Q&A.

## Overview

The Company Research v2 pack performs structured, multi-section research on any company domain, caches the results, and lets you query, track, and render them later. Every section (overview, team, funding, news, signals, etc.) is generated independently, which means you can stream progress, fetch just one slice, or ask follow-up questions without re-running the whole pipeline.

**Use cases**

* Account research before an outbound sequence
* Pre-meeting company briefings
* Monitoring key accounts for news and signals
* Powering an internal "ask anything about this company" assistant

***

## Pack actions

| Stage  | Action                                      | Purpose                                                      |
| ------ | ------------------------------------------- | ------------------------------------------------------------ |
| CR1    | `company_research_v2_start_research`        | Kick off research for a domain; returns a `report_id`.       |
| CR2    | `company_research_v2_get_status`            | Poll for completion inside a loop.                           |
| CR3    | `company_research_v2_get_report`            | Fetch the finished report (optionally with rendered HTML).   |
| CR4    | `company_research_v2_get_section`           | Retrieve a single section (e.g. funding only).               |
| CR5    | `company_research_v2_search_companies`      | Natural-language company search with auto-extracted filters. |
| CR6    | `company_research_v2_track_company`         | Add a domain to the user's tracked list.                     |
| CR8    | `company_research_v2_list_tracked`          | List all tracked companies.                                  |
| CR9    | `company_research_v2_answer_question`       | Answer a custom question using cached data + LLM.            |
| CR10   | `company_research_v2_render_html`           | Render a mobile-friendly HTML report.                        |
| CR11   | `company_research_v2_add_to_hubspot`        | Upsert the company in HubSpot CRM.                           |
| CRQ    | `company_research_v2_ask_domain_question`   | Ask a cached, per-domain question.                           |
| CRQ    | `company_research_v2_get_domain_qa_history` | Retrieve the Q\&A history for a domain.                      |
| CRFull | `company_research_v2_run_full_research`     | Orchestrated pipeline — full report in one call.             |

## Typical flow

```mermaid theme={null}
graph LR
  A[start_research<br/>domain] --> B[get_status<br/>poll loop]
  B --> C[get_report]
  C --> D[render_html]
  C --> E[add_to_hubspot]
  C --> F[ask_domain_question]
```

## Quick start

### Orchestrated (single call)

Use `company_research_v2_run_full_research` when you want the full JSON payload without juggling polling. It blocks until the report is ready.

### Granular (recommended for builder agents)

1. **Start** with `start_research` — stores results in `{{ report_id }}`.
2. **Poll** with `get_status` inside a `For Loop` until `is_complete` is `true`.
3. **Fetch** with `get_report` and render it using `render_html` or push it into `add_to_hubspot`.
4. **Follow up** with `ask_domain_question` to query the cached data.

## Related

* [Competitive Brief](/agent-packs/competitive-brief) — narrower, head-to-head view.
* [Prospect Research](/agent-packs/prospect-research) — person-level intelligence.
* Full endpoint details in the [API Reference](/api-reference).
