G2 Scraper API Actor

This Apify actor serves as a wrapper around the G2 Scraper API, providing access to various data points like product details, vendor information, reviews, and user data.

Input Configuration

The actor requires a JSON input object specifying the desired endpoint and the necessary parameters for that endpoint. The endpoint field determines which API endpoint to call.

Common Parameters

• endpoint (string, required): The specific API endpoint to target. See the list below for valid values.

Endpoint-Specific Parameters

Below are the valid endpoint values and the additional parameters they require:

1. autocomplete

   • Description: Retrieves autocomplete suggestions based on a search query.
   • Requires:
     • query (string): The search term for autocompletion.
   • Returns: A list of autocomplete suggestion strings.

2. product_info

   • Description: Fetches detailed information about a specific product.
   • Requires:
     • slug (string): The unique identifier (slug) of the product.
   • Returns: An object containing detailed product information.

3. product_competitors

   • Description: Retrieves a list of competitors for a given product.
   • Requires:
     • slug (string): The unique identifier (slug) of the product.
   • Returns: A list of objects, each representing a competitor product.

4. product_reviews

   • Description: Gets reviews for a specific product, with options for pagination and filtering.
   • Requires:
     • id (string | number): The unique ID of the product.
   • Optional:
     • page (number): The page number for paginated results (defaults to 1).
     • starRating (number): Filters reviews by a specific star rating (e.g., 5).
     • sortOrder (string): Specifies the sorting order for reviews (e.g., 'newest', 'highest_rated').
   • Returns: A list of review objects for the specified product.

5. vendor_info

   • Description: Fetches detailed information about a specific vendor.
   • Requires:
     • slug (string): The unique identifier (slug) of the vendor.
   • Returns: An object containing detailed vendor information.

6. vendor_products

   • Description: Retrieves a list of products offered by a specific vendor, with pagination.
   • Requires:
     • slug (string): The unique identifier (slug) of the vendor.
   • Optional:
     • page (number): The page number for paginated results (defaults to 1).
   • Returns: A list of product objects associated with the vendor.

7. user_info

   • Description: Gets information about a specific user.
   • Requires:
     • id (string | number): The unique ID of the user.
   • Returns: An object containing user profile information.

8. user_products

   • Description: Retrieves a list of products associated with a specific user.
   • Requires:
     • id (string | number): The unique ID of the user.
   • Returns: A list of product objects associated with the user.

9. user_reviews

   • Description: Gets reviews written by a specific user, with pagination.
   • Requires:
     • id (string | number): The unique ID of the user.
   • Optional:
     • page (number): The page number for paginated results (defaults to 1).
   • Returns: A list of review objects written by the specified user.

Output

The actor pushes the results of the API call to the Apify dataset.

• For endpoints returning a single item (like product_info, vendor_info, user_info), the dataset will contain one record with the details of that item.
• For endpoints returning lists (like product_competitors, product_reviews, vendor_products), each item in the list will be saved as a separate record in the dataset.
• If the API call is successful but there is no specific data to return (e.g., an empty list of reviews), a simple status message indicating success might be pushed instead.

If the actor encounters an error (either due to invalid input or an issue calling the API), the run will fail, and the dataset will be empty. Check the run log for error details.