saas.groupSaaS Review Tracker
    guidesg2 reviews api
    G2 logoG2

    Pull G2 reviews and rankings via API or MCP

    G2 does not offer a free public reviews API for arbitrary product profiles. SaaS Review Tracker monitors the G2 profiles you add, stores every review and a daily history of ratings and category positions, and exposes all of it through a REST endpoint and a Model Context Protocol (MCP) server — so Claude, Cursor, ChatGPT or your own script can read G2 data directly.

    What data you can pull

    FieldTypeDescription
    namestringDisplay name of the tracked profile.
    average_ratingnumberCurrent average star rating.
    total_reviewsnumberTotal number of reviews counted on the profile.
    reviews[]arrayIndividual reviews: rating, title, body, author, review date, vendor reply.
    snapshots[]arrayHistorical daily/weekly/monthly snapshots of rating and review count.
    last_scraped_attimestampWhen the profile was last refreshed.
    star_distributionobjectShare of 5/4/3/2/1-star reviews on the profile.
    vendor_replystringVendor response text attached to a review, when present.

    Rankings: G2 category leaderboards: the position your product holds in each tracked G2 category, with the full competitor set and history over time.

    Pull G2 reviews with the REST API

    Every request is authenticated with a personal API key sent in the x-api-key header. The slug parameter is the G2 product slug (from the g2.com/products/<slug> URL).

    List tracked G2 profiles

    curl "https://reviews.saas.group/api/v1/get-entity-data?type=g2" \
      -H "x-api-key: YOUR_API_KEY"

    Get one profile with reviews and history

    curl "https://reviews.saas.group/api/v1/get-entity-data?type=g2&slug=rewardful&include=reviews,snapshots&reviews_limit=25" \
      -H "x-api-key: YOUR_API_KEY"

    Example response

    {
      "success": true,
      "type": "g2",
      "entity": {
        "name": "Rewardful",
        "slug": "rewardful",
        "average_rating": 4.8,
        "total_reviews": 320,
        "last_scraped_at": "2026-08-24T06:00:00Z"
      },
      "reviews": [
        {
          "rating": 5,
          "title": "<review title>",
          "body": "<review body text>",
          "author_name": "<reviewer name>",
          "review_date": "2026-08-21",
          "vendor_reply": "<vendor response, when present>"
    
        }
      ],
      "snapshots": [
        { "average_rating": 4.8, "total_reviews": 318, "scraped_at": "2026-08-17T06:00:00Z" }
      ],
      "reviews_page": { "limit": 25, "returned": 25, "total": 320, "has_more": true, "next_cursor": "eyJkIjoi..." }
    }

    Reviews and snapshots paginate independently. Follow reviews_page.next_cursor and snapshots_page.next_cursor until has_more is false.

    Read G2 data from an AI assistant via MCP

    The Model Context Protocol server lets Claude Desktop, Cursor, ChatGPT, n8n and other MCP clients query the same data in natural language. Endpoint: https://reviews.saas.group/api/v1/mcp

    Client configuration

    {
      "mcpServers": {
        "saas-tracker": {
          "command": "npx",
          "args": [
            "-y", "mcp-remote",
            "https://reviews-mcp.saas.group/mcp",
            "--header", "x-api-key:YOUR_API_KEY"
          ]
        }
      }
    }

    Tool calls for G2

    // get_entity
    { "type": "g2", "slug": "rewardful", "include": ["reviews", "snapshots"], "mode": "summary" }
    
    // list_entities
    { "type": "g2", "limit": 50 }
    
    // add_entity — start tracking a new profile
    { "type": "g2", "identifier": "https://www.g2.com/products/rewardful" }
    
    // get_scrape_status — poll until ready: true
    { "type": "g2", "slug": "rewardful" }
    
    // refresh_entity — queue a fresh scrape (max 1 per 10 min)
    { "type": "g2", "slug": "rewardful" }

    Available tools: list_channels, list_entities, get_entity, list_rankings, add_entity, get_scrape_status and refresh_entity. Once connected you can simply ask, for example, “summarise the newest G2 reviews for Rewardful”.

    list_rankings currently covers Shopify, WordPress, Atlassian, Trustpilot, Capterra and OMR. G2 leaderboards are read in the app.

    Add a new G2 profile via API or MCP

    You can start tracking a profile without opening the app. Pass the public profile URL (or the bare g2 product slug (from the g2.com/products/<slug> url)) to add_entity. Accepted identifier formats: g2.com/products/<slug> or a bare slug. The first scrape runs in the background, so poll get_scrape_status until it returns ready: true before reading reviews. Regular accounts can track up to three profiles in total.

    # 1. start tracking a profile
    curl -X POST "https://reviews.saas.group/api/v1/get-entity-data" \
      -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
      -d '{"action":"add","type":"g2","identifier":"https://www.g2.com/products/rewardful"}'
    
    # 2. poll until the first scrape finishes
    curl -X POST "https://reviews.saas.group/api/v1/get-entity-data" \
      -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
      -d '{"action":"status","type":"g2","slug":"rewardful"}'
    
    # 3. queue a later refresh (max one per 10 minutes)
    curl -X POST "https://reviews.saas.group/api/v1/get-entity-data" \
      -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
      -d '{"action":"refresh","type":"g2","slug":"rewardful"}'

    If the profile is already tracked, the call succeeds with already_exists: true and returns the existing record. A refresh requested within 10 minutes of the last scrape returns 429; a profile another account tracks privately returns 403.

    Access and data scope

    Every account gets REST API and MCP access, and each account uses its own key.

    A key reads the public profiles (saas.group and example profiles) plus the profiles and keywords that account tracks. Profiles you add stay private to you. An administrator can widen an account’s data scope to all tracked entities.

    Create an account to start tracking G2 profiles, then open the API & MCP reference to generate your key.

    See the live G2 data

    G2 API & MCP: frequently asked questions

    Other platforms