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

# G2

> Integrate Mavera with G2 — review sentiment personas, competitor review mining, brand voice refinement, social proof content, feature request focus groups, and market positioning tracking

## Overview

Pull data from **G2** (Reviews, Competitors, Recommendations, Feature Requests, Scores) → analyze with **Mavera** (Personas, Focus Groups, Brand Voice, Mave Agent, Generate) → turn buyer-generated review data into persona-validated messaging, competitive intelligence, and product strategy.

<Info>
  **G2 API** — Base URL: `https://data.g2.com/api/v1/`. Auth: `Token token={key}` in the `Authorization` header. Rate limits: **100 requests/second**. Pagination via `page[number]` and `page[size]` query params.
</Info>

***

## Prerequisites

<Steps>
  <Step title="G2 API key">Obtain from your G2 account manager or the G2 API portal. Requires a G2 paid plan with API access enabled.</Step>
  <Step title="Mavera API key">Get your key from [Mavera dashboard](https://app.mavera.io/settings/api-keys).</Step>

  <Step title="Environment variables">
    ```bash theme={"dark"}
    export G2_API_KEY="your_g2_api_key"
    export MAVERA_API_KEY="mvra_live_xxxxx"
    ```
  </Step>
</Steps>

***

## Jobs

| # | Job                                                                              | G2 Data                           | Mavera Surface                        | Output                            |
| - | -------------------------------------------------------------------------------- | --------------------------------- | ------------------------------------- | --------------------------------- |
| 1 | [Review Sentiment → Persona-Specific Messaging](review-persona-messaging)        | Survey responses by reviewer role | Custom Personas + Generate            | Role-targeted marketing content   |
| 2 | [Competitor Review Mining](competitor-review-mining)                             | Competitor reviews                | Mave Agent                            | Positioning opportunity analysis  |
| 3 | [Love/Hate → Brand Voice Refinement](love-hate-brand-voice)                      | Love/hate phrases                 | Brand Voice (preferred + avoid terms) | Refined brand voice profile       |
| 4 | [Recommendation Quotes → Social Proof Content](social-proof-content)             | Recommendations                   | Generate                              | Social proof marketing assets     |
| 5 | [Feature Request Aggregation → Product Focus Group](feature-request-focus-group) | Feature requests                  | Focus Groups (Ranking)                | Prioritized feature roadmap input |
| 6 | [G2 Score Tracking → Market Positioning](score-tracking-positioning)             | Ratings + rankings                | Mave Agent                            | Messaging adjustments             |

***

## Rate Limits & Production Notes

| G2 Endpoint      | Limit                                      | Strategy                                           |
| ---------------- | ------------------------------------------ | -------------------------------------------------- |
| All endpoints    | 100 req/sec                                | Generous limit; batch pagination with 100ms delays |
| Survey responses | Paginate via `page[size]` + `page[number]` | Max 100 per page                                   |
| Product data     | Single product per call                    | Cache product/competitor data daily                |

<Warning>
  G2 API access requires a **paid G2 plan** with API access enabled. Contact your G2 account manager to activate API credentials. Free/trial accounts do not have API access.
</Warning>

**Checklist:**

* Auth header format: `Token token={key}` (not Bearer)
* Content type: `application/vnd.api+json` (JSON:API format)
* Paginate with `page[number]` and `page[size]` (max 100)
* Cache competitor data — it changes slowly (weekly refresh is sufficient)
* Store G2 scores historically for trend analysis
* Monitor Mavera credits at [Dashboard](https://app.mavera.io/settings/usage)

***

<CardGroup cols={3}>
  <Card title="All Integrations" icon="plug" href="/integrations" />

  <Card title="G2 API Docs" icon="chart-bar" href="https://data.g2.com/api/docs" />

  <Card title="Personas" icon="user" href="/features/personas" />

  <Card title="Focus Groups" icon="users" href="/features/focus-groups" />

  <Card title="Brand Voice" icon="microphone" href="/features/brand-voice" />

  <Card title="Mave Agent" icon="brain" href="/features/mave-agent" />
</CardGroup>