Poki APIpoki.com ↗
Access Poki.com's full game catalog via API. Retrieve game metadata, genres, developer info, platform compatibility, and category listings for thousands of free online games.
What is the Poki API?
The Poki.com API exposes 4 endpoints covering the complete catalog of free online games hosted on Poki, returning fields like title, developer, genres, platform compatibility, and HTML-formatted descriptions. Starting with list_games gives you every game slug in the catalog, while get_game_details returns per-game metadata including device compatibility across desktop, tablet, and smartphone.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/9df606a3-1657-4caa-9af2-36bd000f24cb/list_games' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace poki-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Poki Games API — discover categories, browse games, get details."""
from parse_apis.poki_games_api import Poki, GameNotFound
client = Poki()
# List the full game catalog and check its size.
catalog = client.catalogs.list()
print(f"Total games in catalog: {catalog.total_games}")
print(f"First few slugs: {catalog.game_slugs[:3]}")
# Browse available categories.
cat_list = client.categorylists.list()
print(f"Total categories: {cat_list.total_categories}")
print(f"Sample categories: {cat_list.categories[:5]}")
# Explore games in a category (bounded iteration).
action = client.category("action")
for game in action.games(limit=3):
print(f" {game.title} by {game.developer} (mobile: {game.mobile})")
# Drill into a single game's full details via the summary.
first_game = action.games(limit=1).first()
if first_game:
detail = first_game.details()
print(f"Detail: {detail.title}, score={detail.popularity_metrics.score}")
print(f" Genres: {[g.title for g in detail.genres]}")
print(f" Desktop: {detail.compatibility.desktop}")
# Fetch a game directly by slug with typed error handling.
try:
game = client.games.get(slug="subway-surfers")
print(f"Got: {game.title} by {game.developer}, votes={game.popularity_metrics.up_votes}")
except GameNotFound as exc:
print(f"Game not found: {exc.slug}")
print("Exercised: catalogs.list / categorylists.list / category.games / game_summary.details / games.get")
List all game slugs available on Poki.com by parsing the sitemap. Returns the complete catalog of game identifiers. The full catalog contains ~1500 games; no pagination or filtering is available.
No input parameters required.
{
"type": "object",
"fields": {
"game_slugs": "array of game slug strings usable with get_game_details",
"total_games": "integer total count of games"
},
"sample": {
"data": {
"game_slugs": [
"airplane-manager",
"block-for-blood",
"box-monster-dress-up",
"subway-surfers"
],
"total_games": 1510
},
"status": "success"
}
}About the Poki API
Game Catalog Access
The list_games endpoint returns the full set of game slugs from Poki's catalog along with a total_games count. These slugs serve as the primary identifier throughout the API — pass any slug to get_game_details to retrieve structured metadata for that game. The detail response includes id, slug, title, english_title, developer, description (HTML-formatted), image_url, and video_upload_date as an ISO 8601 string.
Genres and Platform Compatibility
get_game_details returns a genres array where each entry contains id, title, and slug fields — useful for grouping or filtering games on your end. The compatibility object provides three boolean fields — desktop, tablet, and smartphone — letting you filter the catalog by supported platform without additional requests.
Category Browsing
list_categories returns all available category slugs and a total_categories count. Pass any category slug to get_category_games along with an optional limit integer to retrieve a list of games in that category. Each entry in the games array includes id, slug, title, developer, and a mobile field. The category display name and total_games count are also returned at the top level of the response.
Data Shape Notes
Game descriptions come back as HTML strings, so you may need to strip tags depending on your rendering context. The image_url field can be null for some entries. Slugs are stable identifiers across endpoints — a slug from list_games or get_category_games will resolve correctly in get_game_details.
The Poki API is a managed, monitored endpoint for poki.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when poki.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official poki.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a game discovery app filtered by platform using the
compatibility.smartphoneorcompatibility.desktopboolean fields - Populate a game database with developer attribution by extracting the
developerfield fromget_game_details - Create a genre-based recommendation interface using the
genresarray returned per game - Index the full Poki catalog for search by iterating
list_gamesslugs and fetching metadata in bulk - Build a category browser that lists games by type using
list_categoriesandget_category_games - Track catalog size over time using the
total_gamescounter fromlist_games - Filter kid-friendly or casual games by cross-referencing genre slugs from
get_game_details
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.