Skip to main content

1. Overview

The Alternative Datasets APIs provide access to two proprietary third-party data sources that are not captured in standard firmographic or financial databases: G2 product reviews and Glassdoor employee reviews. Both are synchronous GET endpoints that return paginated data immediately in the HTTP response. Two endpoints, two data sources: Common use cases:
  • Pre-IC product due diligence — pull G2 product reviews for a target SaaS company and its top 3 competitors to compare customer satisfaction, identify recurring complaints, and surface NPS signals before a diligence sprint
  • Competitive product benchmarking — compare star distributions and review counts across a set of competitors to quantify perceived product quality at scale
  • Management assessment in CDD — use Glassdoor’s CEO approval rating, senior management score, and business outlook as quantitative proxies for leadership quality and workforce confidence
  • Talent and culture diligence — track culture_and_values_rating, work_life_balance_rating, and recommend_to_friend_rating over time to detect cultural deterioration or post-acquisition integration signals
  • Portfolio health monitoring — run both endpoints quarterly across a portfolio to surface early warning signals in customer perception or employee sentiment before they become widely reported
  • Customer voice analysis — use individual product review text as input to an LLM pipeline for theme extraction, sentiment classification, and feature gap analysis
Both APIs are synchronous. Results are returned directly in the HTTP response — no job submission or polling required.

2. Quick Start

Product Reviews — get G2 reviews for a company
Employee Reviews — get Glassdoor overview and reviews for a company

3. Authentication

All requests must include a Bearer token in the Authorization HTTP header.
API tokens are issued from your Wokelo account. Navigate to Account Details → API Credentials in the Wokelo dashboard to get your client id and client secret. Contact support@wokelo.ai if you do not yet have API access.
Never expose your token in client-side code, browser requests, or public repositories. A missing or invalid token returns 401 Unauthorized. A valid token without sufficient plan permissions returns 403 Forbidden.

4. Request Reference

Product Reviews

Endpoint
All parameters are passed as URL query parameters. Full request example:

Employee Reviews

Endpoint
All parameters are passed as URL query parameters. Full request example:

5. Response

Product Reviews response

Top-level response fields: data object fields:
The star_distribution keys are strings ("1", "2", etc.), not integers. When iterating or sorting, cast to int: sorted(star_distribution.keys(), key=int). The total review count is sum(star_distribution.values()).

Employee Reviews response

Top-level response fields: data object fields: overview fields — two different scales:
The overview object mixes two different scales. business_outlook_rating, ceo_rating, and recommend_to_friend_rating are approval ratios between 0.0 and 1.0 (e.g. 0.82 = 82% approval). All other rating fields (rating, compensation_and_benefits_rating, culture_and_values_rating, etc.) are scores on a 1.0–5.0 scale. Never display these raw without applying the correct scale — multiplying a ratio field by 5 to fit a star display will produce incorrect results.

6. Examples

Competitive product sentiment sweep

Fetch G2 ratings for a set of competing SaaS products and compare overall scores and star distributions.
Sample response (product reviews — Salesforce/Slack):

Paginating through all product reviews for LLM analysis

Retrieve the full review corpus for downstream theme extraction or sentiment analysis.

Employee sentiment benchmark — portfolio health check

Compare Glassdoor ratings across a portfolio of companies to surface cultural warning signals.
Sample response (employee reviews — Salesforce):

Combined product + employee sweep before IC meeting

Pull both data sources for a target company in two parallel calls to get a fast 360-degree view.

JavaScript / Node.js — both endpoints


7. Error Handling

Both APIs use standard HTTP status codes and return errors synchronously. Retry logic with exponential back-off:

8. Best Practices

Use permalinks, not company names or URLs Both endpoints accept only the company permalink as an identifier — not a display name or website URL. Use the Company Search API to resolve a name to its permalink before querying:
star_distribution keys are strings — sort and access accordingly The five keys in star_distribution are string values "1" through "5", not integers. When iterating in order or computing a weighted average, cast to int explicitly:
Employee review overview uses two different scales — display them correctly Three fields (business_outlook_rating, ceo_rating, recommend_to_friend_rating) are approval ratios between 0.0 and 1.0. The remaining five rating fields are on a 1.0–5.0 scale. Multiply ratio fields by 100 to display as percentages; never multiply by 5:
Fetch overview without individual reviews by setting limit=1 When you only need aggregate metrics (overall rating, star distribution, Glassdoor overview scores), set limit=1 to return a minimal review payload. The overview and star_distribution aggregate fields are always present regardless of limit:
Paginate correctly for full-corpus review pulls Both endpoints return up to limit reviews per call (default 100). When building a full review corpus for LLM or NLP processing, paginate using offset and stop when the returned reviews array is empty:
Run both endpoints in parallel for pre-IC snapshots Both are synchronous and independent — fire them concurrently with concurrent.futures.ThreadPoolExecutor or asyncio to halve the total latency when you need both product and employee data:
Guard against missing companies — not all companies have review data G2 and Glassdoor coverage is concentrated in software and technology companies. For companies in industrial, financial, or other non-software sectors, review data may be absent. A 404 response or an empty reviews array with null rating fields indicates no data is indexed for that company:

Company Instant Enrichment

Structured firmographic, funding, and financial data from Wokelo’s native database — synchronous, results within seconds.

Company Deep Intelligence

AI-synthesised product portfolio, strategic initiative, and sentiment analysis — includes employee_sentiment and product_sentiment sections that complement raw review data.

Company News Monitoring

Real-time news feed for any company — synchronous, source-cited. Use alongside review data to combine sentiment signals with current event context.

Company Research

Full async intelligence report for a single company with product insights, transaction highlights, and executive summary — PDF/DOCX/PPT export.

Peer Comparison

Side-by-side competitive benchmarking including product feature matrices and business model analysis — use after review data to add structured competitive context.

Supporting APIs

Company Search — used to resolve company names to permalinks before querying either review endpoint.