> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/actions/workflow-concepts/workflow-steps/b2b-enrichment/g2.md).
# G2
The G2 Integration step allows you to connect your AirOps workflows directly with your G2 account. This integration enables you to pull product data, reviews, and survey questions from G2 programmatically.
{% hint style="info" %}
This integration connects to G2's **Data API**, which is a separate, paid G2 product. It is not the same as the public g2.com website, and it only returns the products your G2 account is licensed to access. Being able to find a product on g2.com does not mean it is available through the API. If your G2 plan does not include Data API access, or no products are mapped to your account, actions will return no results. Confirm your access with your G2 administrator.
{% endhint %}
## How to Configure the G2 Integration Step
### Authentication
Before using the G2 integration in your workflows, you must first connect your G2 account in the AirOps Settings:
1. Open **Settings → Integrations**.
2. Find the **G2** section and click **Configure**.
3. Complete the OAuth authentication process by granting AirOps the necessary permissions.
### MCP Connectors and Playbooks
You can also connect G2 through **Settings → MCP Connectors** and use it in Playbooks. AirOps uses its OAuth app for the standard connector flow.
1. Open **Settings → MCP Connectors** and connect **G2**.
2. Open the Playbook editor.
3. Open the **Tools** panel and turn on **G2**.
4. Describe what G2 review data the Playbook should use during the content creation run.
Use your own G2 OAuth app
If your team uses its own scoped OAuth app, complete the advanced setup before you continue the G2 OAuth flow in AirOps.
1. In My.G2, open your G2 OAuth app and find the client ID and secret ID.
2. In AirOps, paste both values into **Advanced OAuth client settings**.
3. Click **Save**, then copy the AirOps callback URL: `https://app.airops.com/api/mcp_connectors/oauth/callback`.
4. Return to the G2 OAuth app in My.G2 and add the callback URL to the redirect URIs.
5. Return to AirOps and continue the OAuth flow.
### Action Types
The G2 Integration supports the following actions:
* **Get Products**: Retrieve a list of products listed on G2
* **Search Products**: Search for G2 products by keyword or topic
* **Get Survey Questions**: Retrieve the definitions of the questions G2 asks in product surveys. This does not return review answers. Use **Get Reviews** for the written feedback reviewers left.
* **Get Reviews**: Retrieve reviews for a specific product
### Action-Specific Parameters
**Get Products**
* **Product Name (Optional)**: Filter by exact product name (e.g. `Salesforce`)
* **Slug (Optional)**: Filter by G2 product URL slug (e.g. `salesforce-crm`)
* **Search Query (Optional)**: Free-text search across product names (e.g. `CRM`)
* **Page Size (Optional)**: Number of results per page (max 100, default 10)
* **Page Number (Optional)**: Page number to retrieve (default 1)
**Search Products**
* **Keyword (Required)**: Search for G2 products by keyword or topic (e.g. `CRM`, `project management`)
* **Page Size (Optional)**: Number of results per page (max 100, default 10)
* **Page Number (Optional)**: Page number to retrieve (default 1)
**Get Survey Questions**
* **Updated After (Optional)**: Return questions updated after this date (RFC3339 format, e.g. `2024-01-01T00:00:00Z`)
* **Updated Before (Optional)**: Return questions updated before this date (RFC3339 format)
* **Page Size (Optional)**: Number of results per page (max 100, default 10)
* **Page Number (Optional)**: Page number to retrieve (default 1)
**Get Reviews**
* **Product ID (Required)**: The G2 product UUID to fetch reviews for (e.g. `5079d5b8-c6f0-4b0e-96a9-44b8c9d3a6f1`). This is not the product name. To find it, run a **Get Products** or **Search Products** step first, then copy the `id` of the product you want from its results.
* **Created After (Optional)**: Return reviews created after this date (RFC3339 format, e.g. `2024-01-01T00:00:00Z`)
* **Created Before (Optional)**: Return reviews created before this date (RFC3339 format)
* **Updated After (Optional)**: Return reviews updated after this date (RFC3339 format)
* **Updated Before (Optional)**: Return reviews updated before this date (RFC3339 format)
* **Minimum Stars (Optional)**: Return only reviews with a star rating at or above this value (1–5)
* **Maximum Stars (Optional)**: Return only reviews with a star rating at or below this value (1–5)
* **Page Size (Optional)**: Number of results per page (max 100, default 10)
* **Page Number (Optional)**: Page number to retrieve (default 1)
## What the Step Returns
Each action returns a simplified response:
* **data**: the list of records found (products, reviews, or survey questions).
* **record\_count**: the total number of matching records.
* **links**: `next` and `prev` pagination links, when available.
* **message**: included only when `data` is empty, explaining the most likely cause (see "Why am I not getting any results?" below).
For **Get Survey Questions**, `data` contains G2's survey question definitions, and `record_count` reflects the total number of questions across G2's catalog, not a count scoped to a product.
## Common Use Cases
* Searching for competitor products by keyword and pulling their reviews for competitive analysis
* Filtering reviews by star rating to surface promoter or detractor feedback at scale
* Summarizing customer feedback with an AI step to surface key themes
* Monitoring sentiment trends over time using date-filtered review data
* Enriching content with real social proof and review quotes from G2
## Why am I not getting any results?
If an action runs successfully but returns no products or reviews, it almost always means the connected G2 account has nothing to return, not that the step is broken. The most common causes are:
* **Your G2 plan does not include Data API access.** This integration uses G2's paid Data API. A standard or free G2 login does not have this access.
* **No products are mapped to your account.** The API only returns products your account is licensed to access, which are mapped on G2's side (for example via the G2 Partner Dashboard). It does not search the full public g2.com catalog.
* **You are looking for a product you do not own.** Pulling other companies' products and reviews (for competitive research) requires broader catalog access in your G2 agreement.
In all of these cases, the fix is on the G2 side. Confirm with your G2 administrator or account representative what your Data API access includes and that the products you need are mapped to your account.
## Error Handling
By default, the G2 Integration step will terminate the workflow if it fails. You can configure it to continue by selecting "Continue" instead of "Terminate Workflow" in the step settings.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.airops.com/actions/workflow-concepts/workflow-steps/b2b-enrichment/g2.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.