Grouvee Scraper

Scrape video game data from Grouvee.com -- a video game tracking and collection site. Search for games by title and extract ratings, platforms, genres, developers, publishers, and structured data.

Features

• Search by title -- Search for any game by name (e.g. "zelda", "final fantasy")
• Basic listing data -- Title, rating, platforms, release date, cover image, and description snippet
• Full detail scraping -- Enable scrapeDetails to visit each game page for genres, developers, publishers, aggregateRating (schema.org JSON-LD), and full description
• Multi-query support -- Search for multiple games in a single run
• Pagination -- Automatically follows search result pages

Input

Field	Type	Default	Description
searchQueries	string[]	["zelda"]	Game titles to search for
maxListings	integer	100	Maximum games to scrape (1-1000)
scrapeDetails	boolean	false	Visit detail pages for full data
proxyConfiguration	object	-	Optional proxy settings

Example Input

{
    "searchQueries": ["zelda", "mario", "metroid"],
    "maxListings": 50,
    "scrapeDetails": true
}

Output

Each game produces a JSON object with the following fields:

Field	Type	Description
title	string	Game title
gameId	integer	Grouvee internal game ID
rating	number	Average star rating (1-5)
platforms	string[]	Available platforms
releaseDate	string	Release date
coverImage	string	Cover art image URL
description	string	Game description
genres	string[]	Game genres (detail mode)
developers	string[]	Developer studios (detail mode)
publishers	string[]	Publisher companies (detail mode)
aggregateRating	number	Schema.org aggregate rating value (detail mode)
ratingCount	number	Number of ratings (detail mode)
url	string	Grouvee game page URL
searchQuery	string	The search query that found this game
scrapedAt	string	ISO timestamp of when data was scraped

Example Output

{
    "title": "The Legend of Zelda: Breath of the Wild",
    "gameId": 119287,
    "rating": 4.6,
    "platforms": ["Nintendo Switch", "Wii U"],
    "releaseDate": "2017-03-03",
    "coverImage": "https://img-grouvee-com.b-cdn.net/upload/cache/e9/a2/e9a25edc95ea5c502711323f4b516518.jpg",
    "description": "The Legend of Zelda: Breath of the Wild is the first 3D open-world game in the Zelda series...",
    "genres": ["Adventure", "Puzzle"],
    "developers": ["Nintendo EPD Production Group No. 3"],
    "publishers": ["Nintendo"],
    "aggregateRating": 4.61,
    "ratingCount": 11184,
    "url": "https://www.grouvee.com/games/119287-the-legend-of-zelda-breath-of-the-wild/",
    "searchQuery": "zelda",
    "scrapedAt": "2026-04-25T01:00:00.000Z"
}

How It Works

1. For each search query, the scraper hits https://www.grouvee.com/search/?q={query}
2. Parses game cards from the search results (title, rating, platforms, release date, cover image)
3. If scrapeDetails is enabled, visits each game's detail page to extract:
   • Schema.org JSON-LD VideoGame structured data (aggregateRating, genres, developers, publishers)
   • Full description text
4. Automatically paginates through search results until maxListings is reached

Notes

• Grouvee is a Django SSR site with Hotwire Turbo. Game data is rendered server-side in HTML.
• Detail pages include aggregateRating schema.org JSON-LD structured data.
• Without scrapeDetails, genres/developers/publishers/aggregateRating will be null.
• The scraper uses CheerioCrawler (no browser needed) for fast, efficient scraping.
• Rate limited to 20 requests/minute to be respectful to the site.

Cost

This Actor uses pay-per-event pricing. Each scraped game costs approximately $0.005.