FreeToGame Scraper

Scrape FreeToGame — a curated catalog of free-to-play PC and browser games. Browse the whole catalog, filter by any of 45 genres and by platform, or fetch specific titles by ID, and get the title, short and full descriptions, genre, publisher, developer, release date, thumbnail, screenshots, minimum system requirements, and the game's launch URL. HTTP-only via the public freetogame.com API. No auth, no proxy.

What this actor does

• Three modes: browse, byGenre, byGame
• 45 genre filters: from mmorpg and battle-royale to low-spec and tower-defense, all exposed as a dropdown
• Platform + sort control: PC, browser, or both; sort by popularity, release date, or alphabetically
• Optional deep fetch: fetchDetails adds full descriptions, screenshot galleries, and minimum system requirements
• Empty fields are omitted

Output per game

• gameId — FreeToGame numeric ID
• title
• shortDescription — one-line summary (always present)
• description — full description (only with fetchDetails)
• genre — primary genre label
• platform — e.g. PC (Windows), Web Browser
• publisher, developer
• releaseDate
• status — live / development status (only with fetchDetails)
• thumbnailUrl — cover art
• screenshotUrls — in-game screenshots (only with fetchDetails)
• minimumSystemRequirements — OS, processor, memory, graphics, storage (only with fetchDetails)
• gameUrl — publisher's play/download link
• sourceUrl — FreeToGame profile page
• recordType: "game", scrapedAt

Input

Field	Type	Default	Description
mode	string	browse	browse / byGenre / byGame
genre	string	–	Genre slug, e.g. mmorpg, shooter, battle-royale (required for byGenre, optional filter for browse)
platform	string	all	all / pc / browser
sortBy	string	popularity	popularity / release-date / alphabetical / relevance
gameId	int	–	Single game ID to fetch (mode=byGame)
gameIds	array	–	Multiple game IDs to fetch (mode=byGame)
fetchDetails	bool	false	Fetch full description, screenshots, and system requirements per game
maxItems	int	50	Hard cap (1–1000)

Example: most popular free games

{
  "mode": "browse",
  "sortBy": "popularity",
  "maxItems": 100
}

Example: browser-based MMORPGs

{
  "mode": "byGenre",
  "genre": "mmorpg",
  "platform": "browser",
  "sortBy": "release-date"
}

Example: low-spec shooters with system requirements

{
  "mode": "byGenre",
  "genre": "low-spec",
  "platform": "pc",
  "fetchDetails": true,
  "maxItems": 30
}

Example: specific titles by ID

{
  "mode": "byGame",
  "gameIds": [540, 452, 475],
  "fetchDetails": true
}

Use cases

• Gaming media & blogs — auto-generate "best free games" roundups by genre and platform
• Game discovery apps — power a browsable free-to-play catalog with art and descriptions
• Hardware matching — filter titles by minimum system requirements for low-spec machines
• Market research — track how many free-to-play titles launch per genre over time
• Publisher monitoring — watch a developer's or publisher's free-to-play portfolio
• Chatbots & recommenders — ground game recommendations in a structured catalog

FAQ

What is FreeToGame? A curated directory of free-to-play PC and browser games with an open JSON API. See freetogame.com.

Is this affiliated with FreeToGame? No. This is a third-party actor using their public API.

Do I need an API key? No. The endpoints are open and unauthenticated.

Is every game genuinely free? Yes — the catalog only includes free-to-play titles. Many still sell optional in-game purchases, which the catalog doesn't track.

What does fetchDetails change? Without it, one request returns the whole list quickly with cover art and summaries. With it, each game costs an extra request but you also get the full description, screenshot gallery, live status, and minimum system requirements.

Why does sortBy: "relevance" behave like no sorting? Relevance is only meaningful for keyword search upstream; for catalog browsing the API returns its default ordering.

What's the difference between gameUrl and sourceUrl? gameUrl is the publisher's own play or download page; sourceUrl is the FreeToGame profile with the description and screenshots.

Can a game have more than one genre? The catalog assigns one primary genre per game, which is what genre returns. Filtering by a genre slug uses FreeToGame's own broader category tagging, so results can include games whose primary genre label differs.

How fresh is the data? Live — each run queries the API directly, so newly added titles appear as soon as FreeToGame lists them.