REST API v1
All endpoints are read-only GET and return UTF-8 JSON. Base URL https://cyberpunkhub.com/api/v1/
Query parameters are optional. Multiple parameters are combined. Text fields support partial matching; numeric and enum fields require exact values. Invalid parameters return 400.
/latest
Returns up to 25 of the most recently added objects from each section. A section key tells you the origin.
No query parameters are supported for this endpoint.
[
{
"name": "RoboCop",
"slug": "robocop-1987",
"year": 1987,
"rating": "7.3",
"category": "films",
"genres": ["action", "science_fiction", "thriller"],
"collections": [],
"runtime": 102,
"cast": "Peter Weller, Nancy Allen, Dan O'Herlihy, Ronny Cox, Kurtwood Smith",
"country": "United States",
"studio": "Orion Pictures",
"director": "Paul Verhoeven",
"description": "In a dystopic and crime-ridden Detroit, a terminally wounded cop...",
"synopsis": null,
"quote": null,
"imdb_id": "tt0093870",
"reference_url": null,
"media_url": null,
"trailer_url": null,
"created_at": 1751384517,
"updated_at": 1751384524,
"poster_url": "/content/media/11/11fcdb977d6b.jpg",
"poster_thumbnail_url": "/content/media/11/11fcdb977d6b_thumb.jpg",
"url": "/watch/robocop-1987"
}, ...
]
/watch
Query parameters
name(text, 2–200)year(number, 1870–2100)rating(number, 1–10, treated as a minimum)category(enum: films, series, documentaries, short_films, animation_anime)genre(enum, see values below)imdb_id(pattern:tt########)cast(text, 2–255)director(text, 2–100)studio(text, 2–100)country(text, 2–100)
Examples
/watch?name=robocop /watch?year=1987&rating=7 /watch?category=films&director=verhoeven /watch?genre=science_fiction /watch?imdb_id=tt0093870
[
{
"name": "RoboCop",
"slug": "robocop-1987",
"year": 1987,
"rating": "7.3",
"category": "films",
"genres": ["action", "science_fiction", "thriller"],
"collections": ["recommended","classic"],
"runtime": 102,
"cast": "Peter Weller, Nancy Allen, Dan O'Herlihy, Ronny Cox, Kurtwood Smith",
"country": "United States",
"studio": "Orion Pictures",
"director": "Paul Verhoeven",
"description": "In a dystopic and crime-ridden Detroit, a terminally wounded cop...",
"synopsis": "In a violent, near-apocalyptic Detroit, evil corporation Omni Consumer Products...",
"quote": "Dead or alive, you're coming with me!",
"imdb_id": "tt0093870",
"reference_url": null,
"media_url": null,
"trailer_url": "https://www.youtube.com/watch?v=IqvRDhW-XVA",
"created_at": 1739567109,
"updated_at": 1740945687,
"poster_url": "/content/media/e6/e6af68f8877c.jpg",
"poster_thumbnail_url": "/content/media/e6/e6af68f8877c_thumb.jpg",
"url": "/watch/robocop-1987"
}, ...
]
Section-specific attributes
categoryruntimegenrescastdirectorstudiocountryimdb_idmedia_urltrailer_url
category values
- films
- series
- documentaries
- short_films
- animation_anime
genre values
- action
- adventure
- biography
- comedy
- crime
- drama
- family
- fantasy
- film_noir
- game_show
- history
- horror
- music
- musical
- mystery
- news
- reality_tv
- romance
- science_fiction
- sport
- talk_show
- thriller
- war
- western
/play
Query parameters
name(text, 2–200)year(number, 1870–2100)rating(number, 1–10, treated as a minimum)genre(enum, see values below)platform(enum, see values below)igdb_slug(text, 2–200)steam_id(number, ≥1)developer(text, 2–100)publisher(text, 2–100)
Examples
/play?genre=role_playing&platform=windows /play?name=cyberpunk&rating=8 /play?igdb_slug=cyberpunk-2077 /play?steam_id=1091500
[
{
"name": "Cyberpunk 2077",
"slug": "cyberpunk-2077",
"year": 2020,
"rating": "8.2",
"genres": ["role_playing", "shooter", "adventure"],
"collections": ["recommended"],
"platforms": ["windows","playstation_5","xbox_series","nintendo_switch"],
"developer": null,
"publisher": "CD Projekt RED",
"description": "Cyberpunk 2077 is an open-world, action-adventure story set in Night City...",
"synopsis": "In 2077, following an economic collapse sometime during the early 21st century...",
"quote": "Wake up, Samurai. We have a city to burn.",
"igdb_slug": "cyberpunk-2077",
"steam_id": "1091500",
"reference_url": "https://en.wikipedia.org/wiki/Cyberpunk_2077",
"trailer_url": "https://www.youtube.com/watch?v=qIcTM8WXFjk",
"created_at": 1739567117,
"updated_at": 1741361300,
"poster_url": "/content/games/9b/9b8567149dbe.jpg",
"poster_thumbnail_url": "/content/games/9b/9b8567149dbe_thumb.jpg",
"url": "/play/cyberpunk-2077"
}, ...
]
Section-specific attributes
platformsgenresdeveloperpublishersteam_idigdb_slugtrailer_url
platform values
- windows
- mac
- linux
- dos
- web_browser
- playstation
- playstation_2
- playstation_3
- playstation_4
- playstation_5
- psp
- playstation_vita
- playstation_vr
- playstation_vr_2
- xbox
- xbox_360
- xbox_one
- xbox_series
- nintendo_switch
- nintendo_switch_2
- nes
- snes
- nintendo_64
- gamecube
- wii
- wii_u
- nintendo_ds
- nintendo_dsi
- nintendo_3ds
- new_nintendo_3ds
- game_boy
- game_boy_color
- game_boy_advance
- famicom
- famicom_disk_system
- super_famicom
- dreamcast
- sega_master_system
- sega_genesis
- sega_cd
- sega_32x
- sega_saturn
- sega_game_gear
- sg_1000
- android
- ios
- n_gage
- blackberry
- windows_phone
- windows_mobile
- palm_os
- tapwave_zodiac
- amazon_fire_tv
- zeebo
- legacy_mobile
- steamvr
- oculus_vr
- oculus_rift
- oculus_quest
- oculus_go
- meta_quest_2
- meta_quest_3
- windows_mixed_reality
- daydream
- gear_vr
- visionos
- arcade
- neo_geo_mvs
- neo_geo_aes
- neo_geo_cd
- hyper_neo_geo_64
- amiga
- amiga_cd32
- amstrad_cpc
- amstrad_pcw
- apple_ii
- apple_iigs
- atari_2600
- atari_5200
- atari_7800
- atari_8_bit
- atari_st
- atari_lynx
- atari_jaguar
- atari_jaguar_cd
- bbc_micro
- c64
- commodore_16
- commodore_plus_4
- commodore_vic_20
- acorn_archimedes
- acorn_electron
- dragon_32_64
- fm_7
- fm_towns
- msx
- msx2
- pc_8800
- pc_9800
- sharp_x1
- sharp_x68000
- sinclair_ql
- sinclair_zx81
- zx_spectrum
- tatung_einstein
- thomson_mo5
- ti_99
- trs_80
- trs_80_color_computer
- pc_engine
- pc_engine_cd
- pc_engine_supergrafx
- pc_fx
- 3do
- colecovision
- intellivision
- intellivision_amico
- odyssey_2
- ouya
- philips_cd_i
- vectrex
- virtual_boy
- wonderswan
- wonderswan_color
- neo_geo_pocket
- neo_geo_pocket_color
- game_com
- gizmondo
- evercade
- playdate
- tabletop
- other
genre values
- point_and_click
- fighting
- shooter
- music
- platform
- puzzle
- racing
- real_time_strategy
- role_playing
- simulator
- sport
- strategy
- turn_based_strategy
- tactical
- hack_and_slash
- quiz_trivia
- pinball
- adventure
- indie
- arcade
- card_and_board_game
- moba
- visual_novel
- action
- fantasy
- science_fiction
- horror
- thriller
- survival
- historical
- stealth
- comedy
- business
- drama
- non_fiction
- sandbox
- educational
- kids
- open_world
- warfare
- party
- four_x
- erotic
- mystery
- romance
/read
Query parameters
name(text, 2–200)year(number, 1870–2100)rating(number, 1–10, treated as a minimum)category(enum: books, comics, publications, stories, audiobooks)author(text, 2–100)isbn(ISBN-10/13 pattern)
Examples
/read?author=william%20gibson /read?category=books&rating=7 /read?isbn=9780441569595
[
{
"name": "Neuromancer",
"slug": "neuromancer",
"year": 1984,
"rating": "7.8",
"category": "books",
"collections": ["recommended","classic"],
"author": "William Gibson",
"description": "Case was the sharpest data thief in the Matrix...",
"synopsis": null,
"quote": "The sky above the port was the color of television, tuned to a dead station.",
"isbn": null,
"reference_url": "https://www.goodreads.com/book/show/22328.Neuromancer",
"created_at": 1739567124,
"updated_at": 1740944319,
"poster_url": "/content/literature/41/4102355d0783.jpg",
"poster_thumbnail_url": "/content/literature/41/4102355d0783_thumb.jpg",
"url": "/read/neuromancer"
}, ...
]
Section-specific attributes
categoryauthorisbn
category values
- books
- comics
- publications
- stories
- audiobooks
Universal attributes
nameslugyearratingdescriptioncreated_atupdated_atposter_urlposter_thumbnail_urlurl