Skip to Content

Connect G2 to Your AI Agent

Find products, browse categories and read customer feedback from G2.

59 toolsAPI key

20,000 free app calls every month(paid services billed separately)

Try a G2 Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo SkillG2

Find software products

Search products and inspect their categories and ratings.

/oo G2: Find G2 products matching my category and compare their ratings.

Read customer feedback

Retrieve reviews and filter by company size, geography or rating.

/oo G2: Read G2 reviews for this product and summarize recurring feedback, preserving source links.

Start Working with G2

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect G2

    Connect a G2 API Token.

    Connect G2→
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →
  • Generate a User or Organization token at https://my.g2.com/developers under Access Tokens.
  • Enable the endpoint permissions needed by your workflow. Data access depends on your G2 product licenses and subscription.
  • Tokens expire one year after creation and must be regenerated.
  • Connecting validates your token with a one-record category query; it does not verify product or review entitlements.
  • Pass nextCursor as after or previousCursor as before, retaining the other filters. Each call retrieves one page.
  • Market Intelligence reviews use a separate endpoint. Query competitor product IDs from meta separately.
  • Activate unlocks consume credits; inspect meta.skipped for per-item failures even with HTTP 200.
  • Badge listings use pageNumber pagination; other paginated endpoints expose cursors where supported.
  • Submitting a review requires explicit termsAccepted and privacyPolicyAccepted choices. Some account and review endpoints have restricted access; Data Solutions is beta.

G2 Tools

Access the API Token capabilities of G2 Seller, Buyer and Data Solutions APIs. Search catalogs, reviews, features and reports; query buyer intent and credits; configure Activate and unlock companies; manage research boards, mappings and your own reviews. Access depends on endpoint permissions and subscription.

Product catalog and categories

Search and retrieve software products and categories.

Product reviews

Retrieve standard, removed and Market Intelligence reviews permitted by your subscription.

Catalog resources and reports

Read vendors, media, features and reports, and manage product mappings.

Buying signals and Activate

Query buying signals and credits, configure Activate and unlock companies.

Research boards

Create and organize software research boards.

Review workflows

Read and submit your own reviews, and retrieve licensed Data Solutions reviews.

59 tools

List Products

Search G2 products by name, category, domain, rating or other filters. Requires products.read permission.

g2.list_products

Get Product

Get a G2 product by UUID or slug. Requires products.read permission.

g2.get_product

List Categories

List G2 categories with name, slug and date filters.

g2.list_categories

Get Category

Get a G2 category by UUID or slug, optionally including related categories and products.

g2.get_category

List Product Reviews

List standard or removed G2 product reviews. Requires products.reviews.read and the corresponding product license.

g2.list_product_reviews

List Market Intelligence Reviews

List Market Intelligence reviews for one product. Requires products.reviews.read and Market Intelligence access; competitor products in meta must be queried separately.

g2.list_market_intelligence_reviews

List Screenshots

Lists screenshots. **Requires `screenshots.read` scope.**

g2.list_screenshots

Get Screenshot

Shows a screenshot. **Requires `screenshots.read` scope.**

g2.get_screenshot

List Category Features

List features for a specific category. **Requires `product_features.read` scope.**

g2.list_category_features

List All Category Features

List all category product features grouped by category. **Requires `product_features.read` scope.**

g2.list_all_category_features

List Product Mappings

List of product mappings. **No scope required.**

g2.list_product_mappings

Create Product Mapping

Create a product mapping. **No scope required.**

g2.create_product_mapping

Update Product Mapping

Update a product mapping. **No scope required.**

g2.update_product_mapping

Get Product Ratings

A product's ratings. **Requires `products.ratings.read` scope.**

g2.get_product_ratings

List Product Screenshots

Lists Screenshots related to given product. **Requires `products.screenshots.read` scope.**

g2.list_product_screenshots

List Product Downloads

Lists Downloads related to given product. **Requires `products.downloads.read` scope.**

g2.list_product_downloads

List Product Competitors

Lists competitors related to given product. **No scope required.**

g2.list_product_competitors

List Product Discussions

Lists discussions related to given product. **Requires `products.discussions.read` scope.**

g2.list_product_discussions

List Product Integration Reviews

Lists integration reviews for given product. **Requires `integration_reviews.read` scope.**

g2.list_product_integration_reviews

List Product Badges

Lists medals (badges) awarded to given product. **Requires `product.badges.read` scope.**

g2.list_product_badges

List Product Features

List features for a specific product. **Requires `product_features.read` scope.**

g2.list_product_features

List All Product Features

List all product features grouped by product. **Requires `product_features.read` scope.**

g2.list_all_product_features

List Product Video Reviews

Lists video reviews related to given product. **Requires `products.video_reviews.read` scope.**

g2.list_product_video_reviews

List Product Videos

Lists videos related to given product. **Requires `products.videos.read` scope.**

g2.list_product_videos

List Questions

List of questions. **Requires `questions.read` scope.**

g2.list_questions

Get Question

Shows a single question. **Requires `questions.read` scope.**

g2.get_question

List Product Snippets

Lists reviews of given product. **Requires `products.snippets.read` scope.**

g2.list_product_snippets

List Owned Products

List all products owned by current account. **⚠️ G2 is currently restricting access to this endpoint.** This endpoint shows subscription-specific product information, of products that the current account has ownership of.

g2.list_owned_products

List Vendors

List of vendors. **Requires `vendors.read` scope.**

g2.list_vendors

Get Vendor

Shows a single vendor. **Requires `vendors.read` scope.**

g2.get_vendor

Query Sandbox Buyer Intent

Browse sandbox buyer intent interactions for a product. **No scope is required to access this sandbox endpoint** **⚠️ Sandbox API**: This endpoint is a sandbox endpoint and is data limited. Only data between 6 months to 1 year ago will be available. Query buyer intent data using an analytical query interface. ## Query Language This endpoint uses an OLAP-style query language that supports: - **Dimensions**: Group and categorize data (e.g., company_name, company_domain, day) - **Measures**: Aggregate numerical values (e.g., total_activity, visitor_count) - **Filters**: Apply conditions to limit results ### Filter Operators Filters use the format `dimension_filters[name_suffix]` where `name` is the dimension name and `suffix` indicates the operation: - `_eq`: Equals (exact match) - `_not_eq`: Not equals - `_cont`: Contains (substring match) - `_not_cont`: Does not contain - `_gt`: Greater than - `_gteq`: Greater than or equal - `_lt`: Less than - `_lteq`: Less than or equal - `_present`: Field has a value - `_empty`: Field is empty ### Time Series vs Aggregated Data - **Aggregated**: Request dimensions without `day` for company-level summaries - **Time Series**: Include `day` dimension for daily breakdowns over time ### Sorting Results Use the `sort` parameter to order results by any dimension or measure: - **Ascending**: `sort=company_name` or `sort=total_activity` - **Descending**: `sort=-company_intent_score` (prefix with `-`) - **Default**: Results are sorted by `-company_intent_score` (highest intent first) Available sort fields include all dimensions and measures listed above. ### Examples - Company summary: `dimensions=company_name,company_domain&measures=total_activity` - Time series: `dimensions=company_name,day&measures=company_intent_score` - Filtered: `dimension_filters[company_name_cont]=Acme&dimensions=company_name` - Sorted by activity: `dimensions=company_name&measures=total_activity&sort=-total_activity`

g2.query_sandbox_buyer_intent

Query Buyer Intent

Browse buyer intent interactions (product-agnostic). **Requires `buyer_intent.read` scope.** Query buyer intent data across one or more products in a single request. Pass product_id to specify which products, or omit to use your assigned products. Supports multi-product queries — the data is not scoped to a single subject product.

g2.query_buyer_intent

Query Product Buyer Intent

Browse buyer intent interactions for a product. **Requires `buyer_intent.read` scope.** Query buyer intent data using an analytical query interface. ## Query Language This endpoint uses an OLAP-style query language that supports: - **Dimensions**: Group and categorize data (e.g., company_name, company_domain, day) - **Measures**: Aggregate numerical values (e.g., total_activity, visitor_count) - **Filters**: Apply conditions to limit results ### Filter Operators Filters use the format `dimension_filters[name_suffix]` where `name` is the dimension name and `suffix` indicates the operation: - `_eq`: Equals (exact match) - `_not_eq`: Not equals - `_cont`: Contains (substring match) - `_not_cont`: Does not contain - `_gt`: Greater than - `_gteq`: Greater than or equal - `_lt`: Less than - `_lteq`: Less than or equal - `_present`: Field has a value - `_empty`: Field is empty ### Time Series vs Aggregated Data - **Aggregated**: Request dimensions without `day` for company-level summaries - **Time Series**: Include `day` dimension for daily breakdowns over time ### Sorting Results Use the `sort` parameter to order results by any dimension or measure: - **Ascending**: `sort=company_name` or `sort=total_activity` - **Descending**: `sort=-company_intent_score` (prefix with `-`) - **Default**: Results are sorted by `-company_intent_score` (highest intent first) Available sort fields include all dimensions and measures listed above. ### Signal Types The `signal_type` dimension identifies the type of buyer activity on G2 (e.g., `profile`, `pricing`, `compare`). ### Competitive Signals Results include activity on both your product and competitor products in your categories. Compare `left_product_id` to `subject_product_id` to distinguish the two: - **`left_product_id` = `subject_product_id`**: Direct signal — activity on your product. - **`left_product_id` ≠ `subject_product_id`**: Competitive signal — activity on a competitor. The `signal_type` indicates what the buyer did (e.g., viewed the competitor's `profile` or `pricing` page). Use `left_product_name` / `left_product_slug` to identify the competitor. ### Examples - Company summary: `dimensions=company_name,company_domain&measures=total_activity` - Time series: `dimensions=company_name,day&measures=company_intent_score` - Filtered: `dimension_filters[company_name_cont]=Acme&dimensions=company_name` - Sorted by activity: `dimensions=company_name&measures=total_activity&sort=-total_activity` - Competitive activity: `dimensions=company_name,signal_type,left_product_name,left_product_id&measures=total_activity`

g2.query_product_buyer_intent

Get Activate Settings

Retrieves G2 Activate settings for a product. **Requires `g2_activate.read` scope.**

g2.get_activate_settings

Update Activate Settings

Updates G2 Activate settings for a product. **Requires `g2_activate.write` scope.**

g2.update_activate_settings

Search Activate Industries

Match a free-text business description to NAICS industry names. **Requires `g2_activate.read` scope.**

g2.search_activate_industries

List Locked Companies

Lists locked companies (masked) showing intent for a product. **Requires `g2_activate.read` scope.**

g2.list_locked_companies

Unlock Companies

Spends G2 Activate credits to unlock one or more locked companies. **Requires `g2_activate.write` scope.** Accepts 1-25 opaque `sig` tokens from the locked_companies response and spends credits to reveal each company's identity. Always returns 200 — per-sig failures land in `meta.skipped[]` rather than as HTTP errors. Idempotent: replaying an already-unlocked sig costs 0 credits and returns the existing record.

g2.unlock_companies

List Unlocked Companies

Lists unlocked companies for a product. **Requires `g2_activate.read` scope.**

g2.list_unlocked_companies

Get Unlocked Company

Shows a single unlocked company with resolved contacts. **Requires `g2_activate.read` scope.**

g2.get_unlocked_company

List Market Signals

Retrieve buyer intent signals for a date range. **Requires `market_signals.read` scope.** Retrieve buyer intent signals (interactions) for specific categories. Returns one result per buyer intent interaction within the specified date range. Each interaction includes the category UUID, company name, and domain. If no dates are provided, defaults to today for both start and end date. Results are paginated using cursor-based pagination (default 25, max 250 per page).

g2.list_market_signals

Get Credit Account

Retrieve credit account details for an organization. **No scope required.** Retrieve API metering credit account details including balance and total credits. Use `?include=deductions` to include the last month of deductions in the response.

g2.get_credit_account

List Credit Deductions

Retrieve aggregated credit deductions by month and year. **No scope required.** Retrieve credit account deductions aggregated by month and year. Use filter parameters to narrow results: - `filter[month]`: Filter by month (1-12) - `filter[year]`: Filter by year (e.g., 2024)

g2.list_credit_deductions

List Data Subscriptions

Lists data subscriptions for given partner and account. **Requires `data_subscriptions.read` scope.** Data Subscriptions require a Partner ID and appropriate scope. Contact G2 for a unique Partner ID.

g2.list_data_subscriptions

Get Report

Get a licensed report and its product snapshots. **Requires `reports.read` scope.** The report type selects the response shape: `grid` returns `grid_reports` with Grid product scores; `momentum` returns `momentum_reports` with Momentum Grid product scores; `implementation` returns `implementation_reports` with Implementation Index scores; `relationship` returns `relationship_reports` with Relationship Index scores; `results` returns `results_reports` with Results Index scores; `usability` returns `usability_reports` with Usability Index scores. Add `include=report_products` to receive the product snapshots. Unsupported report types do not match a route (404).

g2.get_report

List Reports

Discover licensed Grid, Momentum, Usability, Implementation, Results and Relationship reports. Lists released Grid, Momentum, Usability, Implementation, Relationship, and Results report snapshots accessible through claimed or owned products. Each item is a reports resource with a report_type attribute; sparse fields use fields[reports]. Requires reports.read and an active report entitlement. One-off purchases do not require a Content Access subscription. Year is the named report season year (for example Winter 2025), not the calendar-quarter label. The legacy product-ID endpoint remains unchanged.

g2.list_reports

List Research Boards

List research boards for current user.

g2.list_research_boards

Create Research Board

Create a research board.

g2.create_research_board

Get Research Board

Get a research board.

g2.get_research_board

Update Research Board

Update a research board.

g2.update_research_board

Delete Research Board

Delete a research board.

g2.delete_research_board

List Research Board Products

List products on a research board.

g2.list_research_board_products

Add Research Board Product

Add a product to a research board.

g2.add_research_board_product

Add Research Board Products

Add multiple products to a research board.

g2.add_research_board_products

Remove Research Board Products

Remove multiple products from a research board.

g2.remove_research_board_products

Remove Research Board Product

Remove a product from a research board.

g2.remove_research_board_product

Get My Product Review

Show review for a product. **⚠️ G2 is currently restricting access to this endpoint.** This endpoint retrieves the review for a specific product owned by the current user.

g2.get_my_product_review

Submit Product Review

Submit or update a review for a product. **⚠️ G2 is currently restricting access to this endpoint.** This endpoint allows the user to submit or update a review for a specific product. The review is based on predefined questions and answers.'

g2.submit_product_review

List Data Solutions Reviews

Lists reviews with all Data Solutions fields. **Requires `ds_reviews.read` scope.** **⚠️ BETA API**: This endpoint is a beta endpoint and it definition might change by the official release.

g2.list_data_solutions_reviews

Frequently Asked Questions

Does a token unlock all G2 reviews?

No. Endpoint permissions, product access and your G2 subscription determine the available data. Market Intelligence requires the corresponding entitlement.