TapTap Scraper — Games, Rankings & Reviews

Discover games on TapTap China and export structured game profiles, rankings, rating statistics and player reviews to JSON or CSV.

Use it to research competitors, find new games, compare player feedback, build game catalogs and connect TapTap records with your existing app database.

Pricing

$2 per 1,000 exported results ($0.002 each), plus $0.00005 per run.

A result is one game in Search, Rankings or Game details mode, or one review in Reviews mode. Only rows delivered to the Dataset count. Game summaries included with reviews, game discovery used as an input, and JSON/CSV copies carry no additional charge. There is no separate platform usage fee.

For example, 100 exported reviews cost $0.20005, including startup. A run with no result rows incurs only the startup fee. Set a maximum spending budget in Apify to control each run's cost; collection stops when the remaining budget cannot cover another result.

Choose your workflow

Mode	Output
search	Keyword search results with game identifiers, tags, developers and rating metrics.
charts	Ranked game cards with chart name, platform, position and game metrics.
games	Enriched game profiles, company information and rating statistics.
reviews	Player reviews with feedback dimensions, plus a separate game summary table.

For games and reviews, select games by ID/URL, keyword search or chart. Games are deduplicated by TapTap ID; chart results retain the first occurrence of each game.

Search for games

{
  "mode": "search",
  "searchQuery": "策略",
  "maxGames": 20
}

Export a ranking

{
  "mode": "charts",
  "chart": "reserve",
  "chartPlatform": "android",
  "maxGames": 20
}

Choose from 24 charts: popular, pre-registration, most played, new releases, best sellers, new versions, exclusive, action, strategy, idle, single-player, casual, sandbox survival, simulation, puzzle, shooter, multiplayer, anime, rhythm, story, wuxia, female-oriented, independent and roguelike. The ranking platform selector offers Android and iOS.

Collect reviews from games on a chart

{
  "mode": "reviews",
  "gameSource": "chart",
  "chart": "strategy",
  "maxGames": 3,
  "sort": "new",
  "maxReviewsPerGame": 25,
  "maxPagesPerGame": 3
}

Enrich games found by keyword

{
  "mode": "games",
  "gameSource": "search",
  "searchQuery": "原神",
  "maxGames": 3
}

For known games, use "gameSource": "ids" (the default) and "games": ["168332", "https://www.taptap.cn/app/224347"].

Input options

Input	Description	Default
mode	search, charts, games or reviews.	reviews
gameSource	Game selection for games and reviews: ids, search or chart.	ids
games	TapTap China game IDs or URLs.	—
searchQuery	Game name or search keyword.	—
chart	Chart identifier, e.g. hot, reserve, new, strategy.	hot
chartPlatform	Ranking platform: android or ios.	android
maxGames	Number of unique games to select, 1–100.	10
maxDiscoveryPages	Search/chart pages to scan; 10 requested entries per page.	10
sort	Review order: new for latest activity, hot for popular.	new
maxReviewsPerGame	Matching reviews to export per game, 1–1,000.	100
maxPagesPerGame	Review pages to scan per game; 10 requested reviews per page.	20
since	Inclusive review activity timestamp, e.g. 2026-10-01T00:00:00Z.	—
ratings	Review stars to select, e.g. [1, 2].	All
keywords	Match any listed word in review text, case-insensitively.	All

Review filters combine using AND and apply before the result limit. activityAt is the latest creation, publication or edit timestamp. Three seconds are paced between source requests; configure the run timeout to match your selected batch size.

Data fields

Game profiles

• Identity: gameId, gameTitle, gameUrl, Android packageName, appStoreId, appStoreUrl, supportedPlatforms.
• Companies: developers with IDs, roles, profile URLs and websites; supplier, companyRegistrationNumber, officialWebsite.
• Product information: tags, description, developer note, supported languages, in-app purchase label, age rating, system requirements, version, version notes and dates.
• Store data: followers, pre-registrations, price, icons, screenshot URLs, awards and editor recommendation.
• Discovery: searchQuery, chart, chartLabel, chartPlatform, rank, discoveryPosition. New-version charts also include chartEvent.

games mode enriches game cards with detailed product information and review categories. Each record includes fetchedAt in UTC.

Rating statistics

Field	Meaning
statisticsRating	Aggregate score from the rating statistics response, on a 10-point scale.
recentRating, versionRating	TapTap's recent and current-version scores.
recentReviewCount, versionReviewCount	Corresponding review counts.
star1Count … star5Count	Number of votes at each star level.
starRatedCount	Sum of the five star counts.
lowStarShare	Fraction of rated votes with 1–2 stars, from 0 to 1.
reviewCategories	Source category names, mappings and counts, such as long-form reviews.

reportedReviewCount comes from the game card; statisticsReviewCount comes from the statistics response. sourceHitsTotal retains TapTap's hits_total counter.

Player reviews

Each review includes game/review IDs and URLs, stars (1–5), plain text, author display name, creation/publication/edit/activity timestamps, supports, reply count and play-stage label.

dimensions records the player's structured feedback, for example:

[
  {"key": "gameplay", "label": "可玩性", "recommendation": "up"},
  {"key": "operation", "label": "运营服务", "recommendation": "down"}
]

Use (gameId, reviewId) as the review key and gameId to join reviews to the game summary table.

Export files

Data	Local CLI	Apify
Selected mode's records	results.json, results.csv	Default Dataset, RESULTS.csv
Games and rating statistics	games.json, games.csv	GAMES.json, GAMES.csv
Run statistics	summary.json	RUN_SUMMARY
Source information	SOURCE_NOTICE.txt	SOURCE_NOTICE.txt

Review mode keeps review records and game summaries in separate tables. The run summary provides request counts, pagination counters, selection limits and any source errors. CSV files use UTF-8 with BOM; nested objects and arrays are JSON-encoded within cells.

Run locally

Requires Python 3.11+ and uv.

cd actors/taptap
uv sync --frozen
uv run --frozen taptap-export --input examples/charts.json --output-dir outputs/charts

Additional inputs are available in examples/: search, game details, reviews, filtered reviews and discovery-to-export workflows. Use python -m taptap_actor for the Apify SDK entry point.

Source: TapTap China. Records retain source links and public author display names; HTML is converted to plain text and timestamps to UTC.